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