## GtkColorCombo

GtkColorCombo — A color combo widget for GTK.

## Synopsis

    #include <gtkextra.h>

                        GtkColorCombo;
    GtkWidget *         gtk_color_combo_new                 (void);
    GtkWidget *         gtk_color_combo_new_with_values     (gint nrows,
                                                             gint ncols,
                                                             GdkColor *colors);
    void                gtk_color_combo_construct           (GtkColorCombo *color_combo);
    void                gtk_color_combo_construct_with_values
                                                            (GtkColorCombo *color_combo,
                                                             gint nrows,
                                                             gint ncols,
                                                             GdkColor *colors);
    GdkColor            gtk_color_combo_get_color_at        (GtkColorCombo *color_combo,
                                                             gint row,
                                                             gint col);
    void                gtk_color_combo_find_color          (GtkColorCombo *color_combo,
                                                             GdkColor *color,
                                                             gint *row,
                                                             gint *col);
    GdkColor            gtk_color_combo_get_selection       (GtkColorCombo *combo);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBox
                                     +----GtkHBox
                                           +----GtkComboButton
                                                 +----GtkColorCombo

## Implemented Interfaces

GtkColorCombo implements AtkImplementorIface, GtkBuildable and GtkOrientable.

## Signals

      "changed"                                        : Run First

## Description

A GtkColorCombo is a GtkCOmbo which contains all kinds of colors.

## Details

### GtkColorCombo

    typedef struct _GtkColorCombo GtkColorCombo;

The GtkColorCombo struct contains only private data. It should only be accessed through the functions described below.

### gtk_color_combo_new ()

    GtkWidget *         gtk_color_combo_new                 (void);

Returns : |

### gtk_color_combo_new_with_values ()

    GtkWidget *         gtk_color_combo_new_with_values     (gint nrows,
                                                             gint ncols,
                                                             GdkColor *colors);

Creates a new GtkColorCombo widget having `nrows` rows and `ncols` columns with GdkColor color.

`nrows` : | number of rows in GtkColorCombo.
`ncols` : | number of columns in GtkColorCombo.
`colors` : | GdkColor color.
Returns : | the newly-created GtkColorCombo widget.

### gtk_color_combo_construct ()

    void                gtk_color_combo_construct           (GtkColorCombo *color_combo);

Initialize a GtkColorCombo object.

`color_combo` : | the GtkColorCombo widget.

### gtk_color_combo_construct_with_values ()

    void                gtk_color_combo_construct_with_values
                                                            (GtkColorCombo *color_combo,
                                                             gint nrows,
                                                             gint ncols,
                                                             GdkColor *colors);

Initialize a GtkColorCombo object with specified values.

`color_combo` : | the GtkColorCombo widget.
`nrows` : | number of rows in GtkColorCombo.
`ncols` : | number of columns in GtkColorCombo.
`colors` : | GdkColor color.

### gtk_color_combo_get_color_at ()

    GdkColor            gtk_color_combo_get_color_at        (GtkColorCombo *color_combo,
                                                             gint row,
                                                             gint col);

Get the color in the combo at the specified row,column.

`color_combo` : | a GtkColorCombo widget.
`row` : | row number in GtkColorCombo.
`col` : | column number in GtkColorCombo.
Returns : | a GdkColor at `row`,`col` in `color_combo`

### gtk_color_combo_find_color ()

    void                gtk_color_combo_find_color          (GtkColorCombo *color_combo,
                                                             GdkColor *color,
                                                             gint *row,
                                                             gint *col);

Find the best match for a given color.

`color_combo` : | a GtkColorCombo widget.
`color` : | a GdkColor object.
`row` : | row number in GtkColorCombo.
`col` : | column number in GtkColorCombo.

### gtk_color_combo_get_selection ()

    GdkColor            gtk_color_combo_get_selection       (GtkColorCombo *combo);

Get the color in the combo at selection .

`combo` : | a GtkColorCombo widget.
Returns : | a GdkColor of the selection.

## Signal Details

### The `"changed"` signal

    void                user_function                      (GtkColorCombo *colorcombo,
                                                            gint           arg1,
                                                            GdkColor      *arg2,
                                                            gpointer       user_data)       : Run First

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