<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<!--ENTITY index-Objects-Grouped SYSTEM "objects_grouped.sgml"-->
<refentry id="GtkColorSelectionDialog">
<refmeta>
<refentrytitle role="top_of_page" id="GtkColorSelectionDialog.top_of_page">GtkColorSelectionDialog</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkColorSelectionDialog</refname>
<refpurpose>A standard dialog box for selecting a color</refpurpose>
</refnamediv>

<refsynopsisdiv id="GtkColorSelectionDialog.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;gtk/gtk.h&gt;

                    <link linkend="GtkColorSelectionDialog-struct">GtkColorSelectionDialog</link>;
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-color-selection-dialog-new">gtk_color_selection_dialog_new</link>      (const <link linkend="gchar">gchar</link> *title);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-color-selection-dialog-get-color-selection">gtk_color_selection_dialog_get_color_selection</link>
                                                        (<link linkend="GtkColorSelectionDialog">GtkColorSelectionDialog</link> *colorsel);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GtkColorSelectionDialog.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----<link linkend="GtkWidget">GtkWidget</link>
                     +----<link linkend="GtkContainer">GtkContainer</link>
                           +----<link linkend="GtkBin">GtkBin</link>
                                 +----<link linkend="GtkWindow">GtkWindow</link>
                                       +----<link linkend="GtkDialog">GtkDialog</link>
                                             +----GtkColorSelectionDialog
</synopsis>
</refsect1>



<refsect1 id="GtkColorSelectionDialog.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkColorSelectionDialog implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link> and  <link linkend="GtkBuildable">GtkBuildable</link>.</para>
</refsect1>


<refsect1 id="GtkColorSelectionDialog.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkColorSelectionDialog--cancel-button">cancel-button</link>&quot;            <link linkend="GtkWidget">GtkWidget</link>*            : Read
  &quot;<link linkend="GtkColorSelectionDialog--color-selection">color-selection</link>&quot;          <link linkend="GtkWidget">GtkWidget</link>*            : Read
  &quot;<link linkend="GtkColorSelectionDialog--help-button">help-button</link>&quot;              <link linkend="GtkWidget">GtkWidget</link>*            : Read
  &quot;<link linkend="GtkColorSelectionDialog--ok-button">ok-button</link>&quot;                <link linkend="GtkWidget">GtkWidget</link>*            : Read
</synopsis>
</refsect1>



<refsect1 id="GtkColorSelectionDialog.description" role="desc">
<title role="desc.title">Description</title>
<para>
The <link linkend="GtkColorSelectionDialog"><type>GtkColorSelectionDialog</type></link> provides a standard dialog which
allows the user to select a color much like the <link linkend="GtkFileSelection"><type>GtkFileSelection</type></link>
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 <link linkend="GtkColorSelection"><type>GtkColorSelection</type></link> 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>
</refsect1>

