← Back to branch summary

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

« back to all changes in this revision

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

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

Show diffs side-by-side

added added

removed removed

Lines of Context:
devel-docs/libgimpwidgets/html/libgimpwidgets-gimpoldwidgets.html
49
49
<div class="refsynopsisdiv">
50
50
<a name="libgimpwidgets-gimpoldwidgets.synopsis"></a><h2>Synopsis</h2>
51
51
<pre class="synopsis">
52
 
<a
53
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
54
 
>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
55
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
56
 
>gboolean</a> menu_only,
57
 
                                                         <a
58
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
59
 
>GCallback</a> menu_item_callback,
60
 
                                                         <a
61
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
62
 
>gpointer</a> menu_item_callback_data,
63
 
                                                         <a
64
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
65
 
>gint</a> initial,
 
52
GtkWidget*          <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-int-option-menu-new" title="gimp_int_option_menu_new ()">gimp_int_option_menu_new</a>            (gboolean menu_only,
 
53
                                                         GCallback menu_item_callback,
 
54
                                                         gpointer menu_item_callback_data,
 
55
                                                         gint initial,
66
56
                                                         ...);
67
 
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
68
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
69
 
>GtkOptionMenu</a> *option_menu,
70
 
                                                         <a
71
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
72
 
>gint</a> item_data);
73
 
<a
74
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
75
 
>gboolean</a>            (<a class="link" href="libgimpwidgets-gimpoldwidgets.html#GimpIntOptionMenuSensitivityCallback" title="GimpIntOptionMenuSensitivityCallback ()">*GimpIntOptionMenuSensitivityCallback</a>)
76
 
                                                        (<a
77
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
78
 
>gint</a> item_data,
79
 
                                                         <a
80
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
81
 
>gpointer</a> callback_data);
82
 
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
83
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
84
 
>GtkOptionMenu</a> *option_menu,
 
57
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>    (GtkOptionMenu *option_menu,
 
58
                                                         gint item_data);
 
59
gboolean            (<a class="link" href="libgimpwidgets-gimpoldwidgets.html#GimpIntOptionMenuSensitivityCallback" title="GimpIntOptionMenuSensitivityCallback ()">*GimpIntOptionMenuSensitivityCallback</a>)
 
60
                                                        (gint item_data,
 
61
                                                         gpointer callback_data);
 
62
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>  (GtkOptionMenu *option_menu,
85
63
                                                         <a class="link" href="libgimpwidgets-gimpoldwidgets.html#GimpIntOptionMenuSensitivityCallback" title="GimpIntOptionMenuSensitivityCallback ()">GimpIntOptionMenuSensitivityCallback</a> callback,
86
 
                                                         <a
87
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
88
 
>gpointer</a> callback_data);
89
 
<a
90
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
91
 
>GtkWidget</a>*          <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new" title="gimp_option_menu_new ()">gimp_option_menu_new</a>                (<a
92
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
93
 
>gboolean</a> menu_only,
94
 
                                                         ...);
95
 
<a
96
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
97
 
>GtkWidget</a>*          <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2" title="gimp_option_menu_new2 ()">gimp_option_menu_new2</a>               (<a
98
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
99
 
>gboolean</a> menu_only,
100
 
                                                         <a
101
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
102
 
>GCallback</a> menu_item_callback,
103
 
                                                         <a
104
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
105
 
>gpointer</a> menu_item_callback_data,
106
 
                                                         <a
107
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
108
 
>gpointer</a> initial,
109
 
                                                         ...);
110
 
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
111
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
112
 
>GtkOptionMenu</a> *option_menu,
113
 
                                                         <a
114
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
115
 
>gpointer</a> item_data);
116
 
<a
117
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
118
 
>gboolean</a>            (<a class="link" href="libgimpwidgets-gimpoldwidgets.html#GimpOptionMenuSensitivityCallback" title="GimpOptionMenuSensitivityCallback ()">*GimpOptionMenuSensitivityCallback</a>)
119
 
                                                        (<a
120
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
121
 
>gpointer</a> item_data,
122
 
                                                         <a
123
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
124
 
>gpointer</a> callback_data);
125
 
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
126
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
127
 
>GtkOptionMenu</a> *option_menu,
 
64
                                                         gpointer callback_data);
 
