GimpStringComboBox: GIMP Widgets Library Reference Manual

GimpStringComboBox

GimpStringComboBox — A GtkComboBox subclass to select strings.

Functions

GtkWidget *	gimp_string_combo_box_new ()
gboolean	gimp_string_combo_box_set_active ()
gchar *	gimp_string_combo_box_get_active ()

Properties

PangoEllipsizeMode	ellipsize	Read / Write
int	id-column	Read / Write / Construct Only
int	label-column	Read / Write / Construct Only

Types and Values

GimpStringComboBox

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBin
                        ╰── GtkComboBox
                            ╰── GimpStringComboBox

Implemented Interfaces

GimpStringComboBox implements AtkImplementorIface, GtkBuildable, GtkCellLayout and GtkCellEditable.

Description

A GtkComboBox subclass to select strings.

Functions

gimp_string_combo_box_new ()

GtkWidget *
gimp_string_combo_box_new (GtkTreeModel *model,
                           gint id_column,
                           gint label_column);

Parameters

model	a GtkTreeModel
id_column	the model column of the ID
label_column	the modl column of the label

Returns

a new GimpStringComboBox.

Since: 2.4

gimp_string_combo_box_set_active ()

gboolean
gimp_string_combo_box_set_active (GimpStringComboBox *combo_box,
                                  const gchar *id);

Looks up the item that belongs to the given id and makes it the selected item in the combo_box .

Parameters

combo_box	a GimpStringComboBox
id	the ID of the item to select

Returns

TRUE on success or FALSE if there was no item for this value.

Since: 2.4

gimp_string_combo_box_get_active ()

gchar *
gimp_string_combo_box_get_active (GimpStringComboBox *combo_box);

Retrieves the value of the selected (active) item in the combo_box .

Parameters

combo_box

a GimpStringComboBox

Returns

newly allocated ID string or NULL if nothing was selected

Since: 2.4

Types and Values