Gnome User Interface Library Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# gnome-init

## Name

gnome-init -- Initialize GNOME libraries.

## Synopsis

    #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)

## Description

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.

## Details

### gnome_init ()

    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` : | argument count (for example argc as received by main)
`argv` : | argument vector (for example argv as received by main)
Returns : |

### gnome_init_with_popt_table ()

    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` : | argument count (for example argc as received by main)
`argv` : | argument vector (for example argv 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 : |

### struct GnomeGuru

    struct GnomeGuru;

### gnome_guru_new ()

    GtkWidget*  gnome_guru_new                  (const gchar *name,
                                                 GtkWidget *graphic,
                                                 GnomeDialog *dialog);

### gnome_guru_construct ()

    void        gnome_guru_construct            (GnomeGuru *guru,
                                                 const gchar *name,
                                                 GtkWidget *graphic,
                                                 GnomeDialog *dialog);

### gnome_guru_append_page ()

    void        gnome_guru_append_page          (GnomeGuru *guru,
                                                 const gchar *name,
                                                 GtkWidget *widget);

### gnome_guru_next_set_sensitive ()

    void        gnome_guru_next_set_sensitive   (GnomeGuru *guru,
                                                 gboolean sensitivity);

### gnome_guru_back_set_sensitive ()

    void        gnome_guru_back_set_sensitive   (GnomeGuru *guru,
                                                 gboolean sensitivity);

### gnome_guru_current_page ()

    GtkWidget*  gnome_guru_current_page         (GnomeGuru *guru);

### GNOME_GURU()

    #define GNOME_GURU(obj) GTK_CHECK_CAST (obj, gnome_guru_get_type (), GnomeGuru)

### GNOME_IS_GURU()

    #define GNOME_IS_GURU(obj)  GTK_CHECK_TYPE (obj, gnome_guru_get_type ())

### gnome_guru_get_type ()

    guint       gnome_guru_get_type             (void);

### GNOME_GURU_CLASS()

    #define GNOME_GURU_CLASS(klass)  GTK_CHECK_CLASS_CAST (klass, gnome_guru_get_type (), GnomeGuruClass)

## See Also

Manual page popt(3).

<<< Previous Page | Home | Up | Next Page >>>
gnome-icon-text | gnome-mdi-session