## gimpgradientmenu gimpgradientmenu — A widget for selecting gradients. |

## Synopsis

    GtkWidget*          gimp_gradient_select_widget_new     (const gchar *title,
                                                             const gchar *gradient_name,
                                                             GimpRunGradientCallback callback,
                                                             gpointer data);
    void                gimp_gradient_select_widget_close   (GtkWidget *widget);
    void                gimp_gradient_select_widget_set     (GtkWidget *widget,
                                                             const gchar *gradient_name);

## Description

A widget for selecting gradients.

## Details

### gimp_gradient_select_widget_new ()

    GtkWidget*          gimp_gradient_select_widget_new     (const gchar *title,
                                                             const gchar *gradient_name,
                                                             GimpRunGradientCallback callback,
                                                             gpointer data);

### Warning

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

Creates a new GtkWidget that completely controls the selection of a gradient. This widget is suitable for placement in a table in a plug-in dialog.

`title` : | Title of the dialog to use or `NULL` to use the default title.
`gradient_name` : | Initial gradient name.
`callback` : | A function to call when the selected gradient changes.
`data` : | A pointer to arbitary data to be used in the call to `callback`.
Returns : | A GtkWidget that you can use in your UI.

Since GIMP 2.2

### gimp_gradient_select_widget_close ()

    void                gimp_gradient_select_widget_close   (GtkWidget *widget);

### Warning

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

Closes the popup window associated with `widget`.

`widget` : | A gradient select widget.

### gimp_gradient_select_widget_set ()

    void                gimp_gradient_select_widget_set     (GtkWidget *widget,
                                                             const gchar *gradient_name);

### Warning

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

Sets the current gradient for the gradient select widget. Calls the callback function if one was supplied in the call to `gimp_gradient_select_widget_new()`.

`widget` : | A gradient select widget.
`gradient_name` : | Gradient name to set.