~ubuntu-branches/ubuntu/jaunty/gimp/jaunty-security

« back to all changes in this revision

Viewing changes to devel-docs/libgimpwidgets/html/GimpIntComboBox.html

  • Committer: Bazaar Package Importer
  • Author(s): Pedro Fragoso
  • Date: 2008-08-22 11:50:05 UTC
  • mfrom: (0.1.1 upstream)
  • mto: This revision was merged to the branch mainline in revision 34.
  • Revision ID: james.westby@ubuntu.com-20080822115005-yxj5svf3v9x1mkr7
Tags: upstream-2.4.7
Import upstream version 2.4.7

Show diffs side-by-side

added added

removed removed

Lines of Context:
56
56
<a name="GimpIntComboBox.synopsis"></a><h2>Synopsis</h2>
57
57
<pre class="synopsis">
58
58
                    <a class="link" href="GimpIntComboBox.html#GimpIntComboBox-struct" title="GimpIntComboBox">GimpIntComboBox</a>;
59
 
<a
60
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
61
 
>gboolean</a>            (<a class="link" href="GimpIntComboBox.html#GimpIntSensitivityFunc" title="GimpIntSensitivityFunc ()">*GimpIntSensitivityFunc</a>)           (<a
62
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
63
 
>gint</a> value,
64
 
                                                         <a
65
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
66
 
>gpointer</a> data);
67
 
<a
68
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
69
 
>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
70
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
71
 
>gchar</a> *first_label,
72
 
                                                         <a
73
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
74
 
>gint</a> first_value,
 
59
gboolean            (<a class="link" href="GimpIntComboBox.html#GimpIntSensitivityFunc" title="GimpIntSensitivityFunc ()">*GimpIntSensitivityFunc</a>)           (gint value,
 
60
                                                         gpointer data);
 
61
GtkWidget*          <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-new" title="gimp_int_combo_box_new ()">gimp_int_combo_box_new</a>              (const gchar *first_label,
 
62
                                                         gint first_value,
75
63
                                                         ...);
76
 
<a
77
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
78
 
>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
79
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
80
 
>gchar</a> *first_label,
81
 
                                                         <a
82
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
83
 
>gint</a> first_value,
 
64
GtkWidget*          <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 gchar *first_label,
 
65
                                                         gint first_value,
84
66
                                                         va_list values);
85
 
<a
86
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
87
 
>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
88
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
89
 
>gint</a> n_values,
90
 
                                                         const <a
91
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
92
 
>gchar</a> *labels[]);
 
67
GtkWidget*          <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>        (gint n_values,
 
68
                                                         const gchar *labels[]);
93
69
void                <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-prepend" title="gimp_int_combo_box_prepend ()">gimp_int_combo_box_prepend</a>          (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
94
70
                                                         ...);
95
71
void                <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-append" title="gimp_int_combo_box_append ()">gimp_int_combo_box_append</a>           (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
96
72
                                                         ...);
97
 
<a
98
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
99
 
>gboolean</a>            <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-set-active" title="gimp_int_combo_box_set_active ()">gimp_int_combo_box_set_active</a>       (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
100
 
                                                         <a
101
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
102
 
>gint</a> value);
103
 
<a
104
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
105
 
>gboolean</a>            <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-get-active" title="gimp_int_combo_box_get_active ()">gimp_int_combo_box_get_active</a>       (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
106
 
                                                         <a
107
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
108
 
>gint</a> *value);
109
 
<a
110
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gulong"
111
 
>gulong</a>              <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-connect" title="gimp_int_combo_box_connect ()">gimp_int_combo_box_connect</a>          (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
112
 
                                                         <a
113
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
114
 
>gint</a> value,
115
 
                                                         <a
116
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
117
 
>GCallback</a> callback,
118
 
                                                         <a
119
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
120
 
>gpointer</a> data);
 
