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);
void                gimp_toggle_button_sensitive_update (GtkToggleButton *toggle_button);
GtkWidget *         gimp_pixmap_button_new              (gchar **xpm_data,
                                                         const gchar *text);
void                gimp_unit_menu_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.

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.

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")).

gimp_toggle_button_sensitive_update ()

void                gimp_toggle_button_sensitive_update (GtkToggleButton *toggle_button);

Warning

gimp_toggle_button_sensitive_update is deprecated and should not be used in newly-written code. use g_object_bind_property() instead of using the "set_sensitive" and "inverse_sensitive" data pointers.

If you attached a pointer to a GtkWidget with g_object_set_data() and the "set_sensitive" key to the GtkToggleButton, the sensitive state of the attached widget will be set according to the toggle button's "active" state.

You can attach an arbitrary list of widgets by attaching another "set_sensitive" data pointer to the first widget (and so on...).

This function can also set the sensitive state according to the toggle button's inverse "active" state by attaching widgets with the "inverse_sensitive" key.

toggle_button :

 The GtkToggleButton the "set_sensitive" and "inverse_sensitive" lists are attached to.

gimp_pixmap_button_new ()

GtkWidget *         gimp_pixmap_button_new              (gchar **xpm_data,
                                                         const gchar *text);

Warning

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

Convenience function that creates a GtkButton with a GimpPixmap and an optional GtkLabel.

xpm_data :

 The XPM data which will be passed to gimp_pixmap_new().

text :

 An optional text which will appear right of the pixmap.

Returns :

 The new GtkButton.

gimp_unit_menu_update ()

void                gimp_unit_menu_update               (GtkWidget *widget,
                                                         gpointer data);

Warning

gimp_unit_menu_update is deprecated and should not be used in newly-written code. use GimpUnitComboBox instead.

This callback can set the number of decimal digits of an arbitrary number of GtkSpinButton's. To use this functionality, attach the spinbuttons as list of data pointers attached with g_object_set_data() with the "set_digits" key.

See gimp_toggle_button_sensitive_update() for a description of how to set up the list.

widget :

 A GimpUnitMenu.

data :

 A pointer to a GimpUnit variable which will store the unit menu's value.

See Also

GimpIntComboBox
Generated by GTK-Doc V1.18