13
13
<refname>gimpoldwidgets</refname>
14
14
<refpurpose>Old API that is still available but declared as deprecated.</refpurpose>
15
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
18
17
<refsynopsisdiv id="libgimpwidgets-gimpoldwidgets.synopsis" role="synopsis">
19
18
<title role="synopsis.title">Synopsis</title>
22
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-int-option-menu-new">gimp_int_option_menu_new</link> (<link linkend="gboolean">gboolean</link> menu_only,
21
<link linkend="GtkWidget">GtkWidget</link> * <link linkend="gimp-int-option-menu-new">gimp_int_option_menu_new</link> (<link linkend="gboolean">gboolean</link> menu_only,
23
22
<link linkend="GCallback">GCallback</link> menu_item_callback,
24
23
<link linkend="gpointer">gpointer</link> menu_item_callback_data,
25
24
<link linkend="gint">gint</link> initial,
32
31
<link linkend="void">void</link> <link linkend="gimp-int-option-menu-set-sensitive">gimp_int_option_menu_set_sensitive</link> (<link linkend="GtkOptionMenu">GtkOptionMenu</link> *option_menu,
33
32
<link linkend="GimpIntOptionMenuSensitivityCallback">GimpIntOptionMenuSensitivityCallback</link> callback,
34
33
<link linkend="gpointer">gpointer</link> callback_data);
35
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-option-menu-new">gimp_option_menu_new</link> (<link linkend="gboolean">gboolean</link> menu_only,
34
<link linkend="GtkWidget">GtkWidget</link> * <link linkend="gimp-option-menu-new">gimp_option_menu_new</link> (<link linkend="gboolean">gboolean</link> menu_only,
37
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-option-menu-new2">gimp_option_menu_new2</link> (<link linkend="gboolean">gboolean</link> menu_only,
36
<link linkend="GtkWidget">GtkWidget</link> * <link linkend="gimp-option-menu-new2">gimp_option_menu_new2</link> (<link linkend="gboolean">gboolean</link> menu_only,
38
37
<link linkend="GCallback">GCallback</link> menu_item_callback,
39
38
<link linkend="gpointer">gpointer</link> menu_item_callback_data,
40
39
<link linkend="gpointer">gpointer</link> initial,
71
70
<title role="details.title">Details</title>
72
71
<refsect2 id="gimp-int-option-menu-new" role="function" condition="deprecated:">
73
72
<title>gimp_int_option_menu_new ()</title>
74
<indexterm zone="gimp-int-option-menu-new" role="deprecated"><primary>gimp_int_option_menu_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_int_option_menu_new (<link linkend="gboolean">gboolean</link> menu_only,
73
<indexterm zone="gimp-int-option-menu-new" role="deprecated"><primary sortas="gimp_int_option_menu_new">gimp_int_option_menu_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> * gimp_int_option_menu_new (<link linkend="gboolean">gboolean</link> menu_only,
75
74
<link linkend="GCallback">GCallback</link> menu_item_callback,
76
75
<link linkend="gpointer">gpointer</link> menu_item_callback_data,
77
76
<link linkend="gint">gint</link> initial,
84
83
instead of pointers, since that is a very common case (mapping an
85
84
enum to a menu).</para>
88
86
</para><variablelist role="params">
89
<varlistentry><term><parameter>menu_only</parameter> :</term>
90
<listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the function should return a <link linkend="GtkMenu"><type>GtkMenu</type></link> only.
87
<varlistentry><term><parameter>menu_only</parameter> :</term>
88
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the function should return a <link linkend="GtkMenu"><type>GtkMenu</type></link> only.
91
89
</simpara></listitem></varlistentry>
92
<varlistentry><term><parameter>menu_item_callback</parameter> :</term>
90
<varlistentry><term><parameter>menu_item_callback</parameter> :</term>
93
91
<listitem><simpara> The callback each menu item's "activate" signal will
95
93
</simpara></listitem></varlistentry>
96
<varlistentry><term><parameter>menu_item_callback_data</parameter> :</term>
94
<varlistentry><term><parameter>menu_item_callback_data</parameter> :</term>
97
95
<listitem><simpara>
98
96
The data which will be passed to <link linkend="g-signal-connect"><function>g_signal_connect()</function></link>.
99
97
</simpara></listitem></varlistentry>
100
<varlistentry><term><parameter>initial</parameter> :</term>
98
<varlistentry><term><parameter>initial</parameter> :</term>
101
99
<listitem><simpara> The <parameter>item_data</parameter> of the initially selected menu item.
102
100
</simpara></listitem></varlistentry>
103
<varlistentry><term><parameter>...</parameter> :</term>
104
<listitem><simpara> A <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated <parameter>va_list</parameter> describing the menu items.
101
<varlistentry><term><parameter>...</parameter> :</term>
102
<listitem><simpara> A <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated <parameter>va_list</parameter> describing the menu items.
105
103
</simpara></listitem></varlistentry>
106
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> or a <link linkend="GtkMenu"><type>GtkMenu</type></link> (depending on <parameter>menu_only</parameter>).
104
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> or a <link linkend="GtkMenu"><type>GtkMenu</type></link> (depending on <parameter>menu_only</parameter>).
107
105
</simpara></listitem></varlistentry>
108
106
</variablelist></refsect2>
109
107
<refsect2 id="gimp-int-option-menu-set-history" role="function" condition="deprecated:">
110
108
<title>gimp_int_option_menu_set_history ()</title>
111
<indexterm zone="gimp-int-option-menu-set-history" role="deprecated"><primary>gimp_int_option_menu_set_history</primary></indexterm><programlisting><link linkend="void">void</link> gimp_int_option_menu_set_history (<link linkend="GtkOptionMenu">GtkOptionMenu</link> *option_menu,
109
<indexterm zone="gimp-int-option-menu-set-history" role="deprecated"><primary sortas="gimp_int_option_menu_set_history">gimp_int_option_menu_set_history</primary></indexterm><programlisting><link linkend="void">void</link> gimp_int_option_menu_set_history (<link linkend="GtkOptionMenu">GtkOptionMenu</link> *option_menu,
112
110
<link linkend="gint">gint</link> item_data);</programlisting>
113
111
<warning><para><literal>gimp_int_option_menu_set_history</literal> is deprecated and should not be used in newly-written code.</para></warning>
118
116
same thing as <link linkend="gimp-option-menu-set-history"><function>gimp_option_menu_set_history()</function></link>, but takes integers as
119
117
<parameter>item_data</parameter> instead of pointers.</para>
122
119
</para><variablelist role="params">
123
<varlistentry><term><parameter>option_menu</parameter> :</term>
120
<varlistentry><term><parameter>option_menu</parameter> :</term>
124
121
<listitem><simpara> A <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> as returned by <link linkend="gimp-int-option-menu-new"><function>gimp_int_option_menu_new()</function></link>.
125
122
</simpara></listitem></varlistentry>
126
<varlistentry><term><parameter>item_data</parameter> :</term>
123
<varlistentry><term><parameter>item_data</parameter> :</term>
127
124
<listitem><simpara> The <parameter>item_data</parameter> of the menu item you want to select.
128
125
</simpara></listitem></varlistentry>
129
126
</variablelist></refsect2>
130
127
<refsect2 id="GimpIntOptionMenuSensitivityCallback" role="function" condition="deprecated:">
131
128
<title>GimpIntOptionMenuSensitivityCallback ()</title>
132
<indexterm zone="GimpIntOptionMenuSensitivityCallback" role="deprecated"><primary>GimpIntOptionMenuSensitivityCallback</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> (*GimpIntOptionMenuSensitivityCallback)
129
<indexterm zone="GimpIntOptionMenuSensitivityCallback" role="deprecated"><primary sortas="GimpIntOptionMenuSensitivityCallback">GimpIntOptionMenuSensitivityCallback</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> (*GimpIntOptionMenuSensitivityCallback)
133
130
(<link linkend="gint">gint</link> item_data,
134
131
<link linkend="gpointer">gpointer</link> callback_data);</programlisting>
135
132
<warning><para><literal>GimpIntOptionMenuSensitivityCallback</literal> is deprecated and should not be used in newly-written code.</para></warning>
138
134
</para><variablelist role="params">
139
<varlistentry><term><parameter>item_data</parameter> :</term>
141
</simpara></listitem></varlistentry>
142
<varlistentry><term><parameter>callback_data</parameter> :</term>
144
</simpara></listitem></varlistentry>
145
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
135
<varlistentry><term><parameter>item_data</parameter> :</term>
137
</simpara></listitem></varlistentry>
138
<varlistentry><term><parameter>callback_data</parameter> :</term>
140
</simpara></listitem></varlistentry>
141
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
148
142
</simpara></listitem></varlistentry>
149
143
</variablelist></refsect2>
150
144
<refsect2 id="gimp-int-option-menu-set-sensitive" role="function" condition="deprecated:">
151
145
<title>gimp_int_option_menu_set_sensitive ()</title>
152
<indexterm zone="gimp-int-option-menu-set-sensitive" role="deprecated"><primary>gimp_int_option_menu_set_sensitive</primary></indexterm><programlisting><link linkend="void">void</link> gimp_int_option_menu_set_sensitive (<link linkend="GtkOptionMenu">GtkOptionMenu</link> *option_menu,
146
<indexterm zone="gimp-int-option-menu-set-sensitive" role="deprecated"><primary sortas="gimp_int_option_menu_set_sensitive">gimp_int_option_menu_set_sensitive</primary></indexterm><programlisting><link linkend="void">void</link> gimp_int_option_menu_set_sensitive (<link linkend="GtkOptionMenu">GtkOptionMenu</link> *option_menu,
153
147
<link linkend="GimpIntOptionMenuSensitivityCallback">GimpIntOptionMenuSensitivityCallback</link> callback,
154
148
<link linkend="gpointer">gpointer</link> callback_data);</programlisting>
155
149
<warning><para><literal>gimp_int_option_menu_set_sensitive</literal> is deprecated and should not be used in newly-written code.</para></warning>
160
154
same thing as <link linkend="gimp-option-menu-set-sensitive"><function>gimp_option_menu_set_sensitive()</function></link>, but takes integers as
161
155
<parameter>item_data</parameter> instead of pointers.</para>
164
157
</para><variablelist role="params">
165
<varlistentry><term><parameter>option_menu</parameter> :</term>
158
<varlistentry><term><parameter>option_menu</parameter> :</term>
166
159
<listitem><simpara> a <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> as returned by <link linkend="gimp-option-menu-new"><function>gimp_option_menu_new()</function></link> or
167
160
<link linkend="gimp-option-menu-new2"><function>gimp_option_menu_new2()</function></link>.
168
161
</simpara></listitem></varlistentry>
169
<varlistentry><term><parameter>callback</parameter> :</term>
162
<varlistentry><term><parameter>callback</parameter> :</term>
170
163
<listitem><simpara> a function called for each item in the menu to determine the
171
164
the sensitivity state.
172
165
</simpara></listitem></varlistentry>
173
<varlistentry><term><parameter>callback_data</parameter> :</term>
166
<varlistentry><term><parameter>callback_data</parameter> :</term>
174
167
<listitem><simpara> data to pass to the <parameter>callback</parameter> function.
175
168
</simpara></listitem></varlistentry>
176
169
</variablelist></refsect2>
177
170
<refsect2 id="gimp-option-menu-new" role="function" condition="deprecated:">
178
171
<title>gimp_option_menu_new ()</title>
179
<indexterm zone="gimp-option-menu-new" role="deprecated"><primary>gimp_option_menu_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_option_menu_new (<link linkend="gboolean">gboolean</link> menu_only,
172
<indexterm zone="gimp-option-menu-new" role="deprecated"><primary sortas="gimp_option_menu_new">gimp_option_menu_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> * gimp_option_menu_new (<link linkend="gboolean">gboolean</link> menu_only,
180
173
...);</programlisting>
181
174
<warning><para><literal>gimp_option_menu_new</literal> is deprecated and should not be used in newly-written code.</para></warning>
183
176
Convenience function to create a <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> or a <link linkend="GtkMenu"><type>GtkMenu</type></link>.</para>
186
178
</para><variablelist role="params">
187
<varlistentry><term><parameter>menu_only</parameter> :</term>
188
<listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the function should return a <link linkend="GtkMenu"><type>GtkMenu</type></link> only.
189
</simpara></listitem></varlistentry>
190
<varlistentry><term><parameter>...</parameter> :</term>
191
<listitem><simpara> A <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated <parameter>va_list</parameter> describing the menu items.
192
</simpara></listitem></varlistentry>
193
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> or a <link linkend="GtkMenu"><type>GtkMenu</type></link> (depending on <parameter>menu_only</parameter>).
179
<varlistentry><term><parameter>menu_only</parameter> :</term>
180
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the function should return a <link linkend="GtkMenu"><type>GtkMenu</type></link> only.
181
</simpara></listitem></varlistentry>
182
<varlistentry><term><parameter>...</parameter> :</term>
183
<listitem><simpara> A <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated <parameter>va_list</parameter> describing the menu items.
184
</simpara></listitem></varlistentry>
185
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> or a <link linkend="GtkMenu"><type>GtkMenu</type></link> (depending on <parameter>menu_only</parameter>).
194
186
</simpara></listitem></varlistentry>
195
187
</variablelist></refsect2>
196
188
<refsect2 id="gimp-option-menu-new2" role="function" condition="deprecated:">
197
189
<title>gimp_option_menu_new2 ()</title>
198
<indexterm zone="gimp-option-menu-new2" role="deprecated"><primary>gimp_option_menu_new2</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_option_menu_new2 (<link linkend="gboolean">gboolean</link> menu_only,
190
<indexterm zone="gimp-option-menu-new2" role="deprecated"><primary sortas="gimp_option_menu_new2">gimp_option_menu_new2</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> * gimp_option_menu_new2 (<link linkend="gboolean">gboolean</link> menu_only,
199
191
<link linkend="GCallback">GCallback</link> menu_item_callback,
200
192
<link linkend="gpointer">gpointer</link> menu_item_callback_data,
201
193
<link linkend="gpointer">gpointer</link> initial,
205
197
Convenience function to create a <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> or a <link linkend="GtkMenu"><type>GtkMenu</type></link>.</para>
208
199
</para><variablelist role="params">
209
<varlistentry><term><parameter>menu_only</parameter> :</term>
210
<listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the function should return a <link linkend="GtkMenu"><type>GtkMenu</type></link> only.
200
<varlistentry><term><parameter>menu_only</parameter> :</term>
201
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the function should return a <link linkend="GtkMenu"><type>GtkMenu</type></link> only.
211
202
</simpara></listitem></varlistentry>
212
<varlistentry><term><parameter>menu_item_callback</parameter> :</term>
203
<varlistentry><term><parameter>menu_item_callback</parameter> :</term>
213
204
<listitem><simpara> The callback each menu item's "activate" signal will
214
205
be connected with.
215
206
</simpara></listitem></varlistentry>
216
<varlistentry><term><parameter>menu_item_callback_data</parameter> :</term>
207
<varlistentry><term><parameter>menu_item_callback_data</parameter> :</term>
217
208
<listitem><simpara>
218
209
The data which will be passed to <link linkend="g-signal-connect"><function>g_signal_connect()</function></link>.
219
210
</simpara></listitem></varlistentry>
220
<varlistentry><term><parameter>initial</parameter> :</term>
211
<varlistentry><term><parameter>initial</parameter> :</term>
221
212
<listitem><simpara> The <parameter>item_data</parameter> of the initially selected menu item.
222
213
</simpara></listitem></varlistentry>
223
<varlistentry><term><parameter>...</parameter> :</term>
224
<listitem><simpara> A <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated <parameter>va_list</parameter> describing the menu items.
214
<varlistentry><term><parameter>...</parameter> :</term>
215
<listitem><simpara> A <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated <parameter>va_list</parameter> describing the menu items.
225
216
</simpara></listitem></varlistentry>
226
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> or a <link linkend="GtkMenu"><type>GtkMenu</type></link> (depending on <parameter>menu_only</parameter>).
217
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> or a <link linkend="GtkMenu"><type>GtkMenu</type></link> (depending on <parameter>menu_only</parameter>).
227
218
</simpara></listitem></varlistentry>
228
219
</variablelist></refsect2>
229
220
<refsect2 id="gimp-option-menu-set-history" role="function" condition="deprecated:">
230
221
<title>gimp_option_menu_set_history ()</title>
231
<indexterm zone="gimp-option-menu-set-history" role="deprecated"><primary>gimp_option_menu_set_history</primary></indexterm><programlisting><link linkend="void">void</link> gimp_option_menu_set_history (<link linkend="GtkOptionMenu">GtkOptionMenu</link> *option_menu,
222
<indexterm zone="gimp-option-menu-set-history" role="deprecated"><primary sortas="gimp_option_menu_set_history">gimp_option_menu_set_history</primary></indexterm><programlisting><link linkend="void">void</link> gimp_option_menu_set_history (<link linkend="GtkOptionMenu">GtkOptionMenu</link> *option_menu,
232
223
<link linkend="gpointer">gpointer</link> item_data);</programlisting>
233
224
<warning><para><literal>gimp_option_menu_set_history</literal> is deprecated and should not be used in newly-written code.</para></warning>
237
228
a <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> that was created using <link linkend="gimp-option-menu-new"><function>gimp_option_menu_new()</function></link> or
238
229
<link linkend="gimp-option-menu-new2"><function>gimp_option_menu_new2()</function></link>.</para>
241
231
</para><variablelist role="params">
242
<varlistentry><term><parameter>option_menu</parameter> :</term>
232
<varlistentry><term><parameter>option_menu</parameter> :</term>
243
233
<listitem><simpara> A <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> as returned by <link linkend="gimp-option-menu-new"><function>gimp_option_menu_new()</function></link> or
244
234
<link linkend="gimp-option-menu-new2"><function>gimp_option_menu_new2()</function></link>.
245
235
</simpara></listitem></varlistentry>
246
<varlistentry><term><parameter>item_data</parameter> :</term>
236
<varlistentry><term><parameter>item_data</parameter> :</term>
247
237
<listitem><simpara> The <parameter>item_data</parameter> of the menu item you want to select.
248
238
</simpara></listitem></varlistentry>
249
239
</variablelist></refsect2>
250
240
<refsect2 id="GimpOptionMenuSensitivityCallback" role="function" condition="deprecated:">
251
241
<title>GimpOptionMenuSensitivityCallback ()</title>
252
<indexterm zone="GimpOptionMenuSensitivityCallback" role="deprecated"><primary>GimpOptionMenuSensitivityCallback</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> (*GimpOptionMenuSensitivityCallback)
242
<indexterm zone="GimpOptionMenuSensitivityCallback" role="deprecated"><primary sortas="GimpOptionMenuSensitivityCallback">GimpOptionMenuSensitivityCallback</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> (*GimpOptionMenuSensitivityCallback)
253
243
(<link linkend="gpointer">gpointer</link> item_data,
254
244
<link linkend="gpointer">gpointer</link> callback_data);</programlisting>
255
245
<warning><para><literal>GimpOptionMenuSensitivityCallback</literal> is deprecated and should not be used in newly-written code.</para></warning>
258
247
</para><variablelist role="params">
259
<varlistentry><term><parameter>item_data</parameter> :</term>
261
</simpara></listitem></varlistentry>
262
<varlistentry><term><parameter>callback_data</parameter> :</term>
264
</simpara></listitem></varlistentry>
265
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
248
<varlistentry><term><parameter>item_data</parameter> :</term>
250
</simpara></listitem></varlistentry>
251
<varlistentry><term><parameter>callback_data</parameter> :</term>
253
</simpara></listitem></varlistentry>
254
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
268
255
</simpara></listitem></varlistentry>
269
256
</variablelist></refsect2>
270
257
<refsect2 id="gimp-option-menu-set-sensitive" role="function" condition="deprecated:">
271
258
<title>gimp_option_menu_set_sensitive ()</title>
272
<indexterm zone="gimp-option-menu-set-sensitive" role="deprecated"><primary>gimp_option_menu_set_sensitive</primary></indexterm><programlisting><link linkend="void">void</link> gimp_option_menu_set_sensitive (<link linkend="GtkOptionMenu">GtkOptionMenu</link> *option_menu,
259
<indexterm zone="gimp-option-menu-set-sensitive" role="deprecated"><primary sortas="gimp_option_menu_set_sensitive">gimp_option_menu_set_sensitive</primary></indexterm><programlisting><link linkend="void">void</link> gimp_option_menu_set_sensitive (<link linkend="GtkOptionMenu">GtkOptionMenu</link> *option_menu,
273
260
<link linkend="GimpOptionMenuSensitivityCallback">GimpOptionMenuSensitivityCallback</link> callback,
274
261
<link linkend="gpointer">gpointer</link> callback_data);</programlisting>
275
262
<warning><para><literal>gimp_option_menu_set_sensitive</literal> is deprecated and should not be used in newly-written code.</para></warning>
278
265
item_data and the <parameter>callback_data</parameter>. The menu item's sensitivity is set
279
266
according to the return value of this function.</para>
282
268
</para><variablelist role="params">
283
<varlistentry><term><parameter>option_menu</parameter> :</term>
269
<varlistentry><term><parameter>option_menu</parameter> :</term>
284
270
<listitem><simpara> a <link linkend="GtkOptionMenu"><type>GtkOptionMenu</type></link> as returned by <link linkend="gimp-option-menu-new"><function>gimp_option_menu_new()</function></link> or
285
271
<link linkend="gimp-option-menu-new2"><function>gimp_option_menu_new2()</function></link>.
286
272
</simpara></listitem></varlistentry>
287
<varlistentry><term><parameter>callback</parameter> :</term>
273
<varlistentry><term><parameter>callback</parameter> :</term>
288
274
<listitem><simpara> a function called for each item in the menu to determine the
289
275
the sensitivity state.
290
276
</simpara></listitem></varlistentry>
291
<varlistentry><term><parameter>callback_data</parameter> :</term>
277
<varlistentry><term><parameter>callback_data</parameter> :</term>
292
278
<listitem><simpara> data to pass to the <parameter>callback</parameter> function.
293
279
</simpara></listitem></varlistentry>
294
280
</variablelist></refsect2>
295
281
<refsect2 id="gimp-menu-item-update" role="function" condition="deprecated:">
296
282
<title>gimp_menu_item_update ()</title>
297
<indexterm zone="gimp-menu-item-update" role="deprecated"><primary>gimp_menu_item_update</primary></indexterm><programlisting><link linkend="void">void</link> gimp_menu_item_update (<link linkend="GtkWidget">GtkWidget</link> *widget,
283
<indexterm zone="gimp-menu-item-update" role="deprecated"><primary sortas="gimp_menu_item_update">gimp_menu_item_update</primary></indexterm><programlisting><link linkend="void">void</link> gimp_menu_item_update (<link linkend="GtkWidget">GtkWidget</link> *widget,
298
284
<link linkend="gpointer">gpointer</link> data);</programlisting>
299
285
<warning><para><literal>gimp_menu_item_update</literal> is deprecated and should not be used in newly-written code.</para></warning>
304
289
</para><variablelist role="params">
305
<varlistentry><term><parameter>widget</parameter> :</term>
290
<varlistentry><term><parameter>widget</parameter> :</term>
306
291
<listitem><simpara> A <link linkend="GtkMenuItem"><type>GtkMenuItem</type></link>.
307
292
</simpara></listitem></varlistentry>
308
<varlistentry><term><parameter>data</parameter> :</term>
293
<varlistentry><term><parameter>data</parameter> :</term>
309
294
<listitem><simpara> A pointer to a <link linkend="gint"><type>gint</type></link> variable which will store the value of
310
295
GPOINTER_TO_INT (g_object_get_data (<parameter>widget</parameter>, "gimp-item-data")).
311
296
</simpara></listitem></varlistentry>