← Back to branch summary

~ubuntu-branches/ubuntu/maverick/gimp/maverick-updates

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Holbach
  • Date: 2005-12-09 19:44:52 UTC
  • Revision ID: james.westby@ubuntu.com-20051209194452-yggpemjlofpjqyf4
Tags: upstream-2.2.9
Import upstream version 2.2.9

Show diffs side-by-side

added added

removed removed

Lines of Context:
devel-docs/libgimpwidgets/html/libgimpwidgets-gimpoldwidgets.html
 
1
<html>
 
2
<head>
 
3
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 
4
<title>gimpoldwidgets</title>
 
5
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
 
6
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
 
7
<link rel="up" href="libgimpwidgets-deprecated.html" title="Part&#160;VI.&#160;Deprecated API">
 
8
<link rel="prev" href="libgimpwidgets-deprecated.html" title="Part&#160;VI.&#160;Deprecated API">
 
9
<meta name="generator" content="GTK-Doc V1.4 (XML mode)">
 
10
<link rel="stylesheet" href="style.css" type="text/css">
 
11
<link rel="part" href="libgimpwidgets-widgets.html" title="Part&#160;I.&#160;GIMP Widgets">
 
12
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
 
13
<link rel="chapter" href="libgimpwidgets-cell-renderers.html" title="Cell Renderers for GtkTreeView">
 
14
<link rel="part" href="libgimpwidgets-colordisplay.html" title="Part&#160;II.&#160;GIMP Display Filters">
 
15
<link rel="part" href="libgimpwidgets-colorselector.html" title="Part&#160;III.&#160;GIMP Color Selectors">
 
16
<link rel="part" href="libgimpwidgets-controller.html" title="Part&#160;IV.&#160;GIMP Controllers">
 
17
<link rel="part" href="libgimpwidgets-utils.html" title="Part&#160;V.&#160;GIMP Widgets Utilities">
 
18
<link rel="part" href="libgimpwidgets-deprecated.html" title="Part&#160;VI.&#160;Deprecated API">
 
19
</head>
 
20
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 
21
<table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
 
22
<td><a accesskey="p" href="libgimpwidgets-deprecated.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
23
<td><a accesskey="u" href="libgimpwidgets-deprecated.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
24
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
25
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
 
26
</tr></table>
 
27
<div class="refentry" lang="en">
 
28
<a name="libgimpwidgets-gimpoldwidgets"></a><div class="titlepage"></div>
 
29
<div class="refnamediv"><table width="100%"><tr>
 
30
<td valign="top">
 
31
<h2><span class="refentrytitle">gimpoldwidgets</span></h2>
 
32
<p>gimpoldwidgets &#8212; Old API that is still available but declared as deprecated.</p>
 
33
</td>
 
34
<td valign="top" align="right"></td>
 
35
</tr></table></div>
 
36
<div class="refsynopsisdiv">
 
37
<h2>Synopsis</h2>
 
38
<pre class="synopsis">
 
39
 
 
40
 
 
41
 
 
42
<a
 
43
href="../gtk/GtkWidget.html"
 
44
>GtkWidget</a>*  <a href="libgimpwidgets-gimpoldwidgets.html#gimp-int-option-menu-new">gimp_int_option_menu_new</a>        (gboolean menu_only,
 
45
                                             GCallback menu_item_callback,
 
46
                                             gpointer menu_item_callback_data,
 
47
                                             gint initial,
 
48
                                             ...);
 
49
void        <a href="libgimpwidgets-gimpoldwidgets.html#gimp-int-option-menu-set-history">gimp_int_option_menu_set_history</a>
 
50
                                            (<a
 
51
href="../gtk/GtkOptionMenu.html"
 
52
>GtkOptionMenu</a> *option_menu,
 
53
                                             gint item_data);
 
54
gboolean    (<a href="libgimpwidgets-gimpoldwidgets.html#GimpIntOptionMenuSensitivityCallback">*GimpIntOptionMenuSensitivityCallback</a>)
 
