1
<!-- ##### SECTION Title ##### -->
2
GtkColorSelectionDialog
4
<!-- ##### SECTION Short_Description ##### -->
5
A standard dialog box for selecting a color
7
<!-- ##### SECTION Long_Description ##### -->
9
The #GtkColorSelectionDialog provides a standard dialog which
10
allows the user to select a color much like the #GtkFileSelection
11
provides a standard dialog for file selection.
14
<refsect2 id="GtkColorSelectionDialog-BUILDER-UI">
15
<title>GtkColorSelectionDialog as GtkBuildable</title>
17
The GtkColorSelectionDialog implementation of the GtkBuildable interface
18
exposes the embedded #GtkColorSelection as internal child with the
19
name "color_selection". It also exposes the buttons with the names
20
"ok_button", "cancel_button" and "help_button".
24
<!-- ##### SECTION See_Also ##### -->
29
<!-- ##### SECTION Stability_Level ##### -->
32
<!-- ##### SECTION Image ##### -->
35
<!-- ##### STRUCT GtkColorSelectionDialog ##### -->
37
The #GtkColorSelectionDialog-struct struct contains the following fields.
38
(These fields should be considered read-only. They should never be set by
41
<informaltable pgwide="1" frame="none" role="struct">
42
<tgroup cols="2"><colspec colwidth="2*"/><colspec colwidth="8*"/>
46
<entry>#GtkWidget *colorsel;</entry>
47
<entry>The #GtkColorSelection widget contained within the
48
dialog. Use this widget and its gtk_color_selection_get_current_color()
49
function to gain access to the selected color. Connect a handler
50
for this widget's color_changed signal to be notified when the
56
<entry>#GtkWidget *ok_button;</entry>
57
<entry>The OK button widget contained within the dialog.
58
Connect a handler for the clicked event.
63
<entry>#GtkWidget *cancel_button;</entry>
64
<entry>The cancel button widget contained within the dialog.
65
Connect a handler for the clicked event.
70
<entry>#GtkWidget *help_button;</entry>
71
<entry>The help button widget contained within the dialog.
72
Connect a handler for the clicked event.
76
</tbody></tgroup></informaltable>
80
<!-- ##### ARG GtkColorSelectionDialog:cancel-button ##### -->
85
<!-- ##### ARG GtkColorSelectionDialog:color-selection ##### -->
90
<!-- ##### ARG GtkColorSelectionDialog:help-button ##### -->
95
<!-- ##### ARG GtkColorSelectionDialog:ok-button ##### -->
100
<!-- ##### FUNCTION gtk_color_selection_dialog_new ##### -->
102
Creates a new #GtkColorSelectionDialog.
105
@title: a string containing the title text for the dialog.
106
@Returns: a #GtkColorSelectionDialog.
109
<!-- ##### FUNCTION gtk_color_selection_dialog_get_color_selection ##### -->