Libglade Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# Libglade Initialisation

## Name

Libglade Initialisation -- Routines used to initialise libglade.

## Synopsis

    #include <glade/glade.h>

    void        glade_init                      (void);
    void        glade_gnome_init                (void);
    void        glade_load_module               (const char *module);

## Description

These routines are used to initialise libglade, and to load addon modules that recognise extra widget sets. The `glade_init` routine must be called before any libglade routines are used, and the `glade_load_module` routine would be used to load extra modules.

## Details

### glade_init ()

    void        glade_init                      (void);

Should be called before creating any GladeXML objects. Currently all it does is register all the widget building routines, so they can be found by widget name. In the future it may do some more initialisation work.

### glade_gnome_init ()

    void        glade_gnome_init                (void);

This function performs initialisation of glade, similar to what glade_init does (in fact it calls glade_init for you). The difference is that it also initialises the GNOME widget building routines.

As well as calling this initialisation function, GNOME programs should also link with the libglade-gnome library, which contains all the GNOME libglade stuff.

### glade_load_module ()

    void        glade_load_module               (const char *module);

This routine loads the shared library `module`, and calls the function glade_init_module. If the file doesn't exist, or it doesn't contain a glade_init_module function, the loading fails. The idea of this function is to allow new widget building routines to be loaded into libglade at runtime.

This would be a lot more useful if special tags in the XML file could trigger the loading of modules.

`module` : | the shared library.

<<< Previous Page | Home | Up | Next Page >>>
Libglade Library Reference | GladeXML