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
gint id-column Read / Write / Construct Only
gint 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

GimpStringComboBox

typedef struct _GimpStringComboBox GimpStringComboBox;

Property Details

The “ellipsize” property

  “ellipsize”                PangoEllipsizeMode

Specifies the preferred place to ellipsize text in the combo-box, if the cell renderer does not have enough room to display the entire string.

Owner: GimpStringComboBox

Flags: Read / Write

Default value: PANGO_ELLIPSIZE_NONE

Since: 2.4

The “id-column” property

  “id-column”                gint

The column in the associated GtkTreeModel that holds strings to be used as labels in the combo-box.

Owner: GimpStringComboBox

Flags: Read / Write / Construct Only

Allowed values: >= 0

Default value: 0

Since: 2.4

The “label-column” property

  “label-column”             gint

The model column that holds the label.

Owner: GimpStringComboBox

Flags: Read / Write / Construct Only

Allowed values: >= 0

Default value: 0

Generated by GTK-Doc V1.32