GimpStringComboBox

GimpStringComboBox

Synopsis




            GimpStringComboBox;
GtkWidget*  gimp_string_combo_box_new       (GtkTreeModel *model,
                                             gint id_column,
                                             gint label_column);
gboolean    gimp_string_combo_box_set_active
                                            (GimpStringComboBox *combo_box,
                                             const gchar *id);
gchar*      gimp_string_combo_box_get_active
                                            (GimpStringComboBox *combo_box);

Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkComboBox
                                       +----GimpStringComboBox

Implemented Interfaces

GimpStringComboBox implements AtkImplementorIface, GtkCellEditable and GtkCellLayout.

Properties


  "ellipsize"            PangoEllipsizeMode    : Read / Write
  "id-column"            gint                  : Read / Write / Construct Only
  "label-column"         gint                  : Read / Write / Construct Only

Description

Details

GimpStringComboBox

typedef struct _GimpStringComboBox GimpStringComboBox;


gimp_string_combo_box_new ()

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

model :
id_column :
label_column :
Returns : a new GimpStringComboBox.

Since GIMP 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.

combo_box : a GimpStringComboBox
id :
Returns : TRUE on success or FALSE if there was no item for this value.

Since GIMP 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.

combo_box : a GimpStringComboBox
Returns : newly allocated ID string or NULL if nothing was selected

Since GIMP 2.4

Property Details

The "ellipsize" property

  "ellipsize"            PangoEllipsizeMode    : Read / Write

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.

Default value: PANGO_ELLIPSIZE_NONE

Since GIMP 2.4


The "id-column" property

  "id-column"            gint                  : Read / Write / Construct Only

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

Allowed values: >= 0

Default value: 0

Since GIMP 2.4


The "label-column" property

  "label-column"         gint                  : Read / Write / Construct Only

Allowed values: >= 0

Default value: 0