15
15
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
18
<refsynopsisdiv id="synopsis">
19
<title id="synopsis.title">Synopsis</title>
18
<refsynopsisdiv role="synopsis">
19
<title role="synopsis.title">Synopsis</title>
25
<link linkend="GimpColorArea-struct">GimpColorArea</link>;
26
enum <link linkend="GimpColorAreaType">GimpColorAreaType</link>;
27
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-color-area-new">gimp_color_area_new</link> (const <link linkend="GimpRGB">GimpRGB</link> *color,
28
<link linkend="GimpColorAreaType">GimpColorAreaType</link> type,
29
<link linkend="GdkModifierType">GdkModifierType</link> drag_mask);
30
<link linkend="void">void</link> <link linkend="gimp-color-area-set-color">gimp_color_area_set_color</link> (<link linkend="GimpColorArea">GimpColorArea</link> *area,
31
const <link linkend="GimpRGB">GimpRGB</link> *color);
32
<link linkend="void">void</link> <link linkend="gimp-color-area-get-color">gimp_color_area_get_color</link> (<link linkend="GimpColorArea">GimpColorArea</link> *area,
33
<link linkend="GimpRGB">GimpRGB</link> *color);
34
<link linkend="gboolean">gboolean</link> <link linkend="gimp-color-area-has-alpha">gimp_color_area_has_alpha</link> (<link linkend="GimpColorArea">GimpColorArea</link> *area);
35
<link linkend="void">void</link> <link linkend="gimp-color-area-set-type">gimp_color_area_set_type</link> (<link linkend="GimpColorArea">GimpColorArea</link> *area,
36
<link linkend="GimpColorAreaType">GimpColorAreaType</link> type);
37
<link linkend="void">void</link> <link linkend="gimp-color-area-set-draw-border">gimp_color_area_set_draw_border</link> (<link linkend="GimpColorArea">GimpColorArea</link> *area,
38
<link linkend="gboolean">gboolean</link> draw_border);
25
<link linkend="GimpColorArea-struct">GimpColorArea</link>;
26
enum <link linkend="GimpColorAreaType">GimpColorAreaType</link>;
27
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-color-area-new">gimp_color_area_new</link> (const <link linkend="GimpRGB">GimpRGB</link> *color,
28
<link linkend="GimpColorAreaType">GimpColorAreaType</link> type,
29
<link linkend="GdkModifierType">GdkModifierType</link> drag_mask);
30
<link linkend="void">void</link> <link linkend="gimp-color-area-set-color">gimp_color_area_set_color</link> (<link linkend="GimpColorArea">GimpColorArea</link> *area,
31
const <link linkend="GimpRGB">GimpRGB</link> *color);
32
<link linkend="void">void</link> <link linkend="gimp-color-area-get-color">gimp_color_area_get_color</link> (<link linkend="GimpColorArea">GimpColorArea</link> *area,
33
<link linkend="GimpRGB">GimpRGB</link> *color);
34
<link linkend="gboolean">gboolean</link> <link linkend="gimp-color-area-has-alpha">gimp_color_area_has_alpha</link> (<link linkend="GimpColorArea">GimpColorArea</link> *area);
35
<link linkend="void">void</link> <link linkend="gimp-color-area-set-type">gimp_color_area_set_type</link> (<link linkend="GimpColorArea">GimpColorArea</link> *area,
36
<link linkend="GimpColorAreaType">GimpColorAreaType</link> type);
37
<link linkend="void">void</link> <link linkend="gimp-color-area-set-draw-border">gimp_color_area_set_draw_border</link> (<link linkend="GimpColorArea">GimpColorArea</link> *area,
38
<link linkend="gboolean">gboolean</link> draw_border);
43
<refsect1 id="object_hierarchy">
44
<title id="object_hierarchy.title">Object Hierarchy</title>
43
<refsect1 role="object_hierarchy">
44
<title role="object_hierarchy.title">Object Hierarchy</title>
47
47
<link linkend="GObject">GObject</link>
69
<refsect1 id="signal_proto">
70
<title id="signal_proto.title">Signals</title>
73
"<link linkend="GimpColorArea-color-changed">color-changed</link>"
74
<link linkend="void">void</link> user_function (<link linkend="GimpColorArea">GimpColorArea</link> *gimpcolorarea,
75
<link linkend="gpointer">gpointer</link> user_data) : Run first
81
<title id="desc.title">Description</title>
68
<refsect1 role="properties">
69
<title role="properties.title">Properties</title>
72
"<link linkend="GimpColorArea--color">color</link>" <link linkend="GimpRGB">GimpRGB</link> : Read / Write / Construct
73
"<link linkend="GimpColorArea--drag-mask">drag-mask</link>" <link linkend="GdkModifierType">GdkModifierType</link> : Write / Construct Only
74
"<link linkend="GimpColorArea--draw-border">draw-border</link>" <link linkend="gboolean">gboolean</link> : Read / Write
75
"<link linkend="GimpColorArea--type">type</link>" <link linkend="GimpColorAreaType">GimpColorAreaType</link> : Read / Write / Construct
79
<refsect1 role="signal_proto">
80
<title role="signal_proto.title">Signals</title>
83
"<link linkend="GimpColorArea-color-changed">color-changed</link>" : Run First
88
<refsect1 role="desc">
89
<title role="desc.title">Description</title>
87
<refsect1 id="details">
88
<title id="details.title">Details</title>
95
<refsect1 role="details">
96
<title role="details.title">Details</title>
90
98
<title><anchor id="GimpColorArea-struct" role="struct"/>GimpColorArea</title>
91
99
<indexterm><primary>GimpColorArea</primary></indexterm><programlisting>typedef struct _GimpColorArea GimpColorArea;</programlisting>
106
114
</para></refsect2>
108
116
<title><anchor id="gimp-color-area-new" role="function"/>gimp_color_area_new ()</title>
109
<indexterm><primary>gimp_color_area_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_color_area_new (const <link linkend="GimpRGB">GimpRGB</link> *color,
110
<link linkend="GimpColorAreaType">GimpColorAreaType</link> type,
111
<link linkend="GdkModifierType">GdkModifierType</link> drag_mask);</programlisting>
117
<indexterm><primary>gimp_color_area_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_color_area_new (const <link linkend="GimpRGB">GimpRGB</link> *color,
118
<link linkend="GimpColorAreaType">GimpColorAreaType</link> type,
119
<link linkend="GdkModifierType">GdkModifierType</link> drag_mask);</programlisting>
113
121
Creates a new <link linkend="GimpColorArea"><type>GimpColorArea</type></link> widget.
132
140
</variablelist></refsect2>
134
142
<title><anchor id="gimp-color-area-set-color" role="function"/>gimp_color_area_set_color ()</title>
135
<indexterm><primary>gimp_color_area_set_color</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_area_set_color (<link linkend="GimpColorArea">GimpColorArea</link> *area,
136
const <link linkend="GimpRGB">GimpRGB</link> *color);</programlisting>
143
<indexterm><primary>gimp_color_area_set_color</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_area_set_color (<link linkend="GimpColorArea">GimpColorArea</link> *area,
144
const <link linkend="GimpRGB">GimpRGB</link> *color);</programlisting>
138
146
Sets <parameter>area</parameter> to a different <parameter>color</parameter>.</para>
148
156
</variablelist></refsect2>
150
158
<title><anchor id="gimp-color-area-get-color" role="function"/>gimp_color_area_get_color ()</title>
151
<indexterm><primary>gimp_color_area_get_color</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_area_get_color (<link linkend="GimpColorArea">GimpColorArea</link> *area,
152
<link linkend="GimpRGB">GimpRGB</link> *color);</programlisting>
159
<indexterm><primary>gimp_color_area_get_color</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_area_get_color (<link linkend="GimpColorArea">GimpColorArea</link> *area,
160
<link linkend="GimpRGB">GimpRGB</link> *color);</programlisting>
154
162
Retrieves the current color of the <parameter>area</parameter>.</para>
164
172
</variablelist></refsect2>
166
174
<title><anchor id="gimp-color-area-has-alpha" role="function"/>gimp_color_area_has_alpha ()</title>
167
<indexterm><primary>gimp_color_area_has_alpha</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_color_area_has_alpha (<link linkend="GimpColorArea">GimpColorArea</link> *area);</programlisting>
175
<indexterm><primary>gimp_color_area_has_alpha</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_color_area_has_alpha (<link linkend="GimpColorArea">GimpColorArea</link> *area);</programlisting>
169
177
Checks whether the <parameter>area</parameter> shows transparency information. This is determined
170
178
via the <parameter>area</parameter>'s <link linkend="GimpColorAreaType"><type>GimpColorAreaType</type></link>.</para>
179
187
</variablelist></refsect2>
181
189
<title><anchor id="gimp-color-area-set-type" role="function"/>gimp_color_area_set_type ()</title>
182
<indexterm><primary>gimp_color_area_set_type</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_area_set_type (<link linkend="GimpColorArea">GimpColorArea</link> *area,
183
<link linkend="GimpColorAreaType">GimpColorAreaType</link> type);</programlisting>
190
<indexterm><primary>gimp_color_area_set_type</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_area_set_type (<link linkend="GimpColorArea">GimpColorArea</link> *area,
191
<link linkend="GimpColorAreaType">GimpColorAreaType</link> type);</programlisting>
185
193
Allows to change the type of <parameter>area</parameter>. The <link linkend="GimpColorAreaType"><type>GimpColorAreaType</type></link> determines
186
194
whether the widget shows transparency information and chooses the size of
197
205
</variablelist></refsect2>
199
207
<title><anchor id="gimp-color-area-set-draw-border" role="function"/>gimp_color_area_set_draw_border ()</title>
200
<indexterm><primary>gimp_color_area_set_draw_border</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_area_set_draw_border (<link linkend="GimpColorArea">GimpColorArea</link> *area,
201
<link linkend="gboolean">gboolean</link> draw_border);</programlisting>
208
<indexterm><primary>gimp_color_area_set_draw_border</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_area_set_draw_border (<link linkend="GimpColorArea">GimpColorArea</link> *area,
209
<link linkend="gboolean">gboolean</link> draw_border);</programlisting>
203
211
The <parameter>area</parameter> can draw a thin border in the foreground color around
204
212
itself. This function allows to toggle this behaviour on and
215
223
</variablelist></refsect2>
219
<refsect1 id="signals">
220
<title id="signals.title">Signal Details</title>
226
<refsect1 role="property_details">
227
<title role="property_details.title">Property Details</title>
228
<refsect2><title><anchor id="GimpColorArea--color"/>The "<literal>color</literal>" property</title>
229
<indexterm role="GIMP 2.4"><primary>GimpColorArea:color</primary></indexterm><programlisting> "color" <link linkend="GimpRGB">GimpRGB</link> : Read / Write / Construct</programlisting>
231
The color displayed in the color area.</para>
234
</para><para>Since GIMP 2.4
237
<refsect2><title><anchor id="GimpColorArea--drag-mask"/>The "<literal>drag-mask</literal>" property</title>
238
<indexterm><primary>GimpColorArea:drag-mask</primary></indexterm><programlisting> "drag-mask" <link linkend="GdkModifierType">GdkModifierType</link> : Write / Construct Only</programlisting>
239
<para></para></refsect2>
240
<refsect2><title><anchor id="GimpColorArea--draw-border"/>The "<literal>draw-border</literal>" property</title>
241
<indexterm role="GIMP 2.4"><primary>GimpColorArea:draw-border</primary></indexterm><programlisting> "draw-border" <link linkend="gboolean">gboolean</link> : Read / Write</programlisting>
243
Whether to draw a thin border in the foreground color around the area.</para>
246
</para><para>Default value: FALSE</para>
250
<refsect2><title><anchor id="GimpColorArea--type"/>The "<literal>type</literal>" property</title>
251
<indexterm role="GIMP 2.4"><primary>GimpColorArea:type</primary></indexterm><programlisting> "type" <link linkend="GimpColorAreaType">GimpColorAreaType</link> : Read / Write / Construct</programlisting>
253
The type of the color area.</para>
256
</para><para>Default value: GIMP_COLOR_AREA_FLAT</para>
263
<refsect1 role="signals">
264
<title role="signals.title">Signal Details</title>
221
265
<refsect2><title><anchor id="GimpColorArea-color-changed"/>The "color-changed" signal</title>
222
<indexterm><primary>GimpColorArea::color-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpColorArea">GimpColorArea</link> *gimpcolorarea,
223
<link linkend="gpointer">gpointer</link> user_data) : Run first</programlisting>
266
<indexterm><primary>GimpColorArea::color-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpColorArea">GimpColorArea</link> *gimpcolorarea,
267
<link linkend="gpointer">gpointer</link> user_data) : Run First</programlisting>
226
270
</para><variablelist role="params">