4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>gimpoldwidgets</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-deprecated.html" title="Part VI. Deprecated API">
9
9
<link rel="prev" href="libgimpwidgets-deprecated.html" title="Part VI. Deprecated API">
10
10
<link rel="next" href="libgimpwidgets-index.html" title="Index">
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="libgimpwidgets-index.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="#libgimpwidgets-gimpoldwidgets.synopsis" class="shortcut">Top</a>
39
<a href="#libgimpwidgets-gimpoldwidgets.description" class="shortcut">Description</a></nobr></td></tr>
37
<tr><td colspan="5" class="shortcuts">
38
<a href="#libgimpwidgets-gimpoldwidgets.synopsis" class="shortcut">Top</a>
40
<a href="#libgimpwidgets-gimpoldwidgets.description" class="shortcut">Description</a>
41
<div class="refentry" lang="en">
43
<div class="refentry" title="gimpoldwidgets">
42
44
<a name="libgimpwidgets-gimpoldwidgets"></a><div class="titlepage"></div>
43
45
<div class="refnamediv"><table width="100%"><tr>
48
50
<td valign="top" align="right"></td>
49
51
</tr></table></div>
50
<div class="refsynopsisdiv">
52
<div class="refsynopsisdiv" title="Synopsis">
51
53
<a name="libgimpwidgets-gimpoldwidgets.synopsis"></a><h2>Synopsis</h2>
52
54
<pre class="synopsis">
54
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
55
>GtkWidget</a>* <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-int-option-menu-new" title="gimp_int_option_menu_new ()">gimp_int_option_menu_new</a> (<a
56
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
57
>GtkWidget</a> * <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-int-option-menu-new" title="gimp_int_option_menu_new ()">gimp_int_option_menu_new</a> (<a
56
58
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
57
59
>gboolean</a> menu_only,
68
70
void <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-int-option-menu-set-history" title="gimp_int_option_menu_set_history ()">gimp_int_option_menu_set_history</a> (<a
69
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
71
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
70
72
>GtkOptionMenu</a> *option_menu,
72
74
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
81
83
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
82
84
>gpointer</a> callback_data);
83
85
void <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-int-option-menu-set-sensitive" title="gimp_int_option_menu_set_sensitive ()">gimp_int_option_menu_set_sensitive</a> (<a
84
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
86
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
85
87
>GtkOptionMenu</a> *option_menu,
86
88
<a class="link" href="libgimpwidgets-gimpoldwidgets.html#GimpIntOptionMenuSensitivityCallback" title="GimpIntOptionMenuSensitivityCallback ()">GimpIntOptionMenuSensitivityCallback</a> callback,
88
90
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
89
91
>gpointer</a> callback_data);
91
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
92
>GtkWidget</a>* <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new" title="gimp_option_menu_new ()">gimp_option_menu_new</a> (<a
93
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
94
>GtkWidget</a> * <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new" title="gimp_option_menu_new ()">gimp_option_menu_new</a> (<a
93
95
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
94
96
>gboolean</a> menu_only,
97
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
98
>GtkWidget</a>* <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2" title="gimp_option_menu_new2 ()">gimp_option_menu_new2</a> (<a
99
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
100
>GtkWidget</a> * <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2" title="gimp_option_menu_new2 ()">gimp_option_menu_new2</a> (<a
99
101
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
100
102
>gboolean</a> menu_only,
109
111
>gpointer</a> initial,
111
113
void <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-set-history" title="gimp_option_menu_set_history ()">gimp_option_menu_set_history</a> (<a
112
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
114
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
113
115
>GtkOptionMenu</a> *option_menu,
115
117
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
124
126
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
125
127
>gpointer</a> callback_data);
126
128
void <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-set-sensitive" title="gimp_option_menu_set_sensitive ()">gimp_option_menu_set_sensitive</a> (<a
127
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
129
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
128
130
>GtkOptionMenu</a> *option_menu,
129
131
<a class="link" href="libgimpwidgets-gimpoldwidgets.html#GimpOptionMenuSensitivityCallback" title="GimpOptionMenuSensitivityCallback ()">GimpOptionMenuSensitivityCallback</a> callback,
131
133
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
132
134
>gpointer</a> callback_data);
133
135
void <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-menu-item-update" title="gimp_menu_item_update ()">gimp_menu_item_update</a> (<a
134
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
136
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
135
137
>GtkWidget</a> *widget,
137
139
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
138
140
>gpointer</a> data);
141
<div class="refsect1" lang="en">
143
<div class="refsect1" title="Description">
142
144
<a name="libgimpwidgets-gimpoldwidgets.description"></a><h2>Description</h2>
144
146
These functions are not defined if you #define GIMP_DISABLE_DEPRECATED.
147
<div class="refsect1" lang="en">
149
<div class="refsect1" title="Details">
148
150
<a name="libgimpwidgets-gimpoldwidgets.details"></a><h2>Details</h2>
149
<div class="refsect2" lang="en">
151
<div class="refsect2" title="gimp_int_option_menu_new ()">
150
152
<a name="gimp-int-option-menu-new"></a><h3>gimp_int_option_menu_new ()</h3>
151
153
<pre class="programlisting"><a
152
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
153
>GtkWidget</a>* gimp_int_option_menu_new (<a
154
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
155
>GtkWidget</a> * gimp_int_option_menu_new (<a
154
156
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
155
157
>gboolean</a> menu_only,
163
165
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
164
166
>gint</a> initial,
166
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
168
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
167
169
<h3 class="title">Warning</h3>
168
170
<p><code class="literal">gimp_int_option_menu_new</code> is deprecated and should not be used in newly-written code.</p>
171
173
Convenience function to create a <a
172
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
174
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
173
175
><span class="type">GtkOptionMenu</span></a> or a <a
174
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
176
href="http://library.gnome.org/devel/gtk/unstable/GtkMenu.html"
175
177
><span class="type">GtkMenu</span></a>. This
176
178
function does the same thing as the deprecated function
177
179
<a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2" title="gimp_option_menu_new2 ()"><code class="function">gimp_option_menu_new2()</code></a>, but it takes integers as <em class="parameter"><code>item_data</code></em>
178
180
instead of pointers, since that is a very common case (mapping an
179
181
enum to a menu).</p>
183
184
<div class="variablelist"><table border="0">
184
185
<col align="left" valign="top">
187
188
<td><p><span class="term"><em class="parameter"><code>menu_only</code></em> :</span></p></td>
189
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"
190
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
190
191
><code class="literal">TRUE</code></a> if the function should return a <a
191
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
192
href="http://library.gnome.org/devel/gtk/unstable/GtkMenu.html"
192
193
><span class="type">GtkMenu</span></a> only.
215
216
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
217
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"
218
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
218
219
><code class="literal">NULL</code></a>-terminated <em class="parameter"><code>va_list</code></em> describing the menu items.
222
223
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
224
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
225
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
225
226
><span class="type">GtkOptionMenu</span></a> or a <a
226
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
227
href="http://library.gnome.org/devel/gtk/unstable/GtkMenu.html"
227
228
><span class="type">GtkMenu</span></a> (depending on <em class="parameter"><code>menu_only</code></em>).
234
<div class="refsect2" lang="en">
235
<div class="refsect2" title="gimp_int_option_menu_set_history ()">
235
236
<a name="gimp-int-option-menu-set-history"></a><h3>gimp_int_option_menu_set_history ()</h3>
236
237
<pre class="programlisting">void gimp_int_option_menu_set_history (<a
237
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
238
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
238
239
>GtkOptionMenu</a> *option_menu,
240
241
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
241
242
>gint</a> item_data);</pre>
242
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
243
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
243
244
<h3 class="title">Warning</h3>
244
245
<p><code class="literal">gimp_int_option_menu_set_history</code> is deprecated and should not be used in newly-written code.</p>
247
248
Iterates over all entries in a <a
248
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
249
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
249
250
><span class="type">GtkOptionMenu</span></a> and selects the one with the
250
251
matching <em class="parameter"><code>item_data</code></em>. Probably only makes sense to use with a <a
251
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
252
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
252
253
><span class="type">GtkOptionMenu</span></a>
253
254
that was created using <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-int-option-menu-new" title="gimp_int_option_menu_new ()"><code class="function">gimp_int_option_menu_new()</code></a>. This function does the
254
255
same thing as <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-set-history" title="gimp_option_menu_set_history ()"><code class="function">gimp_option_menu_set_history()</code></a>, but takes integers as
255
256
<em class="parameter"><code>item_data</code></em> instead of pointers.</p>
259
259
<div class="variablelist"><table border="0">
260
260
<col align="left" valign="top">
263
263
<td><p><span class="term"><em class="parameter"><code>option_menu</code></em> :</span></p></td>
265
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
265
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
266
266
><span class="type">GtkOptionMenu</span></a> as returned by <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-int-option-menu-new" title="gimp_int_option_menu_new ()"><code class="function">gimp_int_option_menu_new()</code></a>.
278
<div class="refsect2" lang="en">
278
<div class="refsect2" title="GimpIntOptionMenuSensitivityCallback ()">
279
279
<a name="GimpIntOptionMenuSensitivityCallback"></a><h3>GimpIntOptionMenuSensitivityCallback ()</h3>
280
280
<pre class="programlisting"><a
281
281
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
287
287
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
288
288
>gpointer</a> callback_data);</pre>
289
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
289
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
290
290
<h3 class="title">Warning</h3>
291
291
<p><code class="literal">GimpIntOptionMenuSensitivityCallback</code> is deprecated and should not be used in newly-written code.</p>
296
295
<div class="variablelist"><table border="0">
297
296
<col align="left" valign="top">
310
309
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
320
<div class="refsect2" lang="en">
317
<div class="refsect2" title="gimp_int_option_menu_set_sensitive ()">
321
318
<a name="gimp-int-option-menu-set-sensitive"></a><h3>gimp_int_option_menu_set_sensitive ()</h3>
322
319
<pre class="programlisting">void gimp_int_option_menu_set_sensitive (<a
323
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
320
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
324
321
>GtkOptionMenu</a> *option_menu,
325
322
<a class="link" href="libgimpwidgets-gimpoldwidgets.html#GimpIntOptionMenuSensitivityCallback" title="GimpIntOptionMenuSensitivityCallback ()">GimpIntOptionMenuSensitivityCallback</a> callback,
327
324
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
328
325
>gpointer</a> callback_data);</pre>
329
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
326
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
330
327
<h3 class="title">Warning</h3>
331
328
<p><code class="literal">gimp_int_option_menu_set_sensitive</code> is deprecated and should not be used in newly-written code.</p>
337
334
same thing as <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-set-sensitive" title="gimp_option_menu_set_sensitive ()"><code class="function">gimp_option_menu_set_sensitive()</code></a>, but takes integers as
338
335
<em class="parameter"><code>item_data</code></em> instead of pointers.</p>
342
338
<div class="variablelist"><table border="0">
343
339
<col align="left" valign="top">
346
342
<td><p><span class="term"><em class="parameter"><code>option_menu</code></em> :</span></p></td>
348
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
344
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
349
345
><span class="type">GtkOptionMenu</span></a> as returned by <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new" title="gimp_option_menu_new ()"><code class="function">gimp_option_menu_new()</code></a> or
350
346
<a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2" title="gimp_option_menu_new2 ()"><code class="function">gimp_option_menu_new2()</code></a>.
368
<div class="refsect2" lang="en">
364
<div class="refsect2" title="gimp_option_menu_new ()">
369
365
<a name="gimp-option-menu-new"></a><h3>gimp_option_menu_new ()</h3>
370
366
<pre class="programlisting"><a
371
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
372
>GtkWidget</a>* gimp_option_menu_new (<a
367
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
368
>GtkWidget</a> * gimp_option_menu_new (<a
373
369
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
374
370
>gboolean</a> menu_only,
376
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
372
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
377
373
<h3 class="title">Warning</h3>
378
374
<p><code class="literal">gimp_option_menu_new</code> is deprecated and should not be used in newly-written code.</p>
381
377
Convenience function to create a <a
382
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
378
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
383
379
><span class="type">GtkOptionMenu</span></a> or a <a
384
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
380
href="http://library.gnome.org/devel/gtk/unstable/GtkMenu.html"
385
381
><span class="type">GtkMenu</span></a>.</p>
389
384
<div class="variablelist"><table border="0">
390
385
<col align="left" valign="top">
393
388
<td><p><span class="term"><em class="parameter"><code>menu_only</code></em> :</span></p></td>
395
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"
390
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
396
391
><code class="literal">TRUE</code></a> if the function should return a <a
397
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
392
href="http://library.gnome.org/devel/gtk/unstable/GtkMenu.html"
398
393
><span class="type">GtkMenu</span></a> only.
402
397
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
404
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"
399
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
405
400
><code class="literal">NULL</code></a>-terminated <em class="parameter"><code>va_list</code></em> describing the menu items.
409
404
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
411
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
406
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
412
407
><span class="type">GtkOptionMenu</span></a> or a <a
413
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
408
href="http://library.gnome.org/devel/gtk/unstable/GtkMenu.html"
414
409
><span class="type">GtkMenu</span></a> (depending on <em class="parameter"><code>menu_only</code></em>).
421
<div class="refsect2" lang="en">
416
<div class="refsect2" title="gimp_option_menu_new2 ()">
422
417
<a name="gimp-option-menu-new2"></a><h3>gimp_option_menu_new2 ()</h3>
423
418
<pre class="programlisting"><a
424
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
425
>GtkWidget</a>* gimp_option_menu_new2 (<a
419
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
420
>GtkWidget</a> * gimp_option_menu_new2 (<a
426
421
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
427
422
>gboolean</a> menu_only,
435
430
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
436
431
>gpointer</a> initial,
438
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
433
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
439
434
<h3 class="title">Warning</h3>
440
435
<p><code class="literal">gimp_option_menu_new2</code> is deprecated and should not be used in newly-written code.</p>
443
438
Convenience function to create a <a
444
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
439
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
445
440
><span class="type">GtkOptionMenu</span></a> or a <a
446
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
441
href="http://library.gnome.org/devel/gtk/unstable/GtkMenu.html"
447
442
><span class="type">GtkMenu</span></a>.</p>
451
445
<div class="variablelist"><table border="0">
452
446
<col align="left" valign="top">
455
449
<td><p><span class="term"><em class="parameter"><code>menu_only</code></em> :</span></p></td>
457
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"
451
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
458
452
><code class="literal">TRUE</code></a> if the function should return a <a
459
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
453
href="http://library.gnome.org/devel/gtk/unstable/GtkMenu.html"
460
454
><span class="type">GtkMenu</span></a> only.
483
477
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
485
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"
479
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
486
480
><code class="literal">NULL</code></a>-terminated <em class="parameter"><code>va_list</code></em> describing the menu items.
490
484
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
492
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
486
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
493
487
><span class="type">GtkOptionMenu</span></a> or a <a
494
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
488
href="http://library.gnome.org/devel/gtk/unstable/GtkMenu.html"
495
489
><span class="type">GtkMenu</span></a> (depending on <em class="parameter"><code>menu_only</code></em>).
502
<div class="refsect2" lang="en">
496
<div class="refsect2" title="gimp_option_menu_set_history ()">
503
497
<a name="gimp-option-menu-set-history"></a><h3>gimp_option_menu_set_history ()</h3>
504
498
<pre class="programlisting">void gimp_option_menu_set_history (<a
505
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
499
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
506
500
>GtkOptionMenu</a> *option_menu,
508
502
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
509
503
>gpointer</a> item_data);</pre>
510
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
504
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
511
505
<h3 class="title">Warning</h3>
512
506
<p><code class="literal">gimp_option_menu_set_history</code> is deprecated and should not be used in newly-written code.</p>
515
509
Iterates over all entries in a <a
516
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
510
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
517
511
><span class="type">GtkOptionMenu</span></a> and selects the one
518
512
with the matching <em class="parameter"><code>item_data</code></em>. Probably only makes sense to use with
520
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
514
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
521
515
><span class="type">GtkOptionMenu</span></a> that was created using <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new" title="gimp_option_menu_new ()"><code class="function">gimp_option_menu_new()</code></a> or
522
516
<a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2" title="gimp_option_menu_new2 ()"><code class="function">gimp_option_menu_new2()</code></a>.</p>
526
519
<div class="variablelist"><table border="0">
527
520
<col align="left" valign="top">
530
523
<td><p><span class="term"><em class="parameter"><code>option_menu</code></em> :</span></p></td>
532
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
525
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
533
526
><span class="type">GtkOptionMenu</span></a> as returned by <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new" title="gimp_option_menu_new ()"><code class="function">gimp_option_menu_new()</code></a> or
534
527
<a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2" title="gimp_option_menu_new2 ()"><code class="function">gimp_option_menu_new2()</code></a>.
546
<div class="refsect2" lang="en">
539
<div class="refsect2" title="GimpOptionMenuSensitivityCallback ()">
547
540
<a name="GimpOptionMenuSensitivityCallback"></a><h3>GimpOptionMenuSensitivityCallback ()</h3>
548
541
<pre class="programlisting"><a
549
542
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
555
548
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
556
549
>gpointer</a> callback_data);</pre>
557
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
550
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
558
551
<h3 class="title">Warning</h3>
559
552
<p><code class="literal">GimpOptionMenuSensitivityCallback</code> is deprecated and should not be used in newly-written code.</p>
564
556
<div class="variablelist"><table border="0">
565
557
<col align="left" valign="top">
578
570
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
588
<div class="refsect2" lang="en">
578
<div class="refsect2" title="gimp_option_menu_set_sensitive ()">
589
579
<a name="gimp-option-menu-set-sensitive"></a><h3>gimp_option_menu_set_sensitive ()</h3>
590
580
<pre class="programlisting">void gimp_option_menu_set_sensitive (<a
591
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
581
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
592
582
>GtkOptionMenu</a> *option_menu,
593
583
<a class="link" href="libgimpwidgets-gimpoldwidgets.html#GimpOptionMenuSensitivityCallback" title="GimpOptionMenuSensitivityCallback ()">GimpOptionMenuSensitivityCallback</a> callback,
595
585
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
596
586
>gpointer</a> callback_data);</pre>
597
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
587
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
598
588
<h3 class="title">Warning</h3>
599
589
<p><code class="literal">gimp_option_menu_set_sensitive</code> is deprecated and should not be used in newly-written code.</p>
603
593
item_data and the <em class="parameter"><code>callback_data</code></em>. The menu item's sensitivity is set
604
594
according to the return value of this function.</p>
608
597
<div class="variablelist"><table border="0">
609
598
<col align="left" valign="top">
612
601
<td><p><span class="term"><em class="parameter"><code>option_menu</code></em> :</span></p></td>
614
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
603
href="http://library.gnome.org/devel/gtk/unstable/GtkOptionMenu.html"
615
604
><span class="type">GtkOptionMenu</span></a> as returned by <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new" title="gimp_option_menu_new ()"><code class="function">gimp_option_menu_new()</code></a> or
616
605
<a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2" title="gimp_option_menu_new2 ()"><code class="function">gimp_option_menu_new2()</code></a>.
634
<div class="refsect2" lang="en">
623
<div class="refsect2" title="gimp_menu_item_update ()">
635
624
<a name="gimp-menu-item-update"></a><h3>gimp_menu_item_update ()</h3>
636
625
<pre class="programlisting">void gimp_menu_item_update (<a
637
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
626
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
638
627
>GtkWidget</a> *widget,
640
629
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
641
630
>gpointer</a> data);</pre>
642
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
631
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
643
632
<h3 class="title">Warning</h3>
644
633
<p><code class="literal">gimp_menu_item_update</code> is deprecated and should not be used in newly-written code.</p>
651
639
<div class="variablelist"><table border="0">
652
640
<col align="left" valign="top">
655
643
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
657
href="/usr/share/gtk-doc/html/gtk/GtkMenuItem.html"
645
href="http://library.gnome.org/devel/gtk/unstable/GtkMenuItem.html"
658
646
><span class="type">GtkMenuItem</span></a>.