## 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);
    void                gimp_color_selection_set_config     (GimpColorSelection *selection,
                                                             GimpColorConfig *config);

## Object Hierarchy

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

## Implemented Interfaces

GimpColorSelection implements AtkImplementorIface, GtkBuildable and GtkOrientable.

## Properties

      "config"                   GimpColorConfig*      : Write

## Signals

      "color-changed"                                  : Run First

## Description

Widget for doing a color selection.

## 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.

### gimp_color_selection_set_config ()

    void                gimp_color_selection_set_config     (GimpColorSelection *selection,
                                                             GimpColorConfig *config);

Sets the color management configuration to use with this color selection.

`selection` : | A GimpColorSelection widget.
`config` : | A GimpColorConfig object.

Since GIMP 2.4

## Property Details

### The `"config"` property

      "config"                   GimpColorConfig*      : Write

## Signal Details

### The `"color-changed"` signal

    void                user_function                      (GimpColorSelection *gimpcolorselection,
                                                            gpointer            user_data)               : Run First

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