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