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