## GimpColorSelection GimpColorSelection — Widget for doing a color selection. |

## Synopsis

                GimpColorSelection;
    GtkWidget*  gimp_color_selection_new        (void);
    void        gimp_color_selection_set_show_alpha
                                                (GimpColorSelection *selection,
                                                 gboolean show_alpha);
    gboolean    gimp_color_selection_get_show_alpha
                                                (GimpColorSelection *selection);
    void        gimp_color_selection_set_color  (GimpColorSelection *selection,
                                                 const GimpRGB *color);
    void        gimp_color_selection_get_color  (GimpColorSelection *selection,
                                                 GimpRGB *color);
    void        gimp_color_selection_set_old_color
                                                (GimpColorSelection *selection,
                                                 const GimpRGB *color);
    void        gimp_color_selection_get_old_color
                                                (GimpColorSelection *selection,
                                                 GimpRGB *color);
    void        gimp_color_selection_reset      (GimpColorSelection *selection);
    void        gimp_color_selection_color_changed
                                                (GimpColorSelection *selection);

## Object Hierarchy

      GObject
       +----GtkObject
             +----GtkWidget
                   +----GtkContainer
                         +----GtkBox
                               +----GtkVBox
                                     +----GimpColorSelection

## Implemented Interfaces

GimpColorSelection implements AtkImplementorIface.

## Signal Prototypes

    "color-changed"
                void        user_function      (GimpColorSelection *gimpcolorselection,
                                                gpointer user_data);

## Description

## Details

### GimpColorSelection

    typedef struct _GimpColorSelection GimpColorSelection;

### gimp_color_selection_new ()

    GtkWidget*  gimp_color_selection_new        (void);

Creates a new GimpColorSelection widget.

Returns : | The new GimpColorSelection widget.

### gimp_color_selection_set_show_alpha ()

    void        gimp_color_selection_set_show_alpha
                                                (GimpColorSelection *selection,
                                                 gboolean show_alpha);

Sets the `show_alpha` property of the `selection` widget.

`selection` : | A GimpColorSelection widget.
`show_alpha` : | The new `show_alpha` setting.

### gimp_color_selection_get_show_alpha ()

    gboolean    gimp_color_selection_get_show_alpha
                                                (GimpColorSelection *selection);

Returns the `selection`'s `show_alpha` property.

`selection` : | A GimpColorSelection widget.
Returns : | TRUE if the GimpColorSelection has alpha controls.

### gimp_color_selection_set_color ()

    void        gimp_color_selection_set_color  (GimpColorSelection *selection,
                                                 const GimpRGB *color);

Sets the GimpColorSelection's current color to the new `color`.

`selection` : | A GimpColorSelection widget.
`color` : | The `color` to set as current color.

### gimp_color_selection_get_color ()

    void        gimp_color_selection_get_color  (GimpColorSelection *selection,
                                                 GimpRGB *color);

This function returns the GimpColorSelection's current color.

`selection` : | A GimpColorSelection widget.
`color` : | Return location for the `selection`'s current `color`.

### gimp_color_selection_set_old_color ()

    void        gimp_color_selection_set_old_color
                                                (GimpColorSelection *selection,
                                                 const GimpRGB *color);

Sets the GimpColorSelection's old color.

`selection` : | A GimpColorSelection widget.
`color` : | The `color` to set as old color.

### gimp_color_selection_get_old_color ()

    void        gimp_color_selection_get_old_color
                                                (GimpColorSelection *selection,
                                                 GimpRGB *color);

This function returns the GimpColorSelection's old color.

`selection` : | A GimpColorSelection widget.
`color` : | Return location for the `selection`'s old `color`.

### gimp_color_selection_reset ()

    void        gimp_color_selection_reset      (GimpColorSelection *selection);

Sets the GimpColorSelection's current color to its old color.

`selection` : | A GimpColorSelection widget.

### gimp_color_selection_color_changed ()

    void        gimp_color_selection_color_changed
                                                (GimpColorSelection *selection);

Emits the "color_changed" signal.

`selection` : | A GimpColorSelection widget.

## Signals

### The "color-changed" signal

    void        user_function                  (GimpColorSelection *gimpcolorselection,
                                                gpointer user_data);

`gimpcolorselection` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.