55
                                            (gint item_data,
 
56
                                             gpointer callback_data);
 
57
void        <a href="libgimpwidgets-gimpoldwidgets.html#gimp-int-option-menu-set-sensitive">gimp_int_option_menu_set_sensitive</a>
 
58
                                            (<a
 
59
href="../gtk/GtkOptionMenu.html"
 
60
>GtkOptionMenu</a> *option_menu,
 
61
                                             <a href="libgimpwidgets-gimpoldwidgets.html#GimpIntOptionMenuSensitivityCallback">GimpIntOptionMenuSensitivityCallback</a> callback,
 
62
                                             gpointer callback_data);
 
63
<a
 
64
href="../gtk/GtkWidget.html"
 
65
>GtkWidget</a>*  <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new">gimp_option_menu_new</a>            (gboolean menu_only,
 
66
                                             ...);
 
67
<a
 
68
href="../gtk/GtkWidget.html"
 
69
>GtkWidget</a>*  <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2">gimp_option_menu_new2</a>           (gboolean menu_only,
 
70
                                             GCallback menu_item_callback,
 
71
                                             gpointer menu_item_callback_data,
 
72
                                             gpointer initial,
 
73
                                             ...);
 
74
void        <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-set-history">gimp_option_menu_set_history</a>    (<a
 
75
href="../gtk/GtkOptionMenu.html"
 
76
>GtkOptionMenu</a> *option_menu,
 
77
                                             gpointer item_data);
 
78
gboolean    (<a href="libgimpwidgets-gimpoldwidgets.html#GimpOptionMenuSensitivityCallback">*GimpOptionMenuSensitivityCallback</a>)
 
79
                                            (gpointer item_data,
 
80
                                             gpointer callback_data);
 
81
void        <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-set-sensitive">gimp_option_menu_set_sensitive</a>  (<a
 
82
href="../gtk/GtkOptionMenu.html"
 
83
>GtkOptionMenu</a> *option_menu,
 
84
                                             <a href="libgimpwidgets-gimpoldwidgets.html#GimpOptionMenuSensitivityCallback">GimpOptionMenuSensitivityCallback</a> callback,
 
85
                                             gpointer callback_data);
 
86
void        <a href="libgimpwidgets-gimpoldwidgets.html#gimp-menu-item-update">gimp_menu_item_update</a>           (<a
 
87
href="../gtk/GtkWidget.html"
 
88
>GtkWidget</a> *widget,
 
89
                                             gpointer data);
 
90
</pre>
 
91
</div>
 
92
<div class="refsect1" lang="en">
 
93
<a name="id2592093"></a><h2>Description</h2>
 
94
<p>
 
95
These functions are not defined if you <span class="type">define</span> GIMP_DISABLE_DEPRECATED.
 
96
</p>
 
97
</div>
 
98
<div class="refsect1" lang="en">
 
99
<a name="id2592110"></a><h2>Details</h2>
 
100
<div class="refsect2" lang="en">
 
101
<a name="id2592117"></a><h3>
 
102
<a name="gimp-int-option-menu-new"></a>gimp_int_option_menu_new ()</h3>
 
103
<a class="indexterm" name="id2592126"></a><pre class="programlisting"><a
 
104
href="../gtk/GtkWidget.html"
 
105
>GtkWidget</a>*  gimp_int_option_menu_new        (gboolean menu_only,
 
106
                                             GCallback menu_item_callback,
 
107
                                             gpointer menu_item_callback_data,
 
108
                                             gint initial,
 
109
                                             ...);</pre>
 
110
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
111
<h3 class="title">Warning</h3>
 
112
<p><code class="literal">gimp_int_option_menu_new</code> is deprecated and should not be used in newly-written code.</p>
 
113
</div>
 
114
<p>
 
115
Convenience function to create a <a
 
116
href="../gtk/GtkOptionMenu.html"
 