<refsect1 id="GtkColorSelectionDialog.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkColorSelectionDialog-struct" role="struct">
<title>GtkColorSelectionDialog</title>
<indexterm zone="GtkColorSelectionDialog-struct"><primary sortas="ColorSelectionDialog">GtkColorSelectionDialog</primary></indexterm><programlisting>typedef struct _GtkColorSelectionDialog GtkColorSelectionDialog;</programlisting>
<para>
The <link linkend="GtkColorSelectionDialog-struct"><type>GtkColorSelectionDialog</type></link> 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><link linkend="GtkWidget"><type>GtkWidget</type></link> *colorsel;</entry>
<entry>The <link linkend="GtkColorSelection"><type>GtkColorSelection</type></link> widget contained within the
dialog.  Use this widget and its <link linkend="gtk-color-selection-get-current-color"><function>gtk_color_selection_get_current_color()</function></link>
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><link linkend="GtkWidget"><type>GtkWidget</type></link> *ok_button;</entry>
<entry>The OK button widget contained within the dialog.
Connect a handler for the clicked event.
</entry>
</row>
<row>
<entry><link linkend="GtkWidget"><type>GtkWidget</type></link> *cancel_button;</entry>
<entry>The cancel button widget contained within the dialog.
Connect a handler for the clicked event.
</entry>
</row>
<row>
<entry><link linkend="GtkWidget"><type>GtkWidget</type></link> *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></refsect2>
<refsect2 id="gtk-color-selection-dialog-new" role="function">
<title>gtk_color_selection_dialog_new ()</title>
<indexterm zone="gtk-color-selection-dialog-new"><primary sortas="color_selection_dialog_new">gtk_color_selection_dialog_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_color_selection_dialog_new      (const <link linkend="gchar">gchar</link> *title);</programlisting>
<para>
Creates a new <link linkend="GtkColorSelectionDialog"><type>GtkColorSelectionDialog</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>title</parameter>&#160;:</term>
<listitem><simpara>a string containing the title text for the dialog.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>a <link linkend="GtkColorSelectionDialog"><type>GtkColorSelectionDialog</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-color-selection-dialog-get-color-selection" role="function" condition="since:2.14">
<title>gtk_color_selection_dialog_get_color_selection ()</title>
<indexterm zone="gtk-color-selection-dialog-get-color-selection" role="2.14"><primary sortas="color_selection_dialog_get_color_selection">gtk_color_selection_dialog_get_color_selection</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_color_selection_dialog_get_color_selection
                                                        (<link linkend="GtkColorSelectionDialog">GtkColorSelectionDialog</link> *colorsel);</programlisting>
<para>
Retrieves the <link linkend="GtkColorSelection"><type>GtkColorSelection</type></link> widget embedded in the dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>colorsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkColorSelectionDialog"><type>GtkColorSelectionDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the embedded <link linkend="GtkColorSelection"><type>GtkColorSelection</type></link>

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>

</refsect1>
<refsect1 id="GtkColorSelectionDialog.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkColorSelectionDialog--cancel-button" role="property"><title>The <literal>&quot;cancel-button&quot;</literal> property</title>
<indexterm zone="GtkColorSelectionDialog--cancel-button"><primary sortas="ColorSelectionDialog:cancel-button">GtkColorSelectionDialog:cancel-button</primary></indexterm><programlisting>  &quot;cancel-button&quot;            <link linkend="GtkWidget">GtkWidget</link>*            : Read</programlisting>
<para>The cancel button of the dialog.</para></refsect2>
<refsect2 id="GtkColorSelectionDialog--color-selection" role="property"><title>The <literal>&quot;color-selection&quot;</literal> property</title>
<indexterm zone="GtkColorSelectionDialog--color-selection"><primary sortas="ColorSelectionDialog:color-selection">GtkColorSelectionDialog:color-selection</primary></indexterm><programlisting>  &quot;color-selection&quot;          <link linkend="GtkWidget">GtkWidget</link>*            : Read</programlisting>
<para>The color selection embedded in the dialog.</para></refsect2>
<refsect2 id="GtkColorSelectionDialog--help-button" role="property"><title>The <literal>&quot;help-button&quot;</literal> property</title>
<indexterm zone="GtkColorSelectionDialog--help-button"><primary sortas="ColorSelectionDialog:help-button">GtkColorSelectionDialog:help-button</primary></indexterm><programlisting>  &quot;help-button&quot;              <link linkend="GtkWidget">GtkWidget</link>*            : Read</programlisting>
<para>The help button of the dialog.</para></refsect2>
<refsect2 id="GtkColorSelectionDialog--ok-button" role="property"><title>The <literal>&quot;ok-button&quot;</literal> property</title>
<indexterm zone="GtkColorSelectionDialog--ok-button"><primary sortas="ColorSelectionDialog:ok-button">GtkColorSelectionDialog:ok-button</primary></indexterm><programlisting>  &quot;ok-button&quot;                <link linkend="GtkWidget">GtkWidget</link>*            : Read</programlisting>
<para>The OK button of the dialog.</para></refsect2>
</refsect1>




</refentry>
