4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>GimpIntComboBox</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
<link rel="home" href="index.html" title="GIMP Widgets Library Reference Manual">
8
8
<link rel="up" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
9
9
<link rel="prev" href="libgimpwidgets-GimpHintBox.html" title="GimpHintBox">
10
10
<link rel="next" href="GimpIntStore.html" title="GimpIntStore">
11
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="part" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
14
14
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
34
34
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
35
35
<td><a accesskey="n" href="GimpIntStore.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
37
<tr><td colspan="5" class="shortcuts"><nobr><a href="#GimpIntComboBox.synopsis" class="shortcut">Top</a>
39
<a href="#GimpIntComboBox.description" class="shortcut">Description</a>
41
<a href="#GimpIntComboBox.object-hierarchy" class="shortcut">Object Hierarchy</a>
43
<a href="#GimpIntComboBox.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
45
<a href="#GimpIntComboBox.properties" class="shortcut">Properties</a></nobr></td></tr>
37
<tr><td colspan="5" class="shortcuts">
38
<a href="#GimpIntComboBox.synopsis" class="shortcut">Top</a>
40
<a href="#GimpIntComboBox.description" class="shortcut">Description</a>
42
<a href="#GimpIntComboBox.object-hierarchy" class="shortcut">Object Hierarchy</a>
44
<a href="#GimpIntComboBox.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
46
<a href="#GimpIntComboBox.properties" class="shortcut">Properties</a>
47
<div class="refentry" lang="en">
49
<div class="refentry" title="GimpIntComboBox">
48
50
<a name="GimpIntComboBox"></a><div class="titlepage"></div>
49
51
<div class="refnamediv"><table width="100%"><tr>
54
56
<td valign="top" align="right"><img src="gimp-int-combo-box.png"></td>
55
57
</tr></table></div>
56
<div class="refsynopsisdiv">
58
<div class="refsynopsisdiv" title="Synopsis">
57
59
<a name="GimpIntComboBox.synopsis"></a><h2>Synopsis</h2>
58
60
<pre class="synopsis">
59
61
<a class="link" href="GimpIntComboBox.html#GimpIntComboBox-struct" title="GimpIntComboBox">GimpIntComboBox</a>;
66
68
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
67
69
>gpointer</a> data);
69
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
70
>GtkWidget</a>* <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-new" title="gimp_int_combo_box_new ()">gimp_int_combo_box_new</a> (const <a
71
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
72
>GtkWidget</a> * <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-new" title="gimp_int_combo_box_new ()">gimp_int_combo_box_new</a> (const <a
71
73
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
72
74
>gchar</a> *first_label,
75
77
>gint</a> first_value,
78
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
79
>GtkWidget</a>* <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-new-valist" title="gimp_int_combo_box_new_valist ()">gimp_int_combo_box_new_valist</a> (const <a
80
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
81
>GtkWidget</a> * <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-new-valist" title="gimp_int_combo_box_new_valist ()">gimp_int_combo_box_new_valist</a> (const <a
80
82
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
81
83
>gchar</a> *first_label,
84
86
>gint</a> first_value,
87
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
88
>GtkWidget</a>* <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-new-array" title="gimp_int_combo_box_new_array ()">gimp_int_combo_box_new_array</a> (<a
89
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
90
>GtkWidget</a> * <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-new-array" title="gimp_int_combo_box_new_array ()">gimp_int_combo_box_new_array</a> (<a
89
91
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
90
92
>gint</a> n_values,
139
141
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
140
142
>GInitiallyUnowned</a>
142
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
144
href="http://library.gnome.org/devel/gtk/unstable/GtkObject.html"
145
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
147
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
148
href="/usr/share/gtk-doc/html/gtk/GtkContainer.html"
150
href="http://library.gnome.org/devel/gtk/unstable/GtkContainer.html"
149
151
>GtkContainer</a>
151
href="/usr/share/gtk-doc/html/gtk/GtkBin.html"
153
href="http://library.gnome.org/devel/gtk/unstable/GtkBin.html"
154
href="/usr/share/gtk-doc/html/gtk/GtkComboBox.html"
156
href="http://library.gnome.org/devel/gtk/unstable/GtkComboBox.html"
156
158
+----GimpIntComboBox
157
159
+----<a class="link" href="GimpEnumComboBox.html" title="GimpEnumComboBox">GimpEnumComboBox</a>
160
<div class="refsect1" lang="en">
162
<div class="refsect1" title="Implemented Interfaces">
161
163
<a name="GimpIntComboBox.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
163
165
GimpIntComboBox implements
164
AtkImplementorIface, <a
165
href="/usr/share/gtk-doc/html/gtk/gtk-gtkbuildable.html#GtkBuildable"
166
>GtkBuildable</a>, <a
167
href="/usr/share/gtk-doc/html/gtk/GtkCellEditable.html"
167
href="http://library.gnome.org/devel/gtk/unstable/gtk-gtkbuildable.html#GtkBuildable"
168
>GtkBuildable</a>, AtkImplementorIface, <a
169
href="http://library.gnome.org/devel/gtk/unstable/GtkCellEditable.html"
168
170
>GtkCellEditable</a> and <a
169
href="/usr/share/gtk-doc/html/gtk/GtkCellLayout.html"
171
href="http://library.gnome.org/devel/gtk/unstable/GtkCellLayout.html"
170
172
>GtkCellLayout</a>.</p>
172
<div class="refsect1" lang="en">
174
<div class="refsect1" title="Properties">
173
175
<a name="GimpIntComboBox.properties"></a><h2>Properties</h2>
174
176
<pre class="synopsis">
175
177
"<a class="link" href="GimpIntComboBox.html#GimpIntComboBox--ellipsize" title='The "ellipsize" property'>ellipsize</a>" <a
177
179
>PangoEllipsizeMode</a> : Read / Write
180
<div class="refsect1" lang="en">
182
<div class="refsect1" title="Description">
181
183
<a name="GimpIntComboBox.description"></a><h2>Description</h2>
183
185
A widget providing a popup menu of integer values (e.g. enums).
186
<div class="refsect1" lang="en">
188
<div class="refsect1" title="Details">
187
189
<a name="GimpIntComboBox.details"></a><h2>Details</h2>
188
<div class="refsect2" lang="en">
190
<div class="refsect2" title="GimpIntComboBox">
189
191
<a name="GimpIntComboBox-struct"></a><h3>GimpIntComboBox</h3>
190
192
<pre class="programlisting">typedef struct _GimpIntComboBox GimpIntComboBox;</pre>
196
<div class="refsect2" lang="en">
197
<div class="refsect2" title="GimpIntSensitivityFunc ()">
197
198
<a name="GimpIntSensitivityFunc"></a><h3>GimpIntSensitivityFunc ()</h3>
198
199
<pre class="programlisting"><a
199
200
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
223
223
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
233
<div class="refsect2" lang="en">
231
<div class="refsect2" title="gimp_int_combo_box_new ()">
234
232
<a name="gimp-int-combo-box-new"></a><h3>gimp_int_combo_box_new ()</h3>
235
233
<pre class="programlisting"><a
236
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
237
>GtkWidget</a>* gimp_int_combo_box_new (const <a
234
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
235
>GtkWidget</a> * gimp_int_combo_box_new (const <a
238
236
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
239
237
>gchar</a> *first_label,
245
243
Creates a GtkComboBox that has integer values associated with each
246
244
item. The items to fill the combo box with are specified as a <a
247
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"
245
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
248
246
><code class="literal">NULL</code></a>
249
247
terminated list of label/value pairs.
252
250
If you need to construct an empty <a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>, it's best to use
253
251
g_object_new (GIMP_TYPE_INT_COMBO_BOX, NULL).</p>
257
254
<div class="variablelist"><table border="0">
258
255
<col align="left" valign="top">
271
268
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
273
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"
270
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
274
271
><code class="literal">NULL</code></a> terminated list of more label, value pairs
285
<p class="since">Since GIMP 2.2
282
<p class="since">Since GIMP 2.2</p>
289
<div class="refsect2" lang="en">
285
<div class="refsect2" title="gimp_int_combo_box_new_valist ()">
290
286
<a name="gimp-int-combo-box-new-valist"></a><h3>gimp_int_combo_box_new_valist ()</h3>
291
287
<pre class="programlisting"><a
292
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
293
>GtkWidget</a>* gimp_int_combo_box_new_valist (const <a
288
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
289
>GtkWidget</a> * gimp_int_combo_box_new_valist (const <a
294
290
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
295
291
>gchar</a> *first_label,
301
297
A variant of <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-new" title="gimp_int_combo_box_new ()"><code class="function">gimp_int_combo_box_new()</code></a> that takes a va_list of
302
298
label/value pairs. Probably only useful for language bindings.</p>
306
301
<div class="variablelist"><table border="0">
307
302
<col align="left" valign="top">
332
<p class="since">Since GIMP 2.2
327
<p class="since">Since GIMP 2.2</p>
336
<div class="refsect2" lang="en">
330
<div class="refsect2" title="gimp_int_combo_box_new_array ()">
337
331
<a name="gimp-int-combo-box-new-array"></a><h3>gimp_int_combo_box_new_array ()</h3>
338
332
<pre class="programlisting"><a
339
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
340
>GtkWidget</a>* gimp_int_combo_box_new_array (<a
333
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
334
>GtkWidget</a> * gimp_int_combo_box_new_array (<a
341
335
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
342
336
>gint</a> n_values,
347
341
A variant of <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-new" title="gimp_int_combo_box_new ()"><code class="function">gimp_int_combo_box_new()</code></a> that takes an array of labels.
348
342
The array indices are used as values.</p>
352
345
<div class="variablelist"><table border="0">
353
346
<col align="left" valign="top">
373
<p class="since">Since GIMP 2.2
366
<p class="since">Since GIMP 2.2</p>
377
<div class="refsect2" lang="en">
369
<div class="refsect2" title="gimp_int_combo_box_prepend ()">
378
370
<a name="gimp-int-combo-box-prepend"></a><h3>gimp_int_combo_box_prepend ()</h3>
379
371
<pre class="programlisting">void gimp_int_combo_box_prepend (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
382
374
This function provides a convenient way to prepend items to a
383
375
<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>. It prepends a row to the <em class="parameter"><code>combo_box</code></em>'s list store
385
href="/usr/share/gtk-doc/html/gtk/GtkListStore.html#gtk-list-store-set"
377
href="http://library.gnome.org/devel/gtk/unstable/GtkListStore.html#gtk-list-store-set"
386
378
><code class="function">gtk_list_store_set()</code></a> for you.
389
381
The column number must be taken from the enum <a class="link" href="GimpIntStore.html#GimpIntStoreColumns" title="enum GimpIntStoreColumns"><span class="type">GimpIntStoreColumns</span></a>.</p>
393
384
<div class="variablelist"><table border="0">
394
385
<col align="left" valign="top">
408
<p class="since">Since GIMP 2.2
399
<p class="since">Since GIMP 2.2</p>
412
<div class="refsect2" lang="en">
402
<div class="refsect2" title="gimp_int_combo_box_append ()">
413
403
<a name="gimp-int-combo-box-append"></a><h3>gimp_int_combo_box_append ()</h3>
414
404
<pre class="programlisting">void gimp_int_combo_box_append (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
417
407
This function provides a convenient way to append items to a
418
408
<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>. It appends a row to the <em class="parameter"><code>combo_box</code></em>'s list store
420
href="/usr/share/gtk-doc/html/gtk/GtkListStore.html#gtk-list-store-set"
410
href="http://library.gnome.org/devel/gtk/unstable/GtkListStore.html#gtk-list-store-set"
421
411
><code class="function">gtk_list_store_set()</code></a> for you.
424
414
The column number must be taken from the enum <a class="link" href="GimpIntStore.html#GimpIntStoreColumns" title="enum GimpIntStoreColumns"><span class="type">GimpIntStoreColumns</span></a>.</p>
428
417
<div class="variablelist"><table border="0">
429
418
<col align="left" valign="top">
443
<p class="since">Since GIMP 2.2
432
<p class="since">Since GIMP 2.2</p>
447
<div class="refsect2" lang="en">
435
<div class="refsect2" title="gimp_int_combo_box_set_active ()">
448
436
<a name="gimp-int-combo-box-set-active"></a><h3>gimp_int_combo_box_set_active ()</h3>
449
437
<pre class="programlisting"><a
450
438
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
456
444
Looks up the item that belongs to the given <em class="parameter"><code>value</code></em> and makes it the
457
445
selected item in the <em class="parameter"><code>combo_box</code></em>.</p>
461
448
<div class="variablelist"><table border="0">
462
449
<col align="left" valign="top">
475
462
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
477
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"
464
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
478
465
><code class="literal">TRUE</code></a> on success or <a
479
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"
466
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
480
467
><code class="literal">FALSE</code></a> if there was no item for
487
<p class="since">Since GIMP 2.2
474
<p class="since">Since GIMP 2.2</p>
491
<div class="refsect2" lang="en">
477
<div class="refsect2" title="gimp_int_combo_box_get_active ()">
492
478
<a name="gimp-int-combo-box-get-active"></a><h3>gimp_int_combo_box_get_active ()</h3>
493
479
<pre class="programlisting"><a
494
480
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
518
503
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
520
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"
505
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
521
506
><code class="literal">TRUE</code></a> if <em class="parameter"><code>value</code></em> has been set or <a
522
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"
507
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
523
508
><code class="literal">FALSE</code></a> if no item was
530
<p class="since">Since GIMP 2.2
515
<p class="since">Since GIMP 2.2</p>
534
<div class="refsect2" lang="en">
518
<div class="refsect2" title="gimp_int_combo_box_connect ()">
535
519
<a name="gimp-int-combo-box-connect"></a><h3>gimp_int_combo_box_connect ()</h3>
536
520
<pre class="programlisting"><a
537
521
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"
559
543
><code class="function">gimp_drawable_combo_box_new()</code></a>. If you pass an invalid initial
560
544
<em class="parameter"><code>value</code></em>, the <em class="parameter"><code>callback</code></em> will be called with the default item active.</p>
564
547
<div class="variablelist"><table border="0">
565
548
<col align="left" valign="top">
599
<p class="since">Since GIMP 2.2
582
<p class="since">Since GIMP 2.2</p>
603
<div class="refsect2" lang="en">
585
<div class="refsect2" title="gimp_int_combo_box_set_sensitivity ()">
604
586
<a name="gimp-int-combo-box-set-sensitivity"></a><h3>gimp_int_combo_box_set_sensitivity ()</h3>
605
587
<pre class="programlisting">void gimp_int_combo_box_set_sensitivity (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
606
588
<a class="link" href="GimpIntComboBox.html#GimpIntSensitivityFunc" title="GimpIntSensitivityFunc ()">GimpIntSensitivityFunc</a> func,
620
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-queue-draw"
602
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html#gtk-widget-queue-draw"
621
603
><code class="function">gtk_widget_queue_draw()</code></a> on the <em class="parameter"><code>combo_box</code></em> will cause the
622
604
sensitivity to be updated.</p>
626
607
<div class="variablelist"><table border="0">
627
608
<col align="left" valign="top">
635
616
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
636
617
<td> a function that returns a boolean value, or <a
637
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"
618
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
638
619
><code class="literal">NULL</code></a> to unset
653
<p class="since">Since GIMP 2.4
657
<div class="refsect1" lang="en">
634
<p class="since">Since GIMP 2.4</p>
637
<div class="refsect1" title="Property Details">
658
638
<a name="GimpIntComboBox.property-details"></a><h2>Property Details</h2>
659
<div class="refsect2" lang="en">
639
<div class="refsect2" title='The "ellipsize" property'>
660
640
<a name="GimpIntComboBox--ellipsize"></a><h3>The <code class="literal">"ellipsize"</code> property</h3>
661
641
<pre class="programlisting"> "ellipsize" <a
662
642
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"