117
><span class="type">GtkOptionMenu</span></a> or a <a
 
118
href="../gtk/GtkMenu.html"
 
119
><span class="type">GtkMenu</span></a>. This
 
120
function does the same thing as the deprecated function
 
121
<a href="libgimpwidgets-gimpoldwidgets.html#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>
 
122
instead of pointers, since that is a very common case (mapping an
 
123
enum to a menu).</p>
 
124
<p>
 
125
 
 
126
</p>
 
127
<div class="variablelist"><table border="0">
 
128
<col align="left" valign="top">
 
129
<tbody>
 
130
<tr>
 
131
<td>
 
132
<span class="term"><em class="parameter"><code>menu_only</code></em>&#160;:</span></td>
 
133
<td>          <code class="literal">TRUE</code> if the function should return a <a
 
134
href="../gtk/GtkMenu.html"
 
135
><span class="type">GtkMenu</span></a> only.
 
136
</td>
 
137
</tr>
 
138
<tr>
 
139
<td>
 
140
<span class="term"><em class="parameter"><code>menu_item_callback</code></em>&#160;:</span></td>
 
141
<td> The callback each menu item's "activate" signal will
 
142
                     be connected with.
 
143
</td>
 
144
</tr>
 
145
<tr>
 
146
<td>
 
147
<span class="term"><em class="parameter"><code>menu_item_callback_data</code></em>&#160;:</span></td>
 
148
<td>
 
149
                     The data which will be passed to <code class="function">g_signal_connect()</code>.
 
150
</td>
 
151
</tr>
 
152
<tr>
 
153
<td>
 
154
<span class="term"><em class="parameter"><code>initial</code></em>&#160;:</span></td>
 
155
<td>            The <em class="parameter"><code>item_data</code></em> of the initially selected menu item.
 
156
</td>
 
157
</tr>
 
158
<tr>
 
159
<td>
 
160
<span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
 
161
<td>                A <code class="literal">NULL</code>-terminated <em class="parameter"><code>va_list</code></em> describing the menu items.
 
162
</td>
 
163
</tr>
 
164
<tr>
 
165
<td>
 
166
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
167
<td> A <a
 
168
href="../gtk/GtkOptionMenu.html"
 
169
><span class="type">GtkOptionMenu</span></a> or a <a
 
170
href="../gtk/GtkMenu.html"
 
171
><span class="type">GtkMenu</span></a> (depending on <em class="parameter"><code>menu_only</code></em>).
 
172
</td>
 
173
</tr>
 
174
</tbody>
 
175
</table></div>
 
176
</div>
 
177
<hr>
 
178
<div class="refsect2" lang="en">
 
179
<a name="id2587973"></a><h3>
 
180
<a name="gimp-int-option-menu-set-history"></a>gimp_int_option_menu_set_history ()</h3>
 
181
<a class="indexterm" name="id2587982"></a><pre class="programlisting">void        gimp_int_option_menu_set_history
 
182
                                            (<a
 
183
href="../gtk/GtkOptionMenu.html"
 
184
>GtkOptionMenu</a> *option_menu,
 
185
                                             gint item_data);</pre>
 
186
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
187
<h3 class="title">Warning</h3>
 
188
<p><code class="literal">gimp_int_option_menu_set_history</code> is deprecated and should not be used in newly-written code.</p>
 
189
</div>
 
190
<p>
 
191
Iterates over all entries in a <a
 
192
href="../gtk/GtkOptionMenu.html"
 
193
><span class="type">GtkOptionMenu</span></a> and selects the one with the
 
194
matching <em class="parameter"><code>item_data</code></em>. Probably only makes sense to use with a <a
 
195
href="../gtk/GtkOptionMenu.html"
 
196
><span class="type">GtkOptionMenu</span></a>
 
197
that was created using <a href="libgimpwidgets-gimpoldwidgets.html#gimp-int-option-menu-new"><code class="function">gimp_int_option_menu_new()</code></a>. This function does the
 