73
gboolean            <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-set-active" title="gimp_int_combo_box_set_active ()">gimp_int_combo_box_set_active</a>       (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
 
74
                                                         gint value);
 
75
gboolean            <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-get-active" title="gimp_int_combo_box_get_active ()">gimp_int_combo_box_get_active</a>       (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
 
76
                                                         gint *value);
 
77
gulong              <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-connect" title="gimp_int_combo_box_connect ()">gimp_int_combo_box_connect</a>          (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
 
78
                                                         gint value,
 
79
                                                         GCallback callback,
 
80
                                                         gpointer data);
121
81
void                <a class="link" href="GimpIntComboBox.html#gimp-int-combo-box-set-sensitivity" title="gimp_int_combo_box_set_sensitivity ()">gimp_int_combo_box_set_sensitivity</a>  (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
122
82
                                                         <a class="link" href="GimpIntComboBox.html#GimpIntSensitivityFunc" title="GimpIntSensitivityFunc ()">GimpIntSensitivityFunc</a> func,
123
 
                                                         <a
124
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
125
 
>gpointer</a> data,
126
 
                                                         <a
127
 
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
128
 
>GDestroyNotify</a> destroy);
 
83
                                                         gpointer data,
 
84
                                                         GDestroyNotify destroy);
129
85
</pre>
130
86
</div>
131
87
<div class="refsect1" lang="en">
132
88
<a name="GimpIntComboBox.object-hierarchy"></a><h2>Object Hierarchy</h2>
133
89
<pre class="synopsis">
134
 
  <a
135
 
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
136
 
>GObject</a>
137
 
   +----<a
138
 
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
139
 
>GInitiallyUnowned</a>
140
 
         +----<a
141
 
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
142
 
>GtkObject</a>
143
 
               +----<a
144
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
145
 
>GtkWidget</a>
146
 
                     +----<a
147
 
href="/usr/share/gtk-doc/html/gtk/GtkContainer.html"
148
 
>GtkContainer</a>
149
 
                           +----<a
150
 
href="/usr/share/gtk-doc/html/gtk/GtkBin.html"
151
 
>GtkBin</a>
152
 
                                 +----<a
153
 
href="/usr/share/gtk-doc/html/gtk/GtkComboBox.html"
154
 
>GtkComboBox</a>
 
90
  GObject
 
91
   +----GInitiallyUnowned
 
92
         +----GtkObject
 
93
               +----GtkWidget
 
94
                     +----GtkContainer
 
95
                           +----GtkBin
 
96
                                 +----GtkComboBox
155
97
                                       +----GimpIntComboBox
156
98
                                             +----<a class="link" href="GimpEnumComboBox.html" title="GimpEnumComboBox">GimpEnumComboBox</a>
157
99
</pre>
160
102
<a name="GimpIntComboBox.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
161
103
<p>
162
104
GimpIntComboBox implements
163
 
 AtkImplementorIface,  GtkBuildable,  <a
164
 
href="/usr/share/gtk-doc/html/gtk/GtkCellEditable.html"
165
 
>GtkCellEditable</a> and  <a
166
 
href="/usr/share/gtk-doc/html/gtk/GtkCellLayout.html"
167
 
>GtkCellLayout</a>.</p>
 
105
 AtkImplementorIface,  GtkBuildable,  GtkCellEditable and  GtkCellLayout.</p>
168
106
</div>
169
107
<div class="refsect1" lang="en">
170
108
<a name="GimpIntComboBox.properties"></a><h2>Properties</h2>
171
109
<pre class="synopsis">
172
 
  "<a class="link" href="GimpIntComboBox.html#GimpIntComboBox--ellipsize" title='The "ellipsize" property'>ellipsize</a>"                <a
173
 
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"
174
 
>PangoEllipsizeMode</a>    : Read / Write
 
110
  "<a class="link" href="GimpIntComboBox.html#GimpIntComboBox--ellipsize" title='The "ellipsize" property'>ellipsize</a>"                PangoEllipsizeMode    : Read / Write
