EphyGlade

EphyGlade — Load a glade XML definition

Synopsis




GladeXML*   ephy_glade_widget_new           (const char *file,
                                             const char *widget_name,
                                             GtkWidget **root,
                                             gpointer data,
                                             const char *domain);

Description

Epiphany has its own convenience wrapper around glade_xml_new() which will automatically connect all a widget's signals and return the GtkWidget root object.

After retrieving a GladeXML object from ephy_glade_widget_new(), regular GladeXML functions can be called on that object.

Details

ephy_glade_widget_new ()

GladeXML*   ephy_glade_widget_new           (const char *file,
                                             const char *widget_name,
                                             GtkWidget **root,
                                             gpointer data,
                                             const char *domain);

Builds a new GladeXML object from the given file with root widget widget_name. The widget can also be aquired by passing root, a pointer to a GtkWidget pointer.

The signal callbacks underneath the desired root widget in file will all be automatically connected; the callback data will be data.

Libglade automatically caches file; it is not inefficient to call ephy_glade_widget_new() several times on the same XML file.

file : a Glade XML file
widget_name : the name of a widget within file
root : the returned root GtkWidget pointer, or NULL if not wanted
data : callback data to connect to all root's signal callbacks
domain : the translation domain for the XML file (or NULL for default)
Returns : the desired GladeXML object, or NULL on failure