198
same thing as <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-set-history"><code class="function">gimp_option_menu_set_history()</code></a>, but takes integers as
 
199
<em class="parameter"><code>item_data</code></em> instead of pointers.</p>
 
200
<p>
 
201
 
 
202
</p>
 
203
<div class="variablelist"><table border="0">
 
204
<col align="left" valign="top">
 
205
<tbody>
 
206
<tr>
 
207
<td>
 
208
<span class="term"><em class="parameter"><code>option_menu</code></em>&#160;:</span></td>
 
209
<td> A <a
 
210
href="../gtk/GtkOptionMenu.html"
 
211
><span class="type">GtkOptionMenu</span></a> as returned by <a href="libgimpwidgets-gimpoldwidgets.html#gimp-int-option-menu-new"><code class="function">gimp_int_option_menu_new()</code></a>.
 
212
</td>
 
213
</tr>
 
214
<tr>
 
215
<td>
 
216
<span class="term"><em class="parameter"><code>item_data</code></em>&#160;:</span></td>
 
217
<td>   The <em class="parameter"><code>item_data</code></em> of the menu item you want to select.
 
218
</td>
 
219
</tr>
 
220
</tbody>
 
221
</table></div>
 
222
</div>
 
223
<hr>
 
224
<div class="refsect2" lang="en">
 
225
<a name="id2588136"></a><h3>
 
226
<a name="GimpIntOptionMenuSensitivityCallback"></a>GimpIntOptionMenuSensitivityCallback ()</h3>
 
227
<a class="indexterm" name="id2588148"></a><pre class="programlisting">gboolean    (*GimpIntOptionMenuSensitivityCallback)
 
228
                                            (gint item_data,
 
229
                                             gpointer callback_data);</pre>
 
230
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
231
<h3 class="title">Warning</h3>
 
232
<p><code class="literal">GimpIntOptionMenuSensitivityCallback</code> is deprecated and should not be used in newly-written code.</p>
 
233
</div>
 
234
<p>
 
235
 
 
236
</p>
 
237
<div class="variablelist"><table border="0">
 
238
<col align="left" valign="top">
 
239
<tbody>
 
240
<tr>
 
241
<td>
 
242
<span class="term"><em class="parameter"><code>item_data</code></em>&#160;:</span></td>
 
243
<td>
 
244
</td>
 
245
</tr>
 
246
<tr>
 
247
<td>
 
248
<span class="term"><em class="parameter"><code>callback_data</code></em>&#160;:</span></td>
 
249
<td>
 
250
</td>
 
251
</tr>
 
252
<tr>
 
253
<td>
 
254
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
255
<td>
 
256
 
 
257
 
 
258
</td>
 
259
</tr>
 
260
</tbody>
 
261
</table></div>
 
262
</div>
 
263
<hr>
 
264
<div class="refsect2" lang="en">
 
265
<a name="id2588240"></a><h3>
 
266
<a name="gimp-int-option-menu-set-sensitive"></a>gimp_int_option_menu_set_sensitive ()</h3>
 
267
<a class="indexterm" name="id2588252"></a><pre class="programlisting">void        gimp_int_option_menu_set_sensitive
 
268
                                            (<a
 
269
href="../gtk/GtkOptionMenu.html"
 
270
>GtkOptionMenu</a> *option_menu,
 
271
                                             <a href="libgimpwidgets-gimpoldwidgets.html#GimpIntOptionMenuSensitivityCallback">GimpIntOptionMenuSensitivityCallback</a> callback,
 
272
                                             gpointer callback_data);</pre>
 
273
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
274
<h3 class="title">Warning</h3>
 
275
<p><code class="literal">gimp_int_option_menu_set_sensitive</code> is deprecated and should not be used in newly-written code.</p>
 
276
</div>
 
277
<p>
 
278
Calls the given <em class="parameter"><code>callback</code></em> for each item in the menu and passes it the
 
