33
33
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
34
34
<td><a accesskey="n" href="GimpColorButton.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
36
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2575573" class="shortcut">Top</a>
38
<a href="#id2587387" class="shortcut">Description</a>
40
<a href="#id2584411" class="shortcut">Object Hierarchy</a>
42
<a href="#id2581773" class="shortcut">Implemented Interfaces</a>
44
<a href="#id2581801" class="shortcut">Properties</a>
46
<a href="#id2581866" class="shortcut">Signals</a></nobr></td></tr>
36
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2599640" class="shortcut">Top</a>
38
<a href="#id2596653" class="shortcut">Description</a>
40
<a href="#id2586264" class="shortcut">Object Hierarchy</a>
42
<a href="#id2573725" class="shortcut">Implemented Interfaces</a>
44
<a href="#id2573753" class="shortcut">Properties</a>
46
<a href="#id2573818" class="shortcut">Signals</a></nobr></td></tr>
48
48
<div class="refentry" lang="en">
49
49
<a name="GimpColorArea"></a><div class="titlepage"></div>
50
50
<div class="refnamediv"><table width="100%"><tr>
53
<a name="id2575573"></a><span class="refentrytitle">GimpColorArea</span>
53
<a name="id2599640"></a><span class="refentrytitle">GimpColorArea</span>
55
55
<p>GimpColorArea — Displays a GimpRGB color, optionally with alpha-channel.</p>
65
65
<a class="link" href="GimpColorArea.html#GimpColorArea-struct">GimpColorArea</a>;
66
66
enum <a class="link" href="GimpColorArea.html#GimpColorAreaType">GimpColorAreaType</a>;
67
GtkWidget* <a class="link" href="GimpColorArea.html#gimp-color-area-new">gimp_color_area_new</a> (const <a
68
href="../gtk/GtkWidget.html"
69
>GtkWidget</a>* <a class="link" href="GimpColorArea.html#gimp-color-area-new">gimp_color_area_new</a> (const <a
68
70
href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"
69
71
>GimpRGB</a> *color,
70
72
<a class="link" href="GimpColorArea.html#GimpColorAreaType">GimpColorAreaType</a> type,
71
GdkModifierType drag_mask);
74
href="../gdk/gdk-Windows.html#GdkModifierType"
75
>GdkModifierType</a> drag_mask);
72
76
void <a class="link" href="GimpColorArea.html#gimp-color-area-set-color">gimp_color_area_set_color</a> (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *area,
74
78
href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"
78
82
href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"
79
83
>GimpRGB</a> *color);
80
gboolean <a class="link" href="GimpColorArea.html#gimp-color-area-has-alpha">gimp_color_area_has_alpha</a> (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *area);
85
href="../glib/glib-Basic-Types.html#gboolean"
86
>gboolean</a> <a class="link" href="GimpColorArea.html#gimp-color-area-has-alpha">gimp_color_area_has_alpha</a> (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *area);
81
87
void <a class="link" href="GimpColorArea.html#gimp-color-area-set-type">gimp_color_area_set_type</a> (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *area,
82
88
<a class="link" href="GimpColorArea.html#GimpColorAreaType">GimpColorAreaType</a> type);
83
89
void <a class="link" href="GimpColorArea.html#gimp-color-area-set-draw-border">gimp_color_area_set_draw_border</a> (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *area,
84
gboolean draw_border);
91
href="../glib/glib-Basic-Types.html#gboolean"
92
>gboolean</a> draw_border);
88
96
<div class="refsect1" lang="en">
89
<a name="id2584411"></a><h2>Object Hierarchy</h2>
97
<a name="id2586264"></a><h2>Object Hierarchy</h2>
90
98
<pre class="synopsis">
93
+----GInitiallyUnowned
101
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
104
href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
105
>GInitiallyUnowned</a>
107
href="../gtk/GtkObject.html"
110
href="../gtk/GtkWidget.html"
113
href="../gtk/GtkDrawingArea.html"
97
115
+----GimpColorArea
100
118
<div class="refsect1" lang="en">
101
<a name="id2581773"></a><h2>Implemented Interfaces</h2>
119
<a name="id2573725"></a><h2>Implemented Interfaces</h2>
103
121
GimpColorArea implements
104
122
AtkImplementorIface and GtkBuildable.</p>
106
124
<div class="refsect1" lang="en">
107
<a name="id2581801"></a><h2>Properties</h2>
125
<a name="id2573753"></a><h2>Properties</h2>
108
126
<pre class="synopsis">
110
128
"<a class="link" href="GimpColorArea.html#GimpColorArea--color">color</a>" <a
111
129
href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"
112
130
>GimpRGB</a> : Read / Write / Construct
113
"<a class="link" href="GimpColorArea.html#GimpColorArea--drag-mask">drag-mask</a>" GdkModifierType : Write / Construct Only
114
"<a class="link" href="GimpColorArea.html#GimpColorArea--draw-border">draw-border</a>" gboolean : Read / Write
131
"<a class="link" href="GimpColorArea.html#GimpColorArea--drag-mask">drag-mask</a>" <a
132
href="../gdk/gdk-Windows.html#GdkModifierType"
133
>GdkModifierType</a> : Write / Construct Only
134
"<a class="link" href="GimpColorArea.html#GimpColorArea--draw-border">draw-border</a>" <a
135
href="../glib/glib-Basic-Types.html#gboolean"
136
>gboolean</a> : Read / Write
115
137
"<a class="link" href="GimpColorArea.html#GimpColorArea--type">type</a>" <a class="link" href="GimpColorArea.html#GimpColorAreaType">GimpColorAreaType</a> : Read / Write / Construct
118
140
<div class="refsect1" lang="en">
119
<a name="id2581866"></a><h2>Signals</h2>
141
<a name="id2573818"></a><h2>Signals</h2>
120
142
<pre class="synopsis">
122
144
"<a class="link" href="GimpColorArea.html#GimpColorArea-color-changed">color-changed</a>" : Run First
125
147
<div class="refsect1" lang="en">
126
<a name="id2587387"></a><h2>Description</h2>
148
<a name="id2596653"></a><h2>Description</h2>
131
153
<div class="refsect1" lang="en">
132
<a name="id2587403"></a><h2>Details</h2>
154
<a name="id2596669"></a><h2>Details</h2>
133
155
<div class="refsect2" lang="en">
134
<a name="id2587414"></a><h3>
156
<a name="id2596679"></a><h3>
135
157
<a name="GimpColorArea-struct"></a>GimpColorArea</h3>
136
<a class="indexterm" name="id2587425"></a><pre class="programlisting">typedef struct _GimpColorArea GimpColorArea;</pre>
158
<a class="indexterm" name="id2596691"></a><pre class="programlisting">typedef struct _GimpColorArea GimpColorArea;</pre>
142
164
<div class="refsect2" lang="en">
143
<a name="id2587442"></a><h3>
165
<a name="id2596707"></a><h3>
144
166
<a name="GimpColorAreaType"></a>enum GimpColorAreaType</h3>
145
<a class="indexterm" name="id2587454"></a><pre class="programlisting">typedef enum
167
<a class="indexterm" name="id2596720"></a><pre class="programlisting">typedef enum
147
169
GIMP_COLOR_AREA_FLAT = 0,
148
170
GIMP_COLOR_AREA_SMALL_CHECKS,
157
179
<div class="refsect2" lang="en">
158
<a name="id2587472"></a><h3>
180
<a name="id2596737"></a><h3>
159
181
<a name="gimp-color-area-new"></a>gimp_color_area_new ()</h3>
160
<a class="indexterm" name="id2587484"></a><pre class="programlisting">GtkWidget* gimp_color_area_new (const <a
182
<a class="indexterm" name="id2596750"></a><pre class="programlisting"><a
183
href="../gtk/GtkWidget.html"
184
>GtkWidget</a>* gimp_color_area_new (const <a
161
185
href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"
162
186
>GimpRGB</a> *color,
163
187
<a class="link" href="GimpColorArea.html#GimpColorAreaType">GimpColorAreaType</a> type,
164
GdkModifierType drag_mask);</pre>
189
href="../gdk/gdk-Windows.html#GdkModifierType"
190
>GdkModifierType</a> drag_mask);</pre>
166
192
Creates a new <a class="link" href="GimpColorArea.html" title="GimpColorArea"><span class="type">GimpColorArea</span></a> widget.
265
291
<div class="refsect2" lang="en">
266
<a name="id2582436"></a><h3>
292
<a name="id2584909"></a><h3>
267
293
<a name="gimp-color-area-has-alpha"></a>gimp_color_area_has_alpha ()</h3>
268
<a class="indexterm" name="id2582447"></a><pre class="programlisting">gboolean gimp_color_area_has_alpha (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *area);</pre>
294
<a class="indexterm" name="id2584920"></a><pre class="programlisting"><a
295
href="../glib/glib-Basic-Types.html#gboolean"
296
>gboolean</a> gimp_color_area_has_alpha (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *area);</pre>
270
298
Checks whether the <em class="parameter"><code>area</code></em> shows transparency information. This is determined
271
299
via the <em class="parameter"><code>area</code></em>'s <a class="link" href="GimpColorArea.html#GimpColorAreaType"><span class="type">GimpColorAreaType</span></a>.</p>
292
324
<div class="refsect2" lang="en">
293
<a name="id2618899"></a><h3>
325
<a name="id2618886"></a><h3>
294
326
<a name="gimp-color-area-set-type"></a>gimp_color_area_set_type ()</h3>
295
<a class="indexterm" name="id2618910"></a><pre class="programlisting">void gimp_color_area_set_type (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *area,
327
<a class="indexterm" name="id2618897"></a><pre class="programlisting">void gimp_color_area_set_type (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *area,
296
328
<a class="link" href="GimpColorArea.html#GimpColorAreaType">GimpColorAreaType</a> type);</pre>
298
330
Allows to change the type of <em class="parameter"><code>area</code></em>. The <a class="link" href="GimpColorArea.html#GimpColorAreaType"><span class="type">GimpColorAreaType</span></a> determines
321
353
<div class="refsect2" lang="en">
322
<a name="id2618999"></a><h3>
354
<a name="id2618988"></a><h3>
323
355
<a name="gimp-color-area-set-draw-border"></a>gimp_color_area_set_draw_border ()</h3>
324
<a class="indexterm" name="id2619013"></a><pre class="programlisting">void gimp_color_area_set_draw_border (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *area,
325
gboolean draw_border);</pre>
356
<a class="indexterm" name="id2619002"></a><pre class="programlisting">void gimp_color_area_set_draw_border (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *area,
358
href="../glib/glib-Basic-Types.html#gboolean"
359
>gboolean</a> draw_border);</pre>
327
361
The <em class="parameter"><code>area</code></em> can draw a thin border in the foreground color around
328
362
itself. This function allows to toggle this behaviour on and
350
384
<div class="refsect1" lang="en">
351
<a name="id2619102"></a><h2>Property Details</h2>
385
<a name="id2619091"></a><h2>Property Details</h2>
352
386
<div class="refsect2" lang="en">
353
<a name="id2619113"></a><h3>
387
<a name="id2619102"></a><h3>
354
388
<a name="GimpColorArea--color"></a>The "<code class="literal">color</code>" property</h3>
355
<a class="indexterm" name="id2619126"></a><pre class="programlisting"> "color" <a
389
<a class="indexterm" name="id2619116"></a><pre class="programlisting"> "color" <a
356
390
href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"
357
391
>GimpRGB</a> : Read / Write / Construct</pre>
367
401
<div class="refsect2" lang="en">
368
<a name="id2619160"></a><h3>
402
<a name="id2619149"></a><h3>
369
403
<a name="GimpColorArea--drag-mask"></a>The "<code class="literal">drag-mask</code>" property</h3>
370
<a class="indexterm" name="id2619173"></a><pre class="programlisting"> "drag-mask" GdkModifierType : Write / Construct Only</pre>
404
<a class="indexterm" name="id2619162"></a><pre class="programlisting"> "drag-mask" <a
405
href="../gdk/gdk-Windows.html#GdkModifierType"
406
>GdkModifierType</a> : Write / Construct Only</pre>
374
410
<div class="refsect2" lang="en">
375
<a name="id2602836"></a><h3>
411
<a name="id2619184"></a><h3>
376
412
<a name="GimpColorArea--draw-border"></a>The "<code class="literal">draw-border</code>" property</h3>
377
<a class="indexterm" name="id2619188"></a><pre class="programlisting"> "draw-border" gboolean : Read / Write</pre>
413
<a class="indexterm" name="id2607272"></a><pre class="programlisting"> "draw-border" <a
414
href="../glib/glib-Basic-Types.html#gboolean"
415
>gboolean</a> : Read / Write</pre>
379
417
Whether to draw a thin border in the foreground color around the area.</p>
402
440
<div class="refsect1" lang="en">
403
<a name="id2619268"></a><h2>Signal Details</h2>
441
<a name="id2619259"></a><h2>Signal Details</h2>
404
442
<div class="refsect2" lang="en">
405
<a name="id2619277"></a><h3>
443
<a name="id2619269"></a><h3>
406
444
<a name="GimpColorArea-color-changed"></a>The "color-changed" signal</h3>
407
<a class="indexterm" name="id2619285"></a><pre class="programlisting">void user_function (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *gimpcolorarea,
408
gpointer user_data) : Run First</pre>
445
<a class="indexterm" name="id2619276"></a><pre class="programlisting">void user_function (<a class="link" href="GimpColorArea.html" title="GimpColorArea">GimpColorArea</a> *gimpcolorarea,
447
href="../glib/glib-Basic-Types.html#gpointer"
448
>gpointer</a> user_data) : Run First</pre>