GIMP Library Reference Manual: GimpImageComboBox

## GimpImageComboBox GimpImageComboBox — A widget providing a popup menu of images. |

## Functions

gboolean | (*GimpImageConstraintFunc) ()
GtkWidget * | gimp_image_combo_box_new ()

## Types and Values

| GimpImageComboBox

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GtkObject
                ╰── GtkWidget
                    ╰── GtkContainer
                        ╰── GtkBin
                            ╰── GtkComboBox
                                ╰── GimpIntComboBox
                                    ╰── GimpImageComboBox

## Implemented Interfaces

GimpImageComboBox implements AtkImplementorIface, GtkBuildable, GtkCellLayout and GtkCellEditable.

## Description

A widget providing a popup menu of images.

## Functions

### GimpImageConstraintFunc ()

    gboolean
    (*GimpImageConstraintFunc) (gint32 image_id,
                                gpointer data);

#### Returns

### gimp_image_combo_box_new ()

    GtkWidget *
    gimp_image_combo_box_new (GimpImageConstraintFunc constraint,
                              gpointer data);

Creates a new GimpIntComboBox filled with all currently opened images. If a `constraint` function is specified, it is called for each image and only if the function returns `TRUE`, the image is added to the combobox.

You should use `gimp_int_combo_box_connect()` to initialize and connect the combo. Use `gimp_int_combo_box_set_active()` to get the active image ID and `gimp_int_combo_box_get_active()` to retrieve the ID of the selected image.

#### Parameters

constraint | a GimpImageConstraintFunc or `NULL` |
data | a pointer that is passed to `constraint` |

#### Returns

a new GimpIntComboBox.

Since GIMP 2.2

## Types and Values

### GimpImageComboBox

    typedef struct _GimpImageComboBox GimpImageComboBox;