175
111
</pre>
176
112
</div>
177
113
<div class="refsect1" lang="en">
192
128
<hr>
193
129
<div class="refsect2" lang="en">
194
130
<a name="GimpIntSensitivityFunc"></a><h3>GimpIntSensitivityFunc ()</h3>
195
 
<pre class="programlisting"><a
196
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
197
 
>gboolean</a>            (*GimpIntSensitivityFunc)           (<a
198
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
199
 
>gint</a> value,
200
 
                                                         <a
201
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
202
 
>gpointer</a> data);</pre>
 
131
<pre class="programlisting">gboolean            (*GimpIntSensitivityFunc)           (gint value,
 
132
                                                         gpointer data);</pre>
203
133
<p>
204
134
 
205
135
</p>
229
159
<hr>
230
160
<div class="refsect2" lang="en">
231
161
<a name="gimp-int-combo-box-new"></a><h3>gimp_int_combo_box_new ()</h3>
232
 
<pre class="programlisting"><a
233
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
234
 
>GtkWidget</a>*          gimp_int_combo_box_new              (const <a
235
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
236
 
>gchar</a> *first_label,
237
 
                                                         <a
238
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
239
 
>gint</a> first_value,
 
162
<pre class="programlisting">GtkWidget*          gimp_int_combo_box_new              (const gchar *first_label,
 
163
                                                         gint first_value,
240
164
                                                         ...);</pre>
241
165
<p>
242
166
Creates a GtkComboBox that has integer values associated with each
243
 
item. The items to fill the combo box with are specified as a <a
244
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
245
 
><code class="literal">NULL</code></a>
 
167
item. The items to fill the combo box with are specified as a <code class="literal">NULL</code>
246
168
terminated list of label/value pairs.
247
169
</p>
248
170
<p>
266
188
</tr>
267
189
<tr>
268
190
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
269
 
<td> a <a
270
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
271
 
><code class="literal">NULL</code></a> terminated list of more label, value pairs
 
191
<td> a <code class="literal">NULL</code> terminated list of more label, value pairs
272
192
</td>
273
193
</tr>
274
194
<tr>
285
205
<hr>
286
206
<div class="refsect2" lang="en">
287
207
<a name="gimp-int-combo-box-new-valist"></a><h3>gimp_int_combo_box_new_valist ()</h3>
288
 
<pre class="programlisting"><a
289
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
290
 
>GtkWidget</a>*          gimp_int_combo_box_new_valist       (const <a
291
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
292
 
>gchar</a> *first_label,
293
 
                                                         <a
294
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
295
 
>gint</a> first_value,
 
208
<pre class="programlisting">GtkWidget*          gimp_int_combo_box_new_valist       (const gchar *first_label,
 
209
                                                         gint first_value,
296
210
                                                         va_list values);</pre>
297
211
<p>
298
212
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
332
246
<hr>
333
247
<div class="refsect2" lang="en">
334
248
<a name="gimp-int-combo-box-new-array"></a><h3>gimp_int_combo_box_new_array ()</h3>
335
 
<pre class="programlisting"><a
336
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
337
 
>GtkWidget</a>*          gimp_int_combo_box_new_array        (<a
338
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
339
 
>gint</a> n_values,
340
 
                                                         const <a
341
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
342
 
>gchar</a> *labels[]);</pre>
 
249
<pre class="programlisting">GtkWidget*          gimp_int_combo_box_new_array        (gint n_values,
 
250
                                                         const gchar *labels[]);</pre>
343
251
<p>
344
252
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.
345
253
The array indices are used as values.</p>
378
286
<p>
379
287
This function provides a convenient way to prepend items to a
380
288
<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
381
 
and calls <a
382
 
href="/usr/share/gtk-doc/html/gtk/GtkListStore.html#gtk-list-store-set"
383
 
><code class="function">gtk_list_store_set()</code></a> for you.
 
289
and calls <code class="function">gtk_list_store_set()</code> for you.
384
290
</p>
385
291
<p>
386
292
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>
413
319
<p>
414
320
This function provides a convenient way to append items to a
415
321
<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
416
 
and calls <a
417
 
href="/usr/share/gtk-doc/html/gtk/GtkListStore.html#gtk-list-store-set"
418
 
><code class="function">gtk_list_store_set()</code></a> for you.
 
322
and calls <code class="function">gtk_list_store_set()</code> for you.
419
323
</p>
420
324
<p>
421
325
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>
443
347
<hr>
444
348
<div class="refsect2" lang="en">
445
349
<a name="gimp-int-combo-box-set-active"></a><h3>gimp_int_combo_box_set_active ()</h3>
446
 
<pre class="programlisting"><a
447
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
448
 
>gboolean</a>            gimp_int_combo_box_set_active       (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
449
 
                                                         <a
450
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
451
 
>gint</a> value);</pre>
 
350
<pre class="programlisting">gboolean            gimp_int_combo_box_set_active       (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
 
351
                                                         gint value);</pre>
452
352
<p>
453
353
Looks up the item that belongs to the given <em class="parameter"><code>value</code></em> and makes it the
454
354
selected item in the <em class="parameter"><code>combo_box</code></em>.</p>
470
370
</tr>
471
371
<tr>
472
372
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
473
 
<td> <a
474
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
475
 
><code class="literal">TRUE</code></a> on success or <a
476
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
477
 
><code class="literal">FALSE</code></a> if there was no item for
 
373
<td> <code class="literal">TRUE</code> on success or <code class="literal">FALSE</code> if there was no item for
478
374
              this value.
479
375
 
480
376
</td>
487
383
<hr>
488
384
<div class="refsect2" lang="en">
489
385
<a name="gimp-int-combo-box-get-active"></a><h3>gimp_int_combo_box_get_active ()</h3>
490
 
<pre class="programlisting"><a
491
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
492
 
>gboolean</a>            gimp_int_combo_box_get_active       (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
493
 
                                                         <a
494
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
495
 
>gint</a> *value);</pre>
 
386
<pre class="programlisting">gboolean            gimp_int_combo_box_get_active       (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
 
387
                                                         gint *value);</pre>
496
388
<p>
497
389
Retrieves the value of the selected (active) item in the <em class="parameter"><code>combo_box</code></em>.</p>
498
390
<p>
513
405
</tr>
514
406
<tr>
515
407
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
516
 
<td> <a
517
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
518
 
><code class="literal">TRUE</code></a> if <em class="parameter"><code>value</code></em> has been set or <a
519
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
520
 
><code class="literal">FALSE</code></a> if no item was
 
408
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>value</code></em> has been set or <code class="literal">FALSE</code> if no item was
521
409
              active.
522
410
 
523
411
</td>
530
418
<hr>
531
419
<div class="refsect2" lang="en">
532
420
<a name="gimp-int-combo-box-connect"></a><h3>gimp_int_combo_box_connect ()</h3>
533
 
<pre class="programlisting"><a
534
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gulong"
535
 
>gulong</a>              gimp_int_combo_box_connect          (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
536
 
                                                         <a
537
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
538
 
>gint</a> value,
539
 
                                                         <a
540
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
541
 
>GCallback</a> callback,
542
 
                                                         <a
543
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
544
 
>gpointer</a> data);</pre>
 
421
<pre class="programlisting">gulong              gimp_int_combo_box_connect          (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
 
422
                                                         gint value,
 
423
                                                         GCallback callback,
 
424
                                                         gpointer data);</pre>
545
425
<p>
546
426
A convenience function that sets the inital <em class="parameter"><code>value</code></em> of a
547
427
<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> and connects <em class="parameter"><code>callback</code></em> to the "changed"
551
431
This function also calls the <em class="parameter"><code>callback</code></em> once after setting the
552
432
initial <em class="parameter"><code>value</code></em>. This is often convenient when working with combo
553
433
boxes that select a default active item, like for example
554
 
<a
555
 
href="/usr/share/gtk-doc/html/libgimp/libgimp-GimpItemComboBox.html#gimp-drawable-combo-box-new"
556
 
><code class="function">gimp_drawable_combo_box_new()</code></a>. If you pass an invalid initial
 
434
<code class="function">gimp_drawable_combo_box_new()</code>. If you pass an invalid initial
557
435
<em class="parameter"><code>value</code></em>, the <em class="parameter"><code>callback</code></em> will be called with the default item active.</p>
558
436
<p>
559
437
 
578
456
</tr>
579
457
<tr>
580
458
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
581
 
<td>      a pointer passed as data to <a
582
 
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect"
583
 
><code class="function">g_signal_connect()</code></a>
 
459
<td>      a pointer passed as data to <code class="function">g_signal_connect()</code>
584
460
</td>
585
461
</tr>
586
462
<tr>
587
463
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
588
 
<td> the signal handler ID as returned by <a
589
 
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect"
590
 
><code class="function">g_signal_connect()</code></a>
 
464
<td> the signal handler ID as returned by <code class="function">g_signal_connect()</code>
591
465
 
592
466
</td>
593
467
</tr>
601
475
<a name="gimp-int-combo-box-set-sensitivity"></a><h3>gimp_int_combo_box_set_sensitivity ()</h3>
602
476
<pre class="programlisting">void                gimp_int_combo_box_set_sensitivity  (<a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
603
477
                                                         <a class="link" href="GimpIntComboBox.html#GimpIntSensitivityFunc" title="GimpIntSensitivityFunc ()">GimpIntSensitivityFunc</a> func,
604
 
                                                         <a
605
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
606
 
>gpointer</a> data,
607
 
                                                         <a
608
 
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
609
 
>GDestroyNotify</a> destroy);</pre>
 
478
                                                         gpointer data,
 
479
                                                         GDestroyNotify destroy);</pre>
610
480
<p>
611
481
Sets a function that is used to decide about the sensitivity of
612
482
rows in the <em class="parameter"><code>combo_box</code></em>. Use this if you want to set certain rows
613
483
insensitive.
614
484
</p>
615
485
<p>
616
 
Calling <a
617
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-queue-draw"
618
 
><code class="function">gtk_widget_queue_draw()</code></a> on the <em class="parameter"><code>combo_box</code></em> will cause the
 
486
Calling <code class="function">gtk_widget_queue_draw()</code> on the <em class="parameter"><code>combo_box</code></em> will cause the
619
487
sensitivity to be updated.</p>
620
488
<p>
621
489
 
630
498
</tr>
631
499
<tr>
632
500
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
633
 
<td> a function that returns a boolean value, or <a
634
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
635
 
><code class="literal">NULL</code></a> to unset
 
501
<td> a function that returns a boolean value, or <code class="literal">NULL</code> to unset
636
502
</td>
637
503
</tr>
638
504
<tr>
655
521
<a name="GimpIntComboBox.property-details"></a><h2>Property Details</h2>
656
522
<div class="refsect2" lang="en">
657
523
<a name="GimpIntComboBox--ellipsize"></a><h3>The <code class="literal">"ellipsize"</code> property</h3>
658
 
<pre class="programlisting">  "ellipsize"                <a
659
 
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"
660
 
>PangoEllipsizeMode</a>    : Read / Write</pre>
 
524
<pre class="programlisting">  "ellipsize"                PangoEllipsizeMode    : Read / Write</pre>
661
525
<p>
662
526
Specifies the preferred place to ellipsize text in the combo-box,
663
527
if the cell renderer does not have enough room to display the