279
item_data and the <em class="parameter"><code>callback_data</code></em>. The menu item's sensitivity is set
 
280
according to the return value of this function. This function does the
 
281
same thing as <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-set-sensitive"><code class="function">gimp_option_menu_set_sensitive()</code></a>, but takes integers as
 
282
<em class="parameter"><code>item_data</code></em> instead of pointers.</p>
 
283
<p>
 
284
 
 
285
</p>
 
286
<div class="variablelist"><table border="0">
 
287
<col align="left" valign="top">
 
288
<tbody>
 
289
<tr>
 
290
<td>
 
291
<span class="term"><em class="parameter"><code>option_menu</code></em>&#160;:</span></td>
 
292
<td> a <a
 
293
href="../gtk/GtkOptionMenu.html"
 
294
><span class="type">GtkOptionMenu</span></a> as returned by <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new"><code class="function">gimp_option_menu_new()</code></a> or
 
295
           <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2"><code class="function">gimp_option_menu_new2()</code></a>.
 
296
</td>
 
297
</tr>
 
298
<tr>
 
299
<td>
 
300
<span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
301
<td> a function called for each item in the menu to determine the
 
302
           the sensitivity state.
 
303
</td>
 
304
</tr>
 
305
<tr>
 
306
<td>
 
307
<span class="term"><em class="parameter"><code>callback_data</code></em>&#160;:</span></td>
 
308
<td> data to pass to the <em class="parameter"><code>callback</code></em> function.
 
309
</td>
 
310
</tr>
 
311
</tbody>
 
312
</table></div>
 
313
</div>
 
314
<hr>
 
315
<div class="refsect2" lang="en">
 
316
<a name="id2588422"></a><h3>
 
317
<a name="gimp-option-menu-new"></a>gimp_option_menu_new ()</h3>
 
318
<a class="indexterm" name="id2588431"></a><pre class="programlisting"><a
 
319
href="../gtk/GtkWidget.html"
 
320
>GtkWidget</a>*  gimp_option_menu_new            (gboolean menu_only,
 
321
                                             ...);</pre>
 
322
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
323
<h3 class="title">Warning</h3>
 
324
<p><code class="literal">gimp_option_menu_new</code> is deprecated and should not be used in newly-written code.</p>
 
325
</div>
 
326
<p>
 
327
Convenience function to create a <a
 
328
href="../gtk/GtkOptionMenu.html"
 
329
><span class="type">GtkOptionMenu</span></a> or a <a
 
330
href="../gtk/GtkMenu.html"
 
331
><span class="type">GtkMenu</span></a>.</p>
 
332
<p>
 
333
 
 
334
</p>
 
335
<div class="variablelist"><table border="0">
 
336
<col align="left" valign="top">
 
337
<tbody>
 
338
<tr>
 
339
<td>
 
340
<span class="term"><em class="parameter"><code>menu_only</code></em>&#160;:</span></td>
 
341
<td> <code class="literal">TRUE</code> if the function should return a <a
 
342
href="../gtk/GtkMenu.html"
 
343
><span class="type">GtkMenu</span></a> only.
 
344
</td>
 
345
</tr>
 
346
<tr>
 
347
<td>
 
348
<span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
 
349
<td>       A <code class="literal">NULL</code>-terminated <em class="parameter"><code>va_list</code></em> describing the menu items.
 
350
</td>
 
351
</tr>
 
352
<tr>
 
353
<td>
 
354
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
355
<td> A <a
 
356
href="../gtk/GtkOptionMenu.html"
 
357
><span class="type">GtkOptionMenu</span></a> or a <a
 
358
href="../gtk/GtkMenu.html"
 
359
><span class="type">GtkMenu</span></a> (depending on <em class="parameter"><code>menu_only</code></em>).
 
360
</td>
 
361
</tr>
 
362
</tbody>
 
363
</table></div>
 
364
</div>
 
365
<hr>
 
