gimpoldwidgets

## gimpoldwidgets gimpoldwidgets — Old API that is still available but declared as deprecated. |

## Synopsis

    GtkWidget *         gimp_int_option_menu_new            (gboolean menu_only,
                                                             GCallback menu_item_callback,
                                                             gpointer menu_item_callback_data,
                                                             gint initial,
                                                             ...);
    void                gimp_int_option_menu_set_history    (GtkOptionMenu *option_menu,
                                                             gint item_data);
    gboolean            (*GimpIntOptionMenuSensitivityCallback)
                                                            (gint item_data,
                                                             gpointer callback_data);
    void                gimp_int_option_menu_set_sensitive  (GtkOptionMenu *option_menu,
                                                             GimpIntOptionMenuSensitivityCallback callback,
                                                             gpointer callback_data);
    GtkWidget *         gimp_option_menu_new                (gboolean menu_only,
                                                             ...);
    GtkWidget *         gimp_option_menu_new2               (gboolean menu_only,
                                                             GCallback menu_item_callback,
                                                             gpointer menu_item_callback_data,
                                                             gpointer initial,
                                                             ...);
    void                gimp_option_menu_set_history        (GtkOptionMenu *option_menu,
                                                             gpointer item_data);
    gboolean            (*GimpOptionMenuSensitivityCallback)
                                                            (gpointer item_data,
                                                             gpointer callback_data);
    void                gimp_option_menu_set_sensitive      (GtkOptionMenu *option_menu,
                                                             GimpOptionMenuSensitivityCallback callback,
                                                             gpointer callback_data);
    void                gimp_menu_item_update               (GtkWidget *widget,
                                                             gpointer data);

## Description

These functions are not defined if you #define GIMP_DISABLE_DEPRECATED.

## Details

### gimp_int_option_menu_new ()

    GtkWidget *         gimp_int_option_menu_new            (gboolean menu_only,
                                                             GCallback menu_item_callback,
                                                             gpointer menu_item_callback_data,
                                                             gint initial,
                                                             ...);

### Warning

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

Convenience function to create a GtkOptionMenu or a GtkMenu. This function does the same thing as the deprecated function `gimp_option_menu_new2()`, but it takes integers as `item_data` instead of pointers, since that is a very common case (mapping an enum to a menu).

`menu_only` : | `TRUE` if the function should return a GtkMenu only.
`menu_item_callback` : | The callback each menu item's "activate" signal will be connected with.
`menu_item_callback_data` : | The data which will be passed to `g_signal_connect()`.
`initial` : | The `item_data` of the initially selected menu item.
`...` : | A `NULL`-terminated `va_list` describing the menu items.
Returns : | A GtkOptionMenu or a GtkMenu (depending on `menu_only`).

### gimp_int_option_menu_set_history ()

    void                gimp_int_option_menu_set_history    (GtkOptionMenu *option_menu,
                                                             gint item_data);

### Warning

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

Iterates over all entries in a GtkOptionMenu and selects the one with the matching `item_data`. Probably only makes sense to use with a GtkOptionMenu that was created using `gimp_int_option_menu_new()`. This function does the same thing as `gimp_option_menu_set_history()`, but takes integers as `item_data` instead of pointers.

`option_menu` : | A GtkOptionMenu as returned by `gimp_int_option_menu_new()`.
`item_data` : | The `item_data` of the menu item you want to select.

### GimpIntOptionMenuSensitivityCallback ()

    gboolean            (*GimpIntOptionMenuSensitivityCallback)
                                                            (gint item_data,
                                                             gpointer callback_data);

### Warning

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

`item_data` : |
`callback_data` : |
Returns : |

### gimp_int_option_menu_set_sensitive ()

    void                gimp_int_option_menu_set_sensitive  (GtkOptionMenu *option_menu,
                                                             GimpIntOptionMenuSensitivityCallback callback,
                                                             gpointer callback_data);

### Warning

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

Calls the given `callback` for each item in the menu and passes it the item_data and the `callback_data`. The menu item's sensitivity is set according to the return value of this function. This function does the same thing as `gimp_option_menu_set_sensitive()`, but takes integers as `item_data` instead of pointers.

`option_menu` : | a GtkOptionMenu as returned by `gimp_option_menu_new()` or `gimp_option_menu_new2()`.
`callback` : | a function called for each item in the menu to determine the the sensitivity state.
`callback_data` : | data to pass to the `callback` function.

### gimp_option_menu_new ()

    GtkWidget *         gimp_option_menu_new                (gboolean menu_only,
                                                             ...);

### Warning

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

Convenience function to create a GtkOptionMenu or a GtkMenu.

`menu_only` : | `TRUE` if the function should return a GtkMenu only.
`...` : | A `NULL`-terminated `va_list` describing the menu items.
Returns : | A GtkOptionMenu or a GtkMenu (depending on `menu_only`).

### gimp_option_menu_new2 ()

    GtkWidget *         gimp_option_menu_new2               (gboolean menu_only,
                                                             GCallback menu_item_callback,
                                                             gpointer menu_item_callback_data,
                                                             gpointer initial,
                                                             ...);

### Warning

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

Convenience function to create a GtkOptionMenu or a GtkMenu.

`menu_only` : | `TRUE` if the function should return a GtkMenu only.
`menu_item_callback` : | The callback each menu item's "activate" signal will be connected with.
`menu_item_callback_data` : | The data which will be passed to `g_signal_connect()`.
`initial` : | The `item_data` of the initially selected menu item.
`...` : | A `NULL`-terminated `va_list` describing the menu items.
Returns : | A GtkOptionMenu or a GtkMenu (depending on `menu_only`).

### gimp_option_menu_set_history ()

    void                gimp_option_menu_set_history        (GtkOptionMenu *option_menu,
                                                             gpointer item_data);

### Warning

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

Iterates over all entries in a GtkOptionMenu and selects the one with the matching `item_data`. Probably only makes sense to use with a GtkOptionMenu that was created using `gimp_option_menu_new()` or `gimp_option_menu_new2()`.

`option_menu` : | A GtkOptionMenu as returned by `gimp_option_menu_new()` or `gimp_option_menu_new2()`.
`item_data` : | The `item_data` of the menu item you want to select.

### GimpOptionMenuSensitivityCallback ()

    gboolean            (*GimpOptionMenuSensitivityCallback)
                                                            (gpointer item_data,
                                                             gpointer callback_data);

### Warning

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

`item_data` : |
`callback_data` : |
Returns : |

### gimp_option_menu_set_sensitive ()

    void                gimp_option_menu_set_sensitive      (GtkOptionMenu *option_menu,
                                                             GimpOptionMenuSensitivityCallback callback,
                                                             gpointer callback_data);

### Warning

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

Calls the given `callback` for each item in the menu and passes it the item_data and the `callback_data`. The menu item's sensitivity is set according to the return value of this function.

`option_menu` : | a GtkOptionMenu as returned by `gimp_option_menu_new()` or `gimp_option_menu_new2()`.
`callback` : | a function called for each item in the menu to determine the the sensitivity state.
`callback_data` : | data to pass to the `callback` function.

### gimp_menu_item_update ()

    void                gimp_menu_item_update               (GtkWidget *widget,
                                                             gpointer data);

### Warning

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

`widget` : | A GtkMenuItem.
`data` : | A pointer to a gint variable which will store the value of GPOINTER_TO_INT (g_object_get_data (`widget`, "gimp-item-data")).

## See Also

GimpIntComboBox