## GtkColorSelectionDialog GtkColorSelectionDialog — A standard dialog box for selecting a color |

## Synopsis

    #include <gtk/gtk.h>

                        GtkColorSelectionDialog;
    GtkWidget*          gtk_color_selection_dialog_new      (const gchar *title);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkWindow
                                           +----GtkDialog
                                                 +----GtkColorSelectionDialog

## Implemented Interfaces

GtkColorSelectionDialog implements AtkImplementorIface and GtkBuildable.

## Description

The GtkColorSelectionDialog provides a standard dialog which allows the user to select a color much like the GtkFileSelection provides a standard dialog for file selection.

### GtkColorSelectionDialog as GtkBuildable

The GtkColorSelectionDialog implementation of the GtkBuildable interface exposes the embedded GtkColorSelection as internal child with the name "color_selection". It also exposes the buttons with the names "ok_button", "cancel_button" and "help_button".

## Details

### GtkColorSelectionDialog

    typedef struct _GtkColorSelectionDialog GtkColorSelectionDialog;

The GtkColorSelectionDialog struct contains the following fields. (These fields should be considered read-only. They should never be set by an application.)

GtkWidget *colorsel; | The GtkColorSelection widget contained within the dialog. Use this widget and its `gtk_color_selection_get_current_color()` function to gain access to the selected color. Connect a handler for this widget's color_changed signal to be notified when the color changes.
GtkWidget *ok_button; | The OK button widget contained within the dialog. Connect a handler for the clicked event.
GtkWidget *cancel_button; | The cancel button widget contained within the dialog. Connect a handler for the clicked event.
GtkWidget *help_button; | The help button widget contained within the dialog. Connect a handler for the clicked event.

### gtk_color_selection_dialog_new ()

    GtkWidget*          gtk_color_selection_dialog_new      (const gchar *title);

Creates a new GtkColorSelectionDialog.

`title` : | a string containing the title text for the dialog.
Returns : | a GtkColorSelectionDialog.