## GnomeDbEntryCombo

GnomeDbEntryCombo — A combo box to choose a value from a GdaSet

##

# Synopsis

    struct      GnomeDbEntryCombo;
    struct      GnomeDbEntryComboClass;
    struct      GnomeDbEntryComboPriv;
    GtkWidget*  gnome_db_entry_combo_new        (GdaSet *paramlist,
                                                 GdaSetSource *source);
    gboolean    gnome_db_entry_combo_set_values (GnomeDbEntryCombo *combo,
                                                 GSList *values);
    GSList*     gnome_db_entry_combo_get_values (GnomeDbEntryCombo *combo);
    GSList*     gnome_db_entry_combo_get_all_values
                                                (GnomeDbEntryCombo *combo);
    void        gnome_db_entry_combo_set_values_orig
                                                (GnomeDbEntryCombo *combo,
                                                 GSList *values);
    GSList*     gnome_db_entry_combo_get_values_orig
                                                (GnomeDbEntryCombo *combo);
    void        gnome_db_entry_combo_set_values_default
                                                (GnomeDbEntryCombo *combo,
                                                 GSList *values);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkViewport
                                           +----GnomeDbEntryShell
                                                 +----GnomeDbEntryCombo

## Implemented Interfaces

GnomeDbEntryCombo implements GnomeDbDataEntry, AtkImplementorIface and GtkBuildable.

## Properties

      "set-default-if-invalid" gboolean             : Read / Write

## Description

This widget allows the user to select a row from a GdaDataModel object, and set one or several values from that row. Specifically, it uses a GdaSetNode (within a GdaSet object), and synchonizes the values of the GdaHolder objects in that GdaSetNode.

## Details

### struct GnomeDbEntryCombo

    struct GnomeDbEntryCombo;

### struct GnomeDbEntryComboClass

    struct GnomeDbEntryComboClass {

    	GnomeDbEntryShellClass   parent_class;
    };

### struct GnomeDbEntryComboPriv

    struct GnomeDbEntryComboPriv;

### gnome_db_entry_combo_new ()

    GtkWidget*  gnome_db_entry_combo_new        (GdaSet *paramlist,
                                                 GdaSetSource *source);

Creates a new GnomeDbEntryCombo widget. The widget is a combo box which displays a selectable list of items (the items come from the 'source->data_model' data model)

The widget allows the value setting of one or more GdaHolder objects (one for each 'source->nodes') while proposing potentially "more readable" choices.

`paramlist` : | a GdaSet object
`source` : | a GdaSetSource structure, part of `paramlist`
Returns : | the new widget

### gnome_db_entry_combo_set_values ()

    gboolean    gnome_db_entry_combo_set_values (GnomeDbEntryCombo *combo,
                                                 GSList *values);

Sets the values of `combo` to the specified ones. None of the values provided in the list is modified.

`values` holds a list of GValue values, one for each parameter that is present in the `node` argument of the `gnome_db_entry_combo_new()` function which created `combo`.

An error can occur when there is no corresponding value(s) to be displayed for the provided values.

If `values` is `NULL`, then the entry itself is set to NULL;

`combo` : | a GnomeDbEntryCombo widet
`values` : | a list of GValue values, or `NULL`
Returns : | TRUE if no error occurred.

### gnome_db_entry_combo_get_values ()

    GSList*     gnome_db_entry_combo_get_values (GnomeDbEntryCombo *combo);

Get the values stored within `combo`. The returned values are the ones within `combo`, so they must not be freed afterwards, however the returned list has to be freed afterwards.

`combo` : | a GnomeDbEntryCombo widet
Returns : | a new list of values

### gnome_db_entry_combo_get_all_values ()

    GSList*     gnome_db_entry_combo_get_all_values
                                                (GnomeDbEntryCombo *combo);

Get a list of all the values in `combo`'s data model's selected row. The list must be freed by the caller.

`combo` : | a GnomeDbEntryCombo widet
Returns : | a new list of values

### gnome_db_entry_combo_set_values_orig ()

    void        gnome_db_entry_combo_set_values_orig
                                                (GnomeDbEntryCombo *combo,
                                                 GSList *values);

Sets the original values of `combo` to the specified ones. None of the values provided in the list is modified.

`combo` : | a GnomeDbEntryCombo widet
`values` : | a list of GValue values

### gnome_db_entry_combo_get_values_orig ()

    GSList*     gnome_db_entry_combo_get_values_orig
                                                (GnomeDbEntryCombo *combo);

Get the original values stored within `combo`. The returned values are the ones within `combo`, so they must not be freed afterwards; the list has to be freed afterwards.

`combo` : | a GnomeDbEntryCombo widet
Returns : | a new list of values

### gnome_db_entry_combo_set_values_default ()

    void        gnome_db_entry_combo_set_values_default
                                                (GnomeDbEntryCombo *combo,
                                                 GSList *values);

Sets the default values of `combo` to the specified ones. None of the values provided in the list is modified.

`combo` : | a GnomeDbEntryCombo widet
`values` : | a list of GValue values

## Properties

"`set-default-if-invalid`" (gboolean : Read / Write) |