GIMP Library Reference Manual: gimpmenu

## gimpmenu gimpmenu — Menus for selecting images, layers, channels and drawables. |

## Functions

gboolean | (*GimpConstraintFunc) ()
void | (*GimpMenuCallback) ()
GtkWidget * | gimp_image_menu_new ()
GtkWidget * | gimp_layer_menu_new ()
GtkWidget * | gimp_channel_menu_new ()
GtkWidget * | gimp_drawable_menu_new ()

## Description

Menus for selecting images, layers, channels and drawables.

## Functions

### GimpConstraintFunc ()

    gboolean
    (*GimpConstraintFunc) (gint32 image_id,
                           gint32 drawable_id,
                           gpointer data);

`GimpConstraintFunc` is deprecated and should not be used in newly-written code.

#### Returns

### GimpMenuCallback ()

    void
    (*GimpMenuCallback) (gint32 any_id,
                         gpointer data);

`GimpMenuCallback` is deprecated and should not be used in newly-written code.

### gimp_image_menu_new ()

    GtkWidget *
    gimp_image_menu_new (GimpConstraintFunc constraint,
                         GimpMenuCallback callback,
                         gpointer data,
                         gint32 active_image);

`gimp_image_menu_new` is deprecated and should not be used in newly-written code.

Use `gimp_image_combo_box_new()` instead.

#### Parameters

constraint | a function to filter the menu contents |
callback | the callback to call when an image is selected |
data | the callback's user_data |
active_image | an image to preselect |

#### Returns

the image menu.

### gimp_layer_menu_new ()

    GtkWidget *
    gimp_layer_menu_new (GimpConstraintFunc constraint,
                         GimpMenuCallback callback,
                         gpointer data,
                         gint32 active_layer);

`gimp_layer_menu_new` is deprecated and should not be used in newly-written code.

Use `gimp_layer_combo_box_new()` instead.

#### Parameters

constraint | a function to filter the menu contents |
callback | the callback to call when a channel is selected |
data | the callback's user_data |
active_layer | a layer to preselect |

#### Returns

the layer menu.

### gimp_channel_menu_new ()

    GtkWidget *
    gimp_channel_menu_new (GimpConstraintFunc constraint,
                           GimpMenuCallback callback,
                           gpointer data,
                           gint32 active_channel);

`gimp_channel_menu_new` is deprecated and should not be used in newly-written code.

Use `gimp_channel_combo_box_new()` instead.

#### Parameters

constraint | a function to filter the menu contents |
callback | the callback to call when a channel is selected |
data | the callback's user_data |
active_channel | a channel to preselect |

#### Returns

the channel menu.

### gimp_drawable_menu_new ()

    GtkWidget *
    gimp_drawable_menu_new (GimpConstraintFunc constraint,
                            GimpMenuCallback callback,
                            gpointer data,
                            gint32 active_drawable);

`gimp_drawable_menu_new` is deprecated and should not be used in newly-written code.

Use `gimp_drawable_combo_box_new()` instead.

#### Parameters

constraint | a function to filter the menu contents |
callback | the callback to call when a channel is selected |
data | the callback's user_data |
active_drawable | a drawable to preselect |

#### Returns

the drawable menu.

## Types and Values