Gnome User Interface Library Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
#include <gnome.h> int gnome_init (const char *app_id, const char *app_version, int argc, char **argv); int gnome_init_with_popt_table (const char *app_id, const char *app_version, int argc, char **argv, const struct poptOption *options, int flags, poptContext *return_ctx); struct GnomeGuru; GtkWidget* gnome_guru_new (const gchar *name, GtkWidget *graphic, GnomeDialog *dialog); void gnome_guru_construct (GnomeGuru *guru, const gchar *name, GtkWidget *graphic, GnomeDialog *dialog); void gnome_guru_append_page (GnomeGuru *guru, const gchar *name, GtkWidget *widget); void gnome_guru_next_set_sensitive (GnomeGuru *guru, gboolean sensitivity); void gnome_guru_back_set_sensitive (GnomeGuru *guru, gboolean sensitivity); GtkWidget* gnome_guru_current_page (GnomeGuru *guru); #define GNOME_GURU (obj) #define GNOME_IS_GURU (obj) guint gnome_guru_get_type (void); #define GNOME_GURU_CLASS (klass) |
These routines initialize the GNOME libraries in an application. As part of the initialization these routines do command line argument parsing.
The gnome_init() function family initializes the Gtk+ toolkit, the Imlib graphics library, initializes session management for the application and loads the user preferences. During this process it parses the command line arguments and dispatches the arguments to the proper argument parsers.
To provide your own arguments, you need to provide a poptOption array (see the man page for popt(3) for more information) that contains the list of arguments that your application recognizes.
int gnome_init (const char *app_id, const char *app_version, int argc, char **argv); |
Initializes the application. This sets up all of the GNOME internals and prepares them (imlib, gdk, session-management, triggers, sound, user preferences)
app_id : | Application id. |
app_version : | Application version. |
argc : | argc (for example, as received by main) |
argv : | argv (for example, as received by main) |
Returns : |
int gnome_init_with_popt_table (const char *app_id, const char *app_version, int argc, char **argv, const struct poptOption *options, int flags, poptContext *return_ctx); |
Initializes the application. This sets up all of the GNOME internals and prepares them (imlib, gdk, session-management, triggers, sound, user preferences)
Unlike gnome_init, with gnome_init_with_popt_table you can provide a table of popt options (popt is the command line argument parsing library).
app_id : | Application id. |
app_version : | Application version. |
argc : | pointer to argc (for example, as received by main) |
argv : | pointer to argc (for example, as received by main) |
options : | poptOption table with options to parse |
flags : | popt flags. |
return_ctx : | if non-NULL, the popt context is returned here. |
Returns : |
GtkWidget* gnome_guru_new (const gchar *name, GtkWidget *graphic, GnomeDialog *dialog); |
void gnome_guru_construct (GnomeGuru *guru, const gchar *name, GtkWidget *graphic, GnomeDialog *dialog); |
void gnome_guru_append_page (GnomeGuru *guru, const gchar *name, GtkWidget *widget); |
void gnome_guru_next_set_sensitive (GnomeGuru *guru, gboolean sensitivity); |
void gnome_guru_back_set_sensitive (GnomeGuru *guru, gboolean sensitivity); |