65
GtkWidget*          <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new" title="gimp_option_menu_new ()">gimp_option_menu_new</a>                (gboolean menu_only,
 
66
                                                         ...);
 
67
GtkWidget*          <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-option-menu-new2" title="gimp_option_menu_new2 ()">gimp_option_menu_new2</a>               (gboolean menu_only,
 
68
                                                         GCallback menu_item_callback,
 
69
                                                         gpointer menu_item_callback_data,
 
70
                                                         gpointer initial,
 
71
                                                         ...);
 
72
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>        (GtkOptionMenu *option_menu,
 
73
                                                         gpointer item_data);
 
74
gboolean            (<a class="link" href="libgimpwidgets-gimpoldwidgets.html#GimpOptionMenuSensitivityCallback" title="GimpOptionMenuSensitivityCallback ()">*GimpOptionMenuSensitivityCallback</a>)
 
75
                                                        (gpointer item_data,
 
76
                                                         gpointer callback_data);
 
77
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>      (GtkOptionMenu *option_menu,
128
78
                                                         <a class="link" href="libgimpwidgets-gimpoldwidgets.html#GimpOptionMenuSensitivityCallback" title="GimpOptionMenuSensitivityCallback ()">GimpOptionMenuSensitivityCallback</a> callback,
129
 
                                                         <a
130
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
131
 
>gpointer</a> callback_data);
132
 
void                <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-menu-item-update" title="gimp_menu_item_update ()">gimp_menu_item_update</a>               (<a
133
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
134
 
>GtkWidget</a> *widget,
135
 
                                                         <a
136
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
137
 
>gpointer</a> data);
 
79
                                                         gpointer callback_data);
 
80
void                <a class="link" href="libgimpwidgets-gimpoldwidgets.html#gimp-menu-item-update" title="gimp_menu_item_update ()">gimp_menu_item_update</a>               (GtkWidget *widget,
 
81
                                                         gpointer data);
138
82
</pre>
139
83
</div>
140
84
<div class="refsect1" lang="en">
147
91
<a name="libgimpwidgets-gimpoldwidgets.details"></a><h2>Details</h2>
148
92
<div class="refsect2" lang="en">
149
93
<a name="gimp-int-option-menu-new"></a><h3>gimp_int_option_menu_new ()</h3>
150
 
<pre class="programlisting"><a
151
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
152
 