366
<div class="refsect2" lang="en">
 
367
<a name="id2591367"></a><h3>
 
368
<a name="gimp-option-menu-new2"></a>gimp_option_menu_new2 ()</h3>
 
369
<a class="indexterm" name="id2591376"></a><pre class="programlisting"><a
 
370
href="../gtk/GtkWidget.html"
 
371
>GtkWidget</a>*  gimp_option_menu_new2           (gboolean menu_only,
 
372
                                             GCallback menu_item_callback,
 
373
                                             gpointer menu_item_callback_data,
 
374
                                             gpointer initial,
 
375
                                             ...);</pre>
 
376
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
377
<h3 class="title">Warning</h3>
 
378
<p><code class="literal">gimp_option_menu_new2</code> is deprecated and should not be used in newly-written code.</p>
 
379
</div>
 
380
<p>
 
381
Convenience function to create a <a
 
382
href="../gtk/GtkOptionMenu.html"
 
383
><span class="type">GtkOptionMenu</span></a> or a <a
 
384
href="../gtk/GtkMenu.html"
 
385
><span class="type">GtkMenu</span></a>.</p>
 
386
<p>
 
387
 
 
388
</p>
 
389
<div class="variablelist"><table border="0">
 
390
<col align="left" valign="top">
 
391
<tbody>
 
392
<tr>
 
393
<td>
 
394
<span class="term"><em class="parameter"><code>menu_only</code></em>&#160;:</span></td>
 
395
<td>          <code class="literal">TRUE</code> if the function should return a <a
 
396
href="../gtk/GtkMenu.html"
 
397
><span class="type">GtkMenu</span></a> only.
 
398
</td>
 
399
</tr>
 
400
<tr>
 
401
<td>
 
402
<span class="term"><em class="parameter"><code>menu_item_callback</code></em>&#160;:</span></td>
 
403
<td> The callback each menu item's "activate" signal will
 
404
                     be connected with.
 
405
</td>
 
406
</tr>
 
407
<tr>
 
408
<td>
 
409
<span class="term"><em class="parameter"><code>menu_item_callback_data</code></em>&#160;:</span></td>
 
410
<td>
 
411
                     The data which will be passed to <code class="function">g_signal_connect()</code>.
 
412
</td>
 
413
</tr>
 
414
<tr>
 
415
<td>
 
416
<span class="term"><em class="parameter"><code>initial</code></em>&#160;:</span></td>
 
417
<td>            The <em class="parameter"><code>item_data</code></em> of the initially selected menu item.
 
418
</td>
 
419
</tr>
 
420
<tr>
 
421
<td>
 
422
<span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
 
423
<td>                A <code class="literal">NULL</code>-terminated <em class="parameter"><code>va_list</code></em> describing the menu items.
 
424
</td>
 
425
</tr>
 
426
<tr>
 
427
<td>
 
428
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
429
<td> A <a
 
430
href="../gtk/GtkOptionMenu.html"
 
431
><span class="type">GtkOptionMenu</span></a> or a <a
 
432
href="../gtk/GtkMenu.html"
 
433
><span class="type">GtkMenu</span></a> (depending on <em class="parameter"><code>menu_only</code></em>).
 
434
</td>
 
435
</tr>
 
436
</tbody>
 
437
</table></div>
 
438
</div>
 
439
<hr>
 
440
<div class="refsect2" lang="en">
 
441
<a name="id2591607"></a><h3>
 
442
<a name="gimp-option-menu-set-history"></a>gimp_option_menu_set_history ()</h3>
 
443
<a class="indexterm" name="id2591618"></a><pre class="programlisting">void        gimp_option_menu_set_history    (<a
 
444
href="../gtk/GtkOptionMenu.html"
 
445
>GtkOptionMenu</a> *option_menu,
 
446
                                             gpointer item_data);</pre>
 
447
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
448
<h3 class="title">Warning</h3>
 
