rb-glade-helpers

rb-glade-helpers — helper functions for dealing with glade XML files

Synopsis

GladeXML*           rb_glade_xml_new                    (const char *file,
                                                         const char *root,
                                                         gpointer user_data);
void                rb_glade_boldify_label              (GladeXML *xml,
                                                         const char *name);
gboolean            rb_combo_box_hyphen_separator_func  (GtkTreeModel *model,
                                                         GtkTreeIter *iter,
                                                         gpointer data);

Description

Some simple helper functions to make it a bit easier to deal with widgets built from glade XML files.

Details

rb_glade_xml_new ()

GladeXML*           rb_glade_xml_new                    (const char *file,
                                                         const char *root,
                                                         gpointer user_data);

Locates and reads a glade xml file, automatically connecting signal handlers where possible. The caller can specify a path relative to the shared data directory, or its 'glade' or 'art' subdirectories.

file :

filename, either absolute or relative to the data directory

root :

the widget node in the file to start building from (or NULL)

user_data :

user data to pass to autoconnected signal handlers

Returns :

GladeXML object built from the file

rb_glade_boldify_label ()

void                rb_glade_boldify_label              (GladeXML *xml,
                                                         const char *name);

Makes a label built from a glade xml file bold.

xml :

GladeXML instance

name :

name of the label to boldify

rb_combo_box_hyphen_separator_func ()

gboolean            rb_combo_box_hyphen_separator_func  (GtkTreeModel *model,
                                                         GtkTreeIter *iter,
                                                         gpointer data);

A row separator function to use for GtkComboBox widgets. It expects the model to contain a string in its first column, and interprets a string containing a single hyphen character as a separator.

model :

a GtkTreeModel

iter :

a GtkTreeIter

data :

nothing

Returns :

TRUE if the row pointed to by iter is a separator