## 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);

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 or `NULL` to use current selection.
`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.

### gimp_gradient_select_widget_close ()

    void        gimp_gradient_select_widget_close
                                                (GtkWidget *widget);

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);

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.