449
<p><code class="literal">gimp_option_menu_set_history</code> is deprecated and should not be used in newly-written code.</p>
 
450
</div>
 
451
<p>
 
452
Iterates over all entries in a <a
 
453
href="../gtk/GtkOptionMenu.html"
 
454
><span class="type">GtkOptionMenu</span></a> and selects the one
 
455
with the matching <em class="parameter"><code>item_data</code></em>. Probably only makes sense to use with
 
456
a <a
 
457
href="../gtk/GtkOptionMenu.html"
 
458
><span class="type">GtkOptionMenu</span></a> that was created using <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new"><code class="function">gimp_option_menu_new()</code></a> or
 
459
<a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2"><code class="function">gimp_option_menu_new2()</code></a>.</p>
 
460
<p>
 
461
 
 
462
</p>
 
463
<div class="variablelist"><table border="0">
 
464
<col align="left" valign="top">
 
465
<tbody>
 
466
<tr>
 
467
<td>
 
468
<span class="term"><em class="parameter"><code>option_menu</code></em>&#160;:</span></td>
 
469
<td> A <a
 
470
href="../gtk/GtkOptionMenu.html"
 
471
><span class="type">GtkOptionMenu</span></a> as returned by <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new"><code class="function">gimp_option_menu_new()</code></a> or
 
472
              <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2"><code class="function">gimp_option_menu_new2()</code></a>.
 
473
</td>
 
474
</tr>
 
475
<tr>
 
476
<td>
 
477
<span class="term"><em class="parameter"><code>item_data</code></em>&#160;:</span></td>
 
478
<td>   The <em class="parameter"><code>item_data</code></em> of the menu item you want to select.
 
479
</td>
 
480
</tr>
 
481
</tbody>
 
482
</table></div>
 
483
</div>
 
484
<hr>
 
485
<div class="refsect2" lang="en">
 
486
<a name="id2591774"></a><h3>
 
487
<a name="GimpOptionMenuSensitivityCallback"></a>GimpOptionMenuSensitivityCallback ()</h3>
 
488
<a class="indexterm" name="id2591786"></a><pre class="programlisting">gboolean    (*GimpOptionMenuSensitivityCallback)
 
489
                                            (gpointer item_data,
 
490
                                             gpointer callback_data);</pre>
 
491
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
492
<h3 class="title">Warning</h3>
 
493
<p><code class="literal">GimpOptionMenuSensitivityCallback</code> is deprecated and should not be used in newly-written code.</p>
 
494
</div>
 
495
<p>
 
496
 
 
497
</p>
 
498
<div class="variablelist"><table border="0">
 
499
<col align="left" valign="top">
 
500
<tbody>
 
501
<tr>
 
502
<td>
 
503
<span class="term"><em class="parameter"><code>item_data</code></em>&#160;:</span></td>
 
504
<td>
 
505
</td>
 
506
</tr>
 
507
<tr>
 
508
<td>
 
509
<span class="term"><em class="parameter"><code>callback_data</code></em>&#160;:</span></td>
 
510
<td>
 
511
</td>
 
512
</tr>
 
513
<tr>
 
514
<td>
 
515
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
516
<td>
 
517
 
 
518
 
 
519
</td>
 
520
</tr>
 
521
</tbody>
 
522
</table></div>
 
523
</div>
 
524
<hr>
 
525
<div class="refsect2" lang="en">
 
526
<a name="id2591877"></a><h3>
 
527
<a name="gimp-option-menu-set-sensitive"></a>gimp_option_menu_set_sensitive ()</h3>
 
528
<a class="indexterm" name="id2597476"></a><pre class="programlisting">void        gimp_option_menu_set_sensitive  (<a
 
529
href="../gtk/GtkOptionMenu.html"
 
530
>GtkOptionMenu</a> *option_menu,
 
531
                                             <a href="libgimpwidgets-gimpoldwidgets.html#GimpOptionMenuSensitivityCallback">GimpOptionMenuSensitivityCallback</a> callback,
 
532
                                             gpointer callback_data);</pre>
 
