gtkcolorseldlg.sgml

This GTK+ version 2.12.3. GTK+ is a multi-platform toolkit for creating graphical user interfaces.

<!-- ##### SECTION Title ##### -->
GtkColorSelectionDialog

<!-- ##### SECTION Short_Description ##### -->
A standard dialog box for selecting a color

<!-- ##### SECTION Long_Description ##### -->
<para>
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.
</para>

<refsect2 id="GtkColorSelectionDialog-BUILDER-UI">
<title>GtkColorSelectionDialog as GtkBuildable</title>
<para>
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".
</para>
</refsect2>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### STRUCT GtkColorSelectionDialog ##### -->
<para>
The #GtkColorSelectionDialog-struct struct contains the following fields.
(These fields should be considered read-only. They should never be set by
an application.)

<informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2"><colspec colwidth="2*"/><colspec colwidth="8*"/>
<tbody>

<row>
<entry>#GtkWidget *colorsel;</entry>
<entry>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.
</entry>
</row>

<row>
<entry>#GtkWidget *ok_button;</entry>
<entry>The OK button widget contained within the dialog.  
Connect a handler for the clicked event.
</entry>
</row>

<row>
<entry>#GtkWidget *cancel_button;</entry>
<entry>The cancel button widget contained within the dialog.  
Connect a handler for the clicked event.
</entry>
</row>

<row>
<entry>#GtkWidget *help_button;</entry>
<entry>The help button widget contained within the dialog.  
Connect a handler for the clicked event.
</entry>
</row>

</tbody></tgroup></informaltable>
</para>


<!-- ##### FUNCTION gtk_color_selection_dialog_new ##### -->
<para>
Creates a new #GtkColorSelectionDialog.
</para>

@title: a string containing the title text for the dialog.
@Returns: a #GtkColorSelectionDialog.