Utilities

Utilities — Create GnomeDbDataEntry and GtkCellRenderer objects easily

Synopsis

void                gnome_db_util_init_plugins          ();
GnomeDbDataEntry *  gnome_db_util_new_data_entry        (GdaDict *dict,
                                                         GType type,
                                                         const gchar *plugin_name);
GtkCellRenderer *   gnome_db_util_new_cell_renderer     (GdaDict *dict,
                                                         GType type,
                                                         const gchar *plugin_name);

Description

Details

gnome_db_util_init_plugins ()

void                gnome_db_util_init_plugins          ();

Forces the library to parse all the plugin files and build the gnome_db_plugins_hash global hash table.

Calling this function prior to gnome_db_util_new_data_entry() or gnome_db_util_new_cell_renderer() is not necessary as it is called automatically.


gnome_db_util_new_data_entry ()

GnomeDbDataEntry *  gnome_db_util_new_data_entry        (GdaDict *dict,
                                                         GType type,
                                                         const gchar *plugin_name);

Creates a new GnomeDbDataEntry widget, taking into account the requested entry name if plugin_name is not NULL (if no entry of that name is found, then the default data entry widget will be created).

plugin_name format is interpreted as two parts: <plugin name>:<plugin options>, and if the plugins has no option, then the ":<plugin options>" part may be omitted.

dict :

a GdaDict object, or NULL

type :

a GType

plugin_name :

the name of an entry plugin, or NULL

Returns :

a new GnomeDbDataEntry widget, _NEVER_ NULL

gnome_db_util_new_cell_renderer ()

GtkCellRenderer *   gnome_db_util_new_cell_renderer     (GdaDict *dict,
                                                         GType type,
                                                         const gchar *plugin_name);

Creates a new GtkCellRenderer object which is suitable to use in a GtkTreeView widget, taking into account the requested entry name if plugin_name is not NULL (if no entry of that name is found, then the default data entry widget will be created).

plugin_name format is interpreted as two parts: <plugin name>:<plugin options>, and if the plugins has no option, then the ":<plugin options>" part may be omitted.

dict :

a GdaDict object, or NULL

type :

a GType

plugin_name :

the name of an entry plugin, or NULL

Returns :

a new GtkCellRenderer object, _NEVER_ NULL