533
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
534
<h3 class="title">Warning</h3>
 
535
<p><code class="literal">gimp_option_menu_set_sensitive</code> is deprecated and should not be used in newly-written code.</p>
 
536
</div>
 
537
<p>
 
538
Calls the given <em class="parameter"><code>callback</code></em> for each item in the menu and passes it the
 
539
item_data and the <em class="parameter"><code>callback_data</code></em>. The menu item's sensitivity is set
 
540
according to the return value of this function.</p>
 
541
<p>
 
542
 
 
543
</p>
 
544
<div class="variablelist"><table border="0">
 
545
<col align="left" valign="top">
 
546
<tbody>
 
547
<tr>
 
548
<td>
 
549
<span class="term"><em class="parameter"><code>option_menu</code></em>&#160;:</span></td>
 
550
<td> a <a
 
551
href="../gtk/GtkOptionMenu.html"
 
552
><span class="type">GtkOptionMenu</span></a> as returned by <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new"><code class="function">gimp_option_menu_new()</code></a> or
 
553
           <a href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2"><code class="function">gimp_option_menu_new2()</code></a>.
 
554
</td>
 
555
</tr>
 
556
<tr>
 
557
<td>
 
558
<span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
559
<td> a function called for each item in the menu to determine the
 
560
           the sensitivity state.
 
561
</td>
 
562
</tr>
 
563
<tr>
 
564
<td>
 
565
<span class="term"><em class="parameter"><code>callback_data</code></em>&#160;:</span></td>
 
566
<td> data to pass to the <em class="parameter"><code>callback</code></em> function.
 
567
</td>
 
568
</tr>
 
569
</tbody>
 
570
</table></div>
 
571
</div>
 
572
<hr>
 
573
<div class="refsect2" lang="en">
 
574
<a name="id2597629"></a><h3>
 
575
<a name="gimp-menu-item-update"></a>gimp_menu_item_update ()</h3>
 
576
<a class="indexterm" name="id2597638"></a><pre class="programlisting">void        gimp_menu_item_update           (<a
 
577
href="../gtk/GtkWidget.html"
 
578
>GtkWidget</a> *widget,
 
579
                                             gpointer data);</pre>
 
580
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
581
<h3 class="title">Warning</h3>
 
582
<p><code class="literal">gimp_menu_item_update</code> is deprecated and should not be used in newly-written code.</p>
 
583
</div>
 
584
<p>
 
585
</p>
 
586
<p>
 
587
 
 
588
</p>
 
589
<div class="variablelist"><table border="0">
 
590
<col align="left" valign="top">
 
591
<tbody>
 
592
<tr>
 
593
<td>
 
594
<span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
595
<td> A <a
 
596
href="../gtk/GtkMenuItem.html"
 
597
><span class="type">GtkMenuItem</span></a>.
 
598
</td>
 
599
</tr>
 
600
<tr>
 
601
<td>
 
602
<span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
 
603
<td>   A pointer to a <span class="type">gint</span> variable which will store the value of
 
604
         GPOINTER_TO_INT (g_object_get_data (<em class="parameter"><code>widget</code></em>, "gimp-item-data")).
 
605
</td>
 
606
</tr>
 
607
</tbody>
 
608
</table></div>
 
609
</div>
 
610
</div>
 
611
<div class="refsect1" lang="en">
 
612
<a name="id2597744"></a><h2>See Also</h2>
 
613
<p>
 
614
GimpIntComboBox
 
615
</p>
 
616
</div>
 
617
</div>
 
618
<table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle">
 
619
<td align="left"><a accesskey="p" href="libgimpwidgets-deprecated.html"><b>&lt;&lt;&#160;Part&#160;VI.&#160;Deprecated API</b></a></td>
 
620
<td align="right"></td>
 
621
</tr></table>
 
622
</body>
 
623
</html>