44
44
<td valign="top" align="right"><img src="gimp-color-button.png"></td>
45
45
</tr></table></div>
46
<div class="refsynopsisdiv" title="Synopsis">
46
<div class="refsynopsisdiv">
47
47
<a name="GimpColorButton.synopsis"></a><h2>Synopsis</h2>
48
48
<pre class="synopsis"> <a class="link" href="GimpColorButton.html#GimpColorButton-struct" title="GimpColorButton">GimpColorButton</a>;
49
<a href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GimpColorButton.html#gimp-color-button-new" title="gimp_color_button_new ()">gimp_color_button_new</a> (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
50
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
51
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>,
52
<em class="parameter"><code>const <a href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> *color</code></em>,
49
<a href="http://library.gnome.org/devel/gtk3/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GimpColorButton.html#gimp-color-button-new" title="gimp_color_button_new ()">gimp_color_button_new</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
50
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
51
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>,
52
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> *color</code></em>,
53
53
<em class="parameter"><code><a class="link" href="GimpColorArea.html#GimpColorAreaType" title="enum GimpColorAreaType"><span class="type">GimpColorAreaType</span></a> type</code></em>);
54
54
<span class="returnvalue">void</span> <a class="link" href="GimpColorButton.html#gimp-color-button-set-color" title="gimp_color_button_set_color ()">gimp_color_button_set_color</a> (<em class="parameter"><code><a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> *button</code></em>,
55
<em class="parameter"><code>const <a href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> *color</code></em>);
55
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> *color</code></em>);
56
56
<span class="returnvalue">void</span> <a class="link" href="GimpColorButton.html#gimp-color-button-get-color" title="gimp_color_button_get_color ()">gimp_color_button_get_color</a> (<em class="parameter"><code><a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> *button</code></em>,
57
<em class="parameter"><code><a href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> *color</code></em>);
57
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> *color</code></em>);
58
58
<span class="returnvalue">void</span> <a class="link" href="GimpColorButton.html#gimp-color-button-set-update" title="gimp_color_button_set_update ()">gimp_color_button_set_update</a> (<em class="parameter"><code><a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> *button</code></em>,
59
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> continuous</code></em>);
60
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GimpColorButton.html#gimp-color-button-get-update" title="gimp_color_button_get_update ()">gimp_color_button_get_update</a> (<em class="parameter"><code><a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> *button</code></em>);
61
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GimpColorButton.html#gimp-color-button-has-alpha" title="gimp_color_button_has_alpha ()">gimp_color_button_has_alpha</a> (<em class="parameter"><code><a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> *button</code></em>);
59
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> continuous</code></em>);
60
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GimpColorButton.html#gimp-color-button-get-update" title="gimp_color_button_get_update ()">gimp_color_button_get_update</a> (<em class="parameter"><code><a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> *button</code></em>);
61
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GimpColorButton.html#gimp-color-button-has-alpha" title="gimp_color_button_has_alpha ()">gimp_color_button_has_alpha</a> (<em class="parameter"><code><a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> *button</code></em>);
62
62
<span class="returnvalue">void</span> <a class="link" href="GimpColorButton.html#gimp-color-button-set-type" title="gimp_color_button_set_type ()">gimp_color_button_set_type</a> (<em class="parameter"><code><a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> *button</code></em>,
63
63
<em class="parameter"><code><a class="link" href="GimpColorArea.html#GimpColorAreaType" title="enum GimpColorAreaType"><span class="type">GimpColorAreaType</span></a> type</code></em>);
66
<div class="refsect1" title="Object Hierarchy">
66
<div class="refsect1">
67
67
<a name="GimpColorButton.object-hierarchy"></a><h2>Object Hierarchy</h2>
68
68
<pre class="synopsis">
69
<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
70
+----<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
71
+----<a href="/usr/share/gtk-doc/html/gtk/GtkObject.html">GtkObject</a>
72
+----<a href="/usr/share/gtk-doc/html/gtk/GtkWidget.html">GtkWidget</a>
73
+----<a href="/usr/share/gtk-doc/html/gtk/GtkContainer.html">GtkContainer</a>
74
+----<a href="/usr/share/gtk-doc/html/gtk/GtkBin.html">GtkBin</a>
75
+----<a href="/usr/share/gtk-doc/html/gtk/GtkButton.html">GtkButton</a>
69
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
70
+----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
71
+----<a href="http://library.gnome.org/devel/gtk3/GtkObject.html">GtkObject</a>
72
+----<a href="http://library.gnome.org/devel/gtk3/GtkWidget.html">GtkWidget</a>
73
+----<a href="http://library.gnome.org/devel/gtk3/GtkContainer.html">GtkContainer</a>
74
+----<a href="http://library.gnome.org/devel/gtk3/GtkBin.html">GtkBin</a>
75
+----<a href="http://library.gnome.org/devel/gtk3/GtkButton.html">GtkButton</a>
76
76
+----<a class="link" href="GimpButton.html" title="GimpButton">GimpButton</a>
77
77
+----GimpColorButton
80
<div class="refsect1" title="Implemented Interfaces">
80
<div class="refsect1">
81
81
<a name="GimpColorButton.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
83
83
GimpColorButton implements
84
AtkImplementorIface, <a href="/usr/share/gtk-doc/html/gtk/gtk-gtkbuildable.html#GtkBuildable">GtkBuildable</a> and <a href="/usr/share/gtk-doc/html/gtk/GtkActivatable.html">GtkActivatable</a>.</p>
84
AtkImplementorIface, <a href="http://library.gnome.org/devel/gtk3/GtkBuildable.html">GtkBuildable</a> and <a href="http://library.gnome.org/devel/gtk3/GtkActivatable.html">GtkActivatable</a>.</p>
86
<div class="refsect1" title="Properties">
86
<div class="refsect1">
87
87
<a name="GimpColorButton.properties"></a><h2>Properties</h2>
88
88
<pre class="synopsis">
89
"<a class="link" href="GimpColorButton.html#GimpColorButton--color" title='The "color" property'>color</a>" <a href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a>* : Read / Write / Construct
90
"<a class="link" href="GimpColorButton.html#GimpColorButton--continuous-update" title='The "continuous-update" property'>continuous-update</a>" <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct
91
"<a class="link" href="GimpColorButton.html#GimpColorButton--title" title='The "title" property'>title</a>" <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write / Construct Only
89
"<a class="link" href="GimpColorButton.html#GimpColorButton--color" title='The "color" property'>color</a>" <a href="/usr/share/gtk-doc/html/libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a>* : Read / Write / Construct
90
"<a class="link" href="GimpColorButton.html#GimpColorButton--continuous-update" title='The "continuous-update" property'>continuous-update</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct
91
"<a class="link" href="GimpColorButton.html#GimpColorButton--title" title='The "title" property'>title</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write / Construct Only
92
92
"<a class="link" href="GimpColorButton.html#GimpColorButton--type" title='The "type" property'>type</a>" <a class="link" href="GimpColorArea.html#GimpColorAreaType" title="enum GimpColorAreaType"><span class="type">GimpColorAreaType</span></a> : Read / Write / Construct
95
<div class="refsect1" title="Signals">
95
<div class="refsect1">
96
96
<a name="GimpColorButton.signals"></a><h2>Signals</h2>
97
97
<pre class="synopsis">
98
"<a class="link" href="GimpColorButton.html#GimpColorButton-color-changed" title='The "color-changed" signal'>color-changed</a>" : Run First
98
"<a class="link" href="GimpColorButton.html#GimpColorButton-color-changed" title='The "color-changed" signal'>color-changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
101
<div class="refsect1" title="Description">
101
<div class="refsect1">
102
102
<a name="GimpColorButton.description"></a><h2>Description</h2>
104
104
This widget provides a simple button with a preview showing the
111
111
color, the "color_changed" signal is emitted.
114
<div class="refsect1" title="Details">
114
<div class="refsect1">
115
115
<a name="GimpColorButton.details"></a><h2>Details</h2>
116
<div class="refsect2" title="GimpColorButton">
116
<div class="refsect2">
117
117
<a name="GimpColorButton-struct"></a><h3>GimpColorButton</h3>
118
118
<pre class="programlisting">typedef struct _GimpColorButton GimpColorButton;</pre>
123
<div class="refsect2" title="gimp_color_button_new ()">
123
<div class="refsect2">
124
124
<a name="gimp-color-button-new"></a><h3>gimp_color_button_new ()</h3>
125
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * gimp_color_button_new (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
126
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
127
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>,
128
<em class="parameter"><code>const <a href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> *color</code></em>,
125
<pre class="programlisting"><a href="http://library.gnome.org/devel/gtk3/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * gimp_color_button_new (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
126
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
127
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>,
128
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> *color</code></em>,
129
129
<em class="parameter"><code><a class="link" href="GimpColorArea.html#GimpColorAreaType" title="enum GimpColorAreaType"><span class="type">GimpColorAreaType</span></a> type</code></em>);</pre>
131
131
Creates a new <a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> widget.
144
144
<td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td>
145
<td>String that will be used as title for the color_selector.
145
<td>String that will be used as title for the color_selector.</td>
149
148
<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
150
<td>Width of the colorpreview in pixels.
149
<td>Width of the colorpreview in pixels.</td>
154
152
<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
155
<td>Height of the colorpreview in pixels.
153
<td>Height of the colorpreview in pixels.</td>
159
156
<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
160
<td>A pointer to a <a href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> color.
157
<td>A pointer to a <a href="/usr/share/gtk-doc/html/libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> color.</td>
164
160
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
165
<td> Pointer to the new <a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> widget.
161
<td>Pointer to the new <a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> widget.</td>
172
<div class="refsect2" title="gimp_color_button_set_color ()">
167
<div class="refsect2">
173
168
<a name="gimp-color-button-set-color"></a><h3>gimp_color_button_set_color ()</h3>
174
169
<pre class="programlisting"><span class="returnvalue">void</span> gimp_color_button_set_color (<em class="parameter"><code><a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> *button</code></em>,
175
<em class="parameter"><code>const <a href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> *color</code></em>);</pre>
170
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> *color</code></em>);</pre>
177
172
Sets the <em class="parameter"><code>button</code></em> to the given <em class="parameter"><code>color</code></em>.
207
200
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
208
<td>Pointer to a <a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a>.
201
<td>Pointer to a <a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a>.</td>
212
204
<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
213
<td>Pointer to a <a href="../libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> struct used to return the color.
205
<td>Pointer to a <a href="/usr/share/gtk-doc/html/libgimpcolor/libgimpcolor-GimpRGB.html#GimpRGB"><span class="type">GimpRGB</span></a> struct used to return the color.</td>
220
<div class="refsect2" title="gimp_color_button_set_update ()">
211
<div class="refsect2">
221
212
<a name="gimp-color-button-set-update"></a><h3>gimp_color_button_set_update ()</h3>
222
213
<pre class="programlisting"><span class="returnvalue">void</span> gimp_color_button_set_update (<em class="parameter"><code><a class="link" href="GimpColorButton.html" title="GimpColorButton"><span class="type">GimpColorButton</span></a> *button</code></em>,
223
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> continuous</code></em>);</pre>
214
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> continuous</code></em>);</pre>
225
When set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a>, the <em class="parameter"><code>button</code></em> will emit the "color-changed"
216
When set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a>, the <em class="parameter"><code>button</code></em> will emit the "color-changed"
226
217
continuously while the color is changed in the color selection