summaryrefslogtreecommitdiff
path: root/docs/reference/gtk/tmpl/gtkcolorseldlg.sgml
blob: f5a1fe06c0c1274ef97dd0e4a23b2b15b10fcdbb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
<!-- ##### 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>


<!-- ##### ARG GtkColorSelectionDialog:cancel-button ##### -->
<para>

</para>

<!-- ##### ARG GtkColorSelectionDialog:color-selection ##### -->
<para>

</para>

<!-- ##### ARG GtkColorSelectionDialog:help-button ##### -->
<para>

</para>

<!-- ##### ARG GtkColorSelectionDialog:ok-button ##### -->
<para>

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


<!-- ##### FUNCTION gtk_color_selection_dialog_get_color_selection ##### -->
<para>

</para>

@colorsel: 
@Returns: