~ubuntu-branches/ubuntu/trusty/gimp/trusty

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Ari Pollak
  • Date: 2009-08-14 09:57:17 UTC
  • mto: (1.1.21 upstream) (0.1.5 squeeze)
  • mto: This revision was merged to the branch mainline in revision 48.
  • Revision ID: james.westby@ubuntu.com-20090814095717-37dh2xqy5t0rurpk
Import upstream version 2.6.7

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
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>
36
36
</tr>
37
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#libgimpwidgets-gimpoldwidgets.synopsis" class="shortcut">Top</a>
38
 
                   | 
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>
 
39
                 | 
 
40
                <a href="#libgimpwidgets-gimpoldwidgets.description" class="shortcut">Description</a>
 
41
</td></tr>
40
42
</table>
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>
44
46
<td valign="top">
47
49
</td>
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">
53
55
<a
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,
58
60
                                                         <a
66
68
>gint</a> initial,
67
69
                                                         ...);
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,
71
73
                                                         <a
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,
87
89
                                                         <a
88
90
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
89
91
>gpointer</a> callback_data);
90
92
<a
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,
95
97
                                                         ...);
96
98
<a
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,
101
103
                                                         <a
109
111
>gpointer</a> initial,
110
112
                                                         ...);
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,
114
116
                                                         <a
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,
130
132
                                                         <a
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,
136
138
                                                         <a
137
139
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
138
140
>gpointer</a> data);
139
141
</pre>
140
142
</div>
141
 
<div class="refsect1" lang="en">
 
143
<div class="refsect1" title="Description">
142
144
<a name="libgimpwidgets-gimpoldwidgets.description"></a><h2>Description</h2>
143
145
<p>
144
146
These functions are not defined if you #define GIMP_DISABLE_DEPRECATED.
145
147
</p>
146
148
</div>
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,
156
158
                                                         <a
163
165
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
164
166
>gint</a> initial,
165
167
                                                         ...);</pre>
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>
169
171
</div>
170
172
<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>
180
182
<p>
181
 
 
182
183
</p>
183
184
<div class="variablelist"><table border="0">
184
185
<col align="left" valign="top">
186
187
<tr>
187
188
<td><p><span class="term"><em class="parameter"><code>menu_only</code></em> :</span></p></td>
188
189
<td>          <a
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.
193
194
</td>
194
195
</tr>
214
215
<tr>
215
216
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
216
217
<td>                A <a
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.
219
220
</td>
220
221
</tr>
221
222
<tr>
222
223
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
223
224
<td> A <a
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>).
228
229
</td>
229
230
</tr>
231
232
</table></div>
232
233
</div>
233
234
<hr>
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,
239
240
                                                         <a
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>
245
246
</div>
246
247
<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>
256
257
<p>
257
 
 
258
258
</p>
259
259
<div class="variablelist"><table border="0">
260
260
<col align="left" valign="top">
262
262
<tr>
263
263
<td><p><span class="term"><em class="parameter"><code>option_menu</code></em> :</span></p></td>
264
264
<td> A <a
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>.
267
267
</td>
268
268
</tr>
275
275
</table></div>
276
276
</div>
277
277
<hr>
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"
286
286
                                                         <a
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>
292
292
</div>
293
293
<p>
294
 
 
295
294
</p>
296
295
<div class="variablelist"><table border="0">
297
296
<col align="left" valign="top">
309
308
<tr>
310
309
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
311
310
<td>
312
 
 
313
 
 
314
311
</td>
315
312
</tr>
316
313
</tbody>
317
314
</table></div>
318
315
</div>
319
316
<hr>
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,
326
323
                                                         <a
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>
332
329
</div>
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>
339
336
<p>
340
 
 
341
337
</p>
342
338
<div class="variablelist"><table border="0">
343
339
<col align="left" valign="top">
345
341
<tr>
346
342
<td><p><span class="term"><em class="parameter"><code>option_menu</code></em> :</span></p></td>
347
343
<td> a <a
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>.
351
347
</td>
365
361
</table></div>
366
362
</div>
367
363
<hr>
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,
375
371
                                                         ...);</pre>
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>
379
375
</div>
380
376
<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>
386
382
<p>
387
 
 
388
383
</p>
389
384
<div class="variablelist"><table border="0">
390
385
<col align="left" valign="top">
392
387
<tr>
393
388
<td><p><span class="term"><em class="parameter"><code>menu_only</code></em> :</span></p></td>
394
389
<td> <a
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.
399
394
</td>
400
395
</tr>
401
396
<tr>
402
397
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
403
398
<td>       A <a
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.
406
401
</td>
407
402
</tr>
408
403
<tr>
409
404
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
410
405
<td> A <a
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>).
415
410
</td>
416
411
</tr>
418
413
</table></div>
419
414
</div>
420
415
<hr>
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,
428
423
                                                         <a
435
430
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
436
431
>gpointer</a> initial,
437
432
                                                         ...);</pre>
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>
441
436
</div>
442
437
<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>
448
443
<p>
449
 
 
450
444
</p>
451
445
<div class="variablelist"><table border="0">
452
446
<col align="left" valign="top">
454
448
<tr>
455
449
<td><p><span class="term"><em class="parameter"><code>menu_only</code></em> :</span></p></td>
456
450
<td>          <a
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.
461
455
</td>
462
456
</tr>
482
476
<tr>
483
477
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
484
478
<td>                A <a
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.
487
481
</td>
488
482
</tr>
489
483
<tr>
490
484
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
491
485
<td> A <a
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>).
496
490
</td>
497
491
</tr>
499
493
</table></div>
500
494
</div>
501
495
<hr>
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,
507
501
                                                         <a
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>
513
507
</div>
514
508
<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
519
513
a <a
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>
523
517
<p>
524
 
 
525
518
</p>
526
519
<div class="variablelist"><table border="0">
527
520
<col align="left" valign="top">
529
522
<tr>
530
523
<td><p><span class="term"><em class="parameter"><code>option_menu</code></em> :</span></p></td>
531
524
<td> A <a
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>.
535
528
</td>
543
536
</table></div>
544
537
</div>
545
538
<hr>
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"
554
547
                                                         <a
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>
560
553
</div>
561
554
<p>
562
 
 
563
555
</p>
564
556
<div class="variablelist"><table border="0">
565
557
<col align="left" valign="top">
577
569
<tr>
578
570
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
579
571
<td>
580
 
 
581
 
 
582
572
</td>
583
573
</tr>
584
574
</tbody>
585
575
</table></div>
586
576
</div>
587
577
<hr>
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,
594
584
                                                         <a
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>
600
590
</div>
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>
605
595
<p>
606
 
 
607
596
</p>
608
597
<div class="variablelist"><table border="0">
609
598
<col align="left" valign="top">
611
600
<tr>
612
601
<td><p><span class="term"><em class="parameter"><code>option_menu</code></em> :</span></p></td>
613
602
<td> a <a
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>.
617
606
</td>
631
620
</table></div>
632
621
</div>
633
622
<hr>
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,
639
628
                                                         <a
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>
645
634
</div>
646
635
<p>
647
636
</p>
648
637
<p>
649
 
 
650
638
</p>
651
639
<div class="variablelist"><table border="0">
652
640
<col align="left" valign="top">
654
642
<tr>
655
643
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
656
644
<td> A <a
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>.
659
647
</td>
660
648
</tr>
670
658
</table></div>
671
659
</div>
672
660
</div>
673
 
<div class="refsect1" lang="en">
 
661
<div class="refsect1" title="See Also">
674
662
<a name="libgimpwidgets-gimpoldwidgets.see-also"></a><h2>See Also</h2>
675
663
<p>
676
664
GimpIntComboBox
679
667
</div>
680
668
<div class="footer">
681
669
<hr>
682
 
          Generated by GTK-Doc V1.10</div>
 
670
          Generated by GTK-Doc V1.11</div>
683
671
</body>
684
672
</html>