>GtkWidget</a>*          gimp_int_option_menu_new            (<a
153
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
154
 
>gboolean</a> menu_only,
155
 
                                                         <a
156
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
157
 
>GCallback</a> menu_item_callback,
158
 
                                                         <a
159
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
160
 
>gpointer</a> menu_item_callback_data,
161
 
                                                         <a
162
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
163
 
>gint</a> initial,
 
94
<pre class="programlisting">GtkWidget*          gimp_int_option_menu_new            (gboolean menu_only,
 
95
                                                         GCallback menu_item_callback,
 
96
                                                         gpointer menu_item_callback_data,
 
97
                                                         gint initial,
164
98
                                                         ...);</pre>
165
99
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
166
100
<h3 class="title">Warning</h3>
167
101
<p><code class="literal">gimp_int_option_menu_new</code> is deprecated and should not be used in newly-written code.</p>
168
102
</div>
169
103
<p>
170
 
Convenience function to create a <a
171
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
172
 
><span class="type">GtkOptionMenu</span></a> or a <a
173
 
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
174
 
><span class="type">GtkMenu</span></a>. This
 
104
Convenience function to create a <span class="type">GtkOptionMenu</span> or a <span class="type">GtkMenu</span>. This
175
105
function does the same thing as the deprecated function
176
106
<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>
177
107
instead of pointers, since that is a very common case (mapping an
184
114
<tbody>
185
115
<tr>
186
116
<td><p><span class="term"><em class="parameter"><code>menu_only</code></em> :</span></p></td>
187
 
<td>          <a
188
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
189
 
><code class="literal">TRUE</code></a> if the function should return a <a
190
 
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
191
 
><span class="type">GtkMenu</span></a> only.
 
117
<td>          <code class="literal">TRUE</code> if the function should return a <span class="type">GtkMenu</span> only.
192
118
</td>
193
119
</tr>
194
120
<tr>
200
126
<tr>
201
127
<td><p><span class="term"><em class="parameter"><code>menu_item_callback_data</code></em> :</span></p></td>
202
128
<td>
203
 
                     The data which will be passed to <a
204
 
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect"
205
 
><code class="function">g_signal_connect()</code></a>.
 
129
                     The data which will be passed to <code class="function">g_signal_connect()</code>.
206
130
</td>
207
131
</tr>
208
132
<tr>
212
136
</tr>
213
137
<tr>
214
138
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
215
 
<td>                A <a
216
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
217
 
><code class="literal">NULL</code></a>-terminated <em class="parameter"><code>va_list</code></em> describing the menu items.
 
139
<td>                A <code class="literal">NULL</code>-terminated <em class="parameter"><code>va_list</code></em> describing the menu items.
218
140
</td>
219
141
</tr>
220
142
<tr>
221
143
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
222
 
<td> A <a
223
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
224
 
><span class="type">GtkOptionMenu</span></a> or a <a
225
 
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
226
 
><span class="type">GtkMenu</span></a> (depending on <em class="parameter"><code>menu_only</code></em>).
 
144
<td> A <span class="type">GtkOptionMenu</span> or a <span class="type">GtkMenu</span> (depending on <em class="parameter"><code>menu_only</code></em>).
227
145
</td>
228
146
</tr>
229
147
</tbody>
232
150
<hr>
233
151
<div class="refsect2" lang="en">
234
152
<a name="gimp-int-option-menu-set-history"></a><h3>gimp_int_option_menu_set_history ()</h3>
235
 
<pre class="programlisting">void                gimp_int_option_menu_set_history    (<a
236
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
237
 
>GtkOptionMenu</a> *option_menu,
238
 
                                                         <a
239
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
240
 
>gint</a> item_data);</pre>
 
153
<pre class="programlisting">void                gimp_int_option_menu_set_history    (GtkOptionMenu *option_menu,
 
154
                                                         gint item_data);</pre>
241
155
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
242
156
<h3 class="title">Warning</h3>
243
157
<p><code class="literal">gimp_int_option_menu_set_history</code> is deprecated and should not be used in newly-written code.</p>
244
158
</div>
245
159
<p>
246
 
Iterates over all entries in a <a
247
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
248
 
><span class="type">GtkOptionMenu</span></a> and selects the one with the
249
 
matching <em class="parameter"><code>item_data</code></em>. Probably only makes sense to use with a <a
250
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
251
 
><span class="type">GtkOptionMenu</span></a>
 
160
Iterates over all entries in a <span class="type">GtkOptionMenu</span> and selects the one with the
 
161
matching <em class="parameter"><code>item_data</code></em>. Probably only makes sense to use with a <span class="type">GtkOptionMenu</span>
252
162
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
253
163
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
254
164
<em class="parameter"><code>item_data</code></em> instead of pointers.</p>
260
170
<tbody>
261
171
<tr>
262
172
<td><p><span class="term"><em class="parameter"><code>option_menu</code></em> :</span></p></td>
263
 
<td> A <a
264
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
265
 
><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>.
 
173
<td> A <span class="type">GtkOptionMenu</span> 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>.
266
174
</td>
267
175
</tr>
268
176
<tr>
276
184
<hr>
277
185
<div class="refsect2" lang="en">
278
186
<a name="GimpIntOptionMenuSensitivityCallback"></a><h3>GimpIntOptionMenuSensitivityCallback ()</h3>
279
 
<pre class="programlisting"><a
280
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
281
 
>gboolean</a>            (*GimpIntOptionMenuSensitivityCallback)
282
 
                                                        (<a
283
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
284
 
>gint</a> item_data,
285
 
                                                         <a
286
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
287
 
>gpointer</a> callback_data);</pre>
 
187
<pre class="programlisting">gboolean            (*GimpIntOptionMenuSensitivityCallback)
 
188
                                                        (gint item_data,
 
189
                                                         gpointer callback_data);</pre>
288
190
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
289
191
<h3 class="title">Warning</h3>
290
192
<p><code class="literal">GimpIntOptionMenuSensitivityCallback</code> is deprecated and should not be used in newly-written code.</p>
318
220
<hr>
319
221
<div class="refsect2" lang="en">
320
222
<a name="gimp-int-option-menu-set-sensitive"></a><h3>gimp_int_option_menu_set_sensitive ()</h3>
321
 
<pre class="programlisting">void                gimp_int_option_menu_set_sensitive  (<a
322
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
323
 
>GtkOptionMenu</a> *option_menu,
 
223
<pre class="programlisting">void                gimp_int_option_menu_set_sensitive  (GtkOptionMenu *option_menu,
324
224
                                                         <a class="link" href="libgimpwidgets-gimpoldwidgets.html#GimpIntOptionMenuSensitivityCallback" title="GimpIntOptionMenuSensitivityCallback ()">GimpIntOptionMenuSensitivityCallback</a> callback,
325
 
                                                         <a
326
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
327
 
>gpointer</a> callback_data);</pre>
 
225
                                                         gpointer callback_data);</pre>
328
226
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
329
227
<h3 class="title">Warning</h3>
330
228
<p><code class="literal">gimp_int_option_menu_set_sensitive</code> is deprecated and should not be used in newly-written code.</p>
343
241
<tbody>
344
242
<tr>
345
243
<td><p><span class="term"><em class="parameter"><code>option_menu</code></em> :</span></p></td>
346
 
<td> a <a
347
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
348
 
><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
 
244
<td> a <span class="type">GtkOptionMenu</span> 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
349
245
           <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>.
350
246
</td>
351
247
</tr>
366
262
<hr>
367
263
<div class="refsect2" lang="en">
368
264
<a name="gimp-option-menu-new"></a><h3>gimp_option_menu_new ()</h3>
369
 
<pre class="programlisting"><a
370
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
371
 
>GtkWidget</a>*          gimp_option_menu_new                (<a
372
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
373
 
>gboolean</a> menu_only,
 
265
<pre class="programlisting">GtkWidget*          gimp_option_menu_new                (gboolean menu_only,
374
266
                                                         ...);</pre>
375
267
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
376
268
<h3 class="title">Warning</h3>
377
269
<p><code class="literal">gimp_option_menu_new</code> is deprecated and should not be used in newly-written code.</p>
378
270
</div>
379
271
<p>
380
 
Convenience function to create a <a
381
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
382
 
><span class="type">GtkOptionMenu</span></a> or a <a
383
 
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
384
 
><span class="type">GtkMenu</span></a>.</p>
 
272
Convenience function to create a <span class="type">GtkOptionMenu</span> or a <span class="type">GtkMenu</span>.</p>
385
273
<p>
386
274
 
387
275
</p>
390
278
<tbody>
391
279
<tr>
392
280
<td><p><span class="term"><em class="parameter"><code>menu_only</code></em> :</span></p></td>
393
 
<td> <a
394
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
395
 
><code class="literal">TRUE</code></a> if the function should return a <a
396
 
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
397
 
><span class="type">GtkMenu</span></a> only.
 
281
<td> <code class="literal">TRUE</code> if the function should return a <span class="type">GtkMenu</span> only.
398
282
</td>
399
283
</tr>
400
284
<tr>
401
285
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
402
 
<td>       A <a
403
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
404
 
><code class="literal">NULL</code></a>-terminated <em class="parameter"><code>va_list</code></em> describing the menu items.
 
286
<td>       A <code class="literal">NULL</code>-terminated <em class="parameter"><code>va_list</code></em> describing the menu items.
405
287
</td>
406
288
</tr>
407
289
<tr>
408
290
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
409
 
<td> A <a
410
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
411
 
><span class="type">GtkOptionMenu</span></a> or a <a
412
 
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
413
 
><span class="type">GtkMenu</span></a> (depending on <em class="parameter"><code>menu_only</code></em>).
 
291
<td> A <span class="type">GtkOptionMenu</span> or a <span class="type">GtkMenu</span> (depending on <em class="parameter"><code>menu_only</code></em>).
414
292
</td>
415
293
</tr>
416
294
</tbody>
419
297
<hr>
420
298
<div class="refsect2" lang="en">
421
299
<a name="gimp-option-menu-new2"></a><h3>gimp_option_menu_new2 ()</h3>
422
 
<pre class="programlisting"><a
423
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
424
 
>GtkWidget</a>*          gimp_option_menu_new2               (<a
425
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
426
 
>gboolean</a> menu_only,
427
 
                                                         <a
428
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
429
 
>GCallback</a> menu_item_callback,
430
 
                                                         <a
431
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
432
 
>gpointer</a> menu_item_callback_data,
433
 
                                                         <a
434
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
435
 
>gpointer</a> initial,
 
300
<pre class="programlisting">GtkWidget*          gimp_option_menu_new2               (gboolean menu_only,
 
301
                                                         GCallback menu_item_callback,
 
302
                                                         gpointer menu_item_callback_data,
 
303
                                                         gpointer initial,
436
304
                                                         ...);</pre>
437
305
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
438
306
<h3 class="title">Warning</h3>
439
307
<p><code class="literal">gimp_option_menu_new2</code> is deprecated and should not be used in newly-written code.</p>
440
308
</div>
441
309
<p>
442
 
Convenience function to create a <a
443
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
444
 
><span class="type">GtkOptionMenu</span></a> or a <a
445
 
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
446
 
><span class="type">GtkMenu</span></a>.</p>
 
310
Convenience function to create a <span class="type">GtkOptionMenu</span> or a <span class="type">GtkMenu</span>.</p>
447
311
<p>
448
312
 
449
313
</p>
452
316
<tbody>
453
317
<tr>
454
318
<td><p><span class="term"><em class="parameter"><code>menu_only</code></em> :</span></p></td>
455
 
<td>          <a
456
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
457
 
><code class="literal">TRUE</code></a> if the function should return a <a
458
 
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
459
 
><span class="type">GtkMenu</span></a> only.
 
319
<td>          <code class="literal">TRUE</code> if the function should return a <span class="type">GtkMenu</span> only.
460
320
</td>
461
321
</tr>
462
322
<tr>
468
328
<tr>
469
329
<td><p><span class="term"><em class="parameter"><code>menu_item_callback_data</code></em> :</span></p></td>
470
330
<td>
471
 
                     The data which will be passed to <a
472
 
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect"
473
 
><code class="function">g_signal_connect()</code></a>.
 
331
                     The data which will be passed to <code class="function">g_signal_connect()</code>.
474
332
</td>
475
333
</tr>
476
334
<tr>
480
338
</tr>
481
339
<tr>
482
340
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
483
 
<td>                A <a
484
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
485
 
><code class="literal">NULL</code></a>-terminated <em class="parameter"><code>va_list</code></em> describing the menu items.
 
341
<td>                A <code class="literal">NULL</code>-terminated <em class="parameter"><code>va_list</code></em> describing the menu items.
486
342
</td>
487
343
</tr>
488
344
<tr>
489
345
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
490
 
<td> A <a
491
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
492
 
><span class="type">GtkOptionMenu</span></a> or a <a
493
 
href="/usr/share/gtk-doc/html/gtk/GtkMenu.html"
494
 
><span class="type">GtkMenu</span></a> (depending on <em class="parameter"><code>menu_only</code></em>).
 
346
<td> A <span class="type">GtkOptionMenu</span> or a <span class="type">GtkMenu</span> (depending on <em class="parameter"><code>menu_only</code></em>).
495
347
</td>
496
348
</tr>
497
349
</tbody>
500
352
<hr>
501
353
<div class="refsect2" lang="en">
502
354
<a name="gimp-option-menu-set-history"></a><h3>gimp_option_menu_set_history ()</h3>
503
 
<pre class="programlisting">void                gimp_option_menu_set_history        (<a
504
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
505
 
>GtkOptionMenu</a> *option_menu,
506
 
                                                         <a
507
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
508
 
>gpointer</a> item_data);</pre>
 
355
<pre class="programlisting">void                gimp_option_menu_set_history        (GtkOptionMenu *option_menu,
 
356
                                                         gpointer item_data);</pre>
509
357
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
510
358
<h3 class="title">Warning</h3>
511
359
<p><code class="literal">gimp_option_menu_set_history</code> is deprecated and should not be used in newly-written code.</p>
512
360
</div>
513
361
<p>
514
 
Iterates over all entries in a <a
515
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
516
 
><span class="type">GtkOptionMenu</span></a> and selects the one
 
362
Iterates over all entries in a <span class="type">GtkOptionMenu</span> and selects the one
517
363
with the matching <em class="parameter"><code>item_data</code></em>. Probably only makes sense to use with
518
 
a <a
519
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
520
 
><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
 
364
a <span class="type">GtkOptionMenu</span> 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
521
365
<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>
522
366
<p>
523
367
 
527
371
<tbody>
528
372
<tr>
529
373
<td><p><span class="term"><em class="parameter"><code>option_menu</code></em> :</span></p></td>
530
 
<td> A <a
531
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
532
 
><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
 
374
<td> A <span class="type">GtkOptionMenu</span> 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
533
375
              <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>.
534
376
</td>
535
377
</tr>
544
386
<hr>
545
387
<div class="refsect2" lang="en">
546
388
<a name="GimpOptionMenuSensitivityCallback"></a><h3>GimpOptionMenuSensitivityCallback ()</h3>
547
 
<pre class="programlisting"><a
548
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
549
 
>gboolean</a>            (*GimpOptionMenuSensitivityCallback)
550
 
                                                        (<a
551
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
552
 
>gpointer</a> item_data,
553
 
                                                         <a
554
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
555
 
>gpointer</a> callback_data);</pre>
 
389
<pre class="programlisting">gboolean            (*GimpOptionMenuSensitivityCallback)
 
390
                                                        (gpointer item_data,
 
391
                                                         gpointer callback_data);</pre>
556
392
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
557
393
<h3 class="title">Warning</h3>
558
394
<p><code class="literal">GimpOptionMenuSensitivityCallback</code> is deprecated and should not be used in newly-written code.</p>
586
422
<hr>
587
423
<div class="refsect2" lang="en">
588
424
<a name="gimp-option-menu-set-sensitive"></a><h3>gimp_option_menu_set_sensitive ()</h3>
589
 
<pre class="programlisting">void                gimp_option_menu_set_sensitive      (<a
590
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
591
 
>GtkOptionMenu</a> *option_menu,
 
425
<pre class="programlisting">void                gimp_option_menu_set_sensitive      (GtkOptionMenu *option_menu,
592
426
                                                         <a class="link" href="libgimpwidgets-gimpoldwidgets.html#GimpOptionMenuSensitivityCallback" title="GimpOptionMenuSensitivityCallback ()">GimpOptionMenuSensitivityCallback</a> callback,
593
 
                                                         <a
594
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
595
 
>gpointer</a> callback_data);</pre>
 
427
                                                         gpointer callback_data);</pre>
596
428
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
597
429
<h3 class="title">Warning</h3>
598
430
<p><code class="literal">gimp_option_menu_set_sensitive</code> is deprecated and should not be used in newly-written code.</p>
609
441
<tbody>
610
442
<tr>
611
443
<td><p><span class="term"><em class="parameter"><code>option_menu</code></em> :</span></p></td>
612
 
<td> a <a
613
 
href="/usr/share/gtk-doc/html/gtk/GtkOptionMenu.html"
614
 
><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
 
444
<td> a <span class="type">GtkOptionMenu</span> 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
615
445
           <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>.
616
446
</td>
617
447
</tr>
632
462
<hr>
633
463
<div class="refsect2" lang="en">
634
464
<a name="gimp-menu-item-update"></a><h3>gimp_menu_item_update ()</h3>
635
 
<pre class="programlisting">void                gimp_menu_item_update               (<a
636
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
637
 
>GtkWidget</a> *widget,
638
 
                                                         <a
639
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
640
 
>gpointer</a> data);</pre>
 
465
<pre class="programlisting">void                gimp_menu_item_update               (GtkWidget *widget,
 
466
                                                         gpointer data);</pre>
641
467
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
642
468
<h3 class="title">Warning</h3>
643
469
<p><code class="literal">gimp_menu_item_update</code> is deprecated and should not be used in newly-written code.</p>
652
478
<tbody>
653
479
<tr>
654
480
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
655
 
<td> A <a
656
 
href="/usr/share/gtk-doc/html/gtk/GtkMenuItem.html"
657
 
><span class="type">GtkMenuItem</span></a>.
 
481
<td> A <span class="type">GtkMenuItem</span>.
658
482
</td>
659
483
</tr>
660
484
<tr>
661
485
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
662
 
<td>   A pointer to a <a
663
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
664
 
><span class="type">gint</span></a> variable which will store the value of
 
486
<td>   A pointer to a <span class="type">gint</span> variable which will store the value of
665
487
         GPOINTER_TO_INT (g_object_get_data (<em class="parameter"><code>widget</code></em>, "gimp-item-data")).
666
488
</td>
667
489
</tr>