GimpIntComboBox

typedef struct _GimpIntComboBox GimpIntComboBox;

GimpIntSensitivityFunc ()

gboolean            (*GimpIntSensitivityFunc)           (gint value,
                                                         gpointer data);

gimp_int_combo_box_new ()

GtkWidget *         gimp_int_combo_box_new              (const gchar *first_label,
                                                         gint first_value,
                                                         ...);

Creates a GtkComboBox that has integer values associated with each item. The items to fill the combo box with are specified as a NULL terminated list of label/value pairs.

If you need to construct an empty GimpIntComboBox, it's best to use g_object_new (GIMP_TYPE_INT_COMBO_BOX, NULL).

Since GIMP 2.2

gimp_int_combo_box_new_valist ()

GtkWidget *         gimp_int_combo_box_new_valist       (const gchar *first_label,
                                                         gint first_value,
                                                         va_list values);

A variant of gimp_int_combo_box_new() that takes a va_list of label/value pairs. Probably only useful for language bindings.

Since GIMP 2.2

gimp_int_combo_box_new_array ()

GtkWidget *         gimp_int_combo_box_new_array        (gint n_values,
                                                         const gchar *labels[]);

A variant of gimp_int_combo_box_new() that takes an array of labels. The array indices are used as values.

Since GIMP 2.2

gimp_int_combo_box_prepend ()

void                gimp_int_combo_box_prepend          (GimpIntComboBox *combo_box,
                                                         ...);

This function provides a convenient way to prepend items to a GimpIntComboBox. It prepends a row to the combo_box's list store and calls gtk_list_store_set() for you.

The column number must be taken from the enum GimpIntStoreColumns.

Since GIMP 2.2

gimp_int_combo_box_append ()

void                gimp_int_combo_box_append           (GimpIntComboBox *combo_box,
                                                         ...);

This function provides a convenient way to append items to a GimpIntComboBox. It appends a row to the combo_box's list store and calls gtk_list_store_set() for you.

The column number must be taken from the enum GimpIntStoreColumns.

Since GIMP 2.2

gimp_int_combo_box_set_active ()

gboolean            gimp_int_combo_box_set_active       (GimpIntComboBox *combo_box,
                                                         gint value);

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

Since GIMP 2.2

gimp_int_combo_box_get_active ()

gboolean            gimp_int_combo_box_get_active       (GimpIntComboBox *combo_box,
                                                         gint *value);

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

Since GIMP 2.2

gimp_int_combo_box_connect ()

gulong              gimp_int_combo_box_connect          (GimpIntComboBox *combo_box,
                                                         gint value,
                                                         GCallback callback,
                                                         gpointer data);

A convenience function that sets the inital value of a GimpIntComboBox and connects callback to the "changed" signal.

This function also calls the callback once after setting the initial value. This is often convenient when working with combo boxes that select a default active item, like for example gimp_drawable_combo_box_new(). If you pass an invalid initial value, the callback will be called with the default item active.

Since GIMP 2.2

gimp_int_combo_box_set_sensitivity ()

void                gimp_int_combo_box_set_sensitivity  (GimpIntComboBox *combo_box,
                                                         GimpIntSensitivityFunc func,
                                                         gpointer data,
                                                         GDestroyNotify destroy);

Sets a function that is used to decide about the sensitivity of rows in the combo_box. Use this if you want to set certain rows insensitive.

Calling gtk_widget_queue_draw() on the combo_box will cause the sensitivity to be updated.

Since GIMP 2.4

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