GdauiCombo

GdauiCombo — Combo box to choose from the contents of a GdaDataModel

Stability Level

Stable, unless otherwise indicated

Properties

gboolean as-list Read / Write
GdaDataModel * model Read / Write

Types and Values

struct GdauiCombo

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkComboBox
                        ╰── GdauiCombo
                            ╰── GdauiProviderSelector

Implemented Interfaces

GdauiCombo implements AtkImplementorIface, GtkBuildable, GtkCellLayout, GtkCellEditable and GdauiDataSelector.

Description

Functions

gdaui_combo_new ()

GtkWidget *
gdaui_combo_new (void);

Create a new GdauiCombo widget.

Returns

the newly-created widget.

[transfer full]

Since 4.2


gdaui_combo_new_with_model ()

GtkWidget *
gdaui_combo_new_with_model (GdaDataModel *model,
                            gint n_cols,
                            gint *cols_index);

Create a new GdauiCombo widget with a model. See gdaui_combo_set_model() for more information about the n_cols and cols_index usage.

Parameters

model

a GdaDataModel object.

 

n_cols

number of columns in the model to be shown

 

cols_index

an array of columns to be shown, its size must be n_cols

 

Returns

the newly-created widget.

[transfer full]

Since 4.2


gdaui_combo_set_model ()

void
gdaui_combo_set_model (GdauiCombo *combo,
                       GdaDataModel *model,
                       gint n_cols,
                       gint *cols_index);

gdaui_combo_set_model has been deprecated since version 5.2 and should not be used in newly-written code.

Makes combo display data stored in model (makes the combo widget refresh its list of values and display the values contained in the model). A NULL model will make the combo empty and disassociate the previous model, if any.

if n_cols is 0, then all the columns of model will be displayed in combo .

Parameters

combo

a GdauiCombo widget.

 

model

a GdaDataModel object.

 

n_cols

number of columns in the model to be shown

 

cols_index

an array of columns to be shown, its size must be n_cols .

[array length=n_cols]

Since 4.2


gdaui_combo_add_null ()

void
gdaui_combo_add_null (GdauiCombo *combo,
                      gboolean add_null);

Tells if combo should add a special entry representing an "undefined choice", as a NULL entry. The default is that only the available choices in combo 's model are presented.

Parameters

combo

a GdauiCombo widget

 

add_null

set to TRUE to add a NULL value to the combo box

 

Since 4.2


gdaui_combo_is_null_selected ()

gboolean
gdaui_combo_is_null_selected (GdauiCombo *combo);

Tell if the currently selected entry represents the "undefined choice" entry.

Parameters

combo

a GdauiCombo widget

 

Returns

TRUE if the NULL value is selected

Since 4.2

Types and Values

struct GdauiCombo

struct GdauiCombo;

Property Details

The “as-list” property

  “as-list”                  gboolean

Flags: Read / Write

Default value: FALSE


The “model” property

  “model”                    GdaDataModel *

Flags: Read / Write