GTK+ Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# GtkColorSelectionDialog

## Name

GtkColorSelectionDialog -- a standard dialog box for selecting a color.

## Synopsis

    #include <gtk/gtk.h>

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

## Object Hierarchy

      GtkObject
       +----GtkWidget
             +----GtkContainer
                   +----GtkBin
                         +----GtkWindow
                               +----GtkColorSelectionDialog

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

## Details

### struct GtkColorSelectionDialog

    struct 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_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.

<<< Previous Page | Home | Up | Next Page >>>
GtkColorSelection | GtkCombo