165
159
The first separator of <parameter>separators</parameter> is used to display the current
169
162
</para><variablelist role="params">
170
<varlistentry><term><parameter>separators</parameter> :</term>
172
</simpara></listitem></varlistentry>
173
<varlistentry><term><parameter>allow_simplification</parameter> :</term>
175
</simpara></listitem></varlistentry>
176
<varlistentry><term><parameter>min_valid_value</parameter> :</term>
178
</simpara></listitem></varlistentry>
179
<varlistentry><term><parameter>max_valid_value</parameter> :</term>
181
</simpara></listitem></varlistentry>
182
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The new <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
163
<varlistentry><term><parameter>separators</parameter> :</term>
165
</simpara></listitem></varlistentry>
166
<varlistentry><term><parameter>allow_simplification</parameter> :</term>
168
</simpara></listitem></varlistentry>
169
<varlistentry><term><parameter>min_valid_value</parameter> :</term>
171
</simpara></listitem></varlistentry>
172
<varlistentry><term><parameter>max_valid_value</parameter> :</term>
174
</simpara></listitem></varlistentry>
175
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The new <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
184
177
</simpara></listitem></varlistentry>
185
</variablelist><para role="since">Since GIMP 2.4
178
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
187
179
<refsect2 id="gimp-number-pair-entry-set-default-values" role="function" condition="since:GIMP 2.4">
188
180
<title>gimp_number_pair_entry_set_default_values ()</title>
189
<indexterm zone="gimp-number-pair-entry-set-default-values" role="GIMP 2.4"><primary>gimp_number_pair_entry_set_default_values</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_set_default_values
181
<indexterm zone="gimp-number-pair-entry-set-default-values" role="GIMP 2.4"><primary sortas="gimp_number_pair_entry_set_default_values">gimp_number_pair_entry_set_default_values</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_set_default_values
190
182
(<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry,
191
183
<link linkend="gdouble">gdouble</link> left,
192
184
<link linkend="gdouble">gdouble</link> right);</programlisting>
197
188
</para><variablelist role="params">
198
<varlistentry><term><parameter>entry</parameter> :</term>
189
<varlistentry><term><parameter>entry</parameter> :</term>
199
190
<listitem><simpara> A <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
200
191
</simpara></listitem></varlistentry>
201
<varlistentry><term><parameter>left</parameter> :</term>
192
<varlistentry><term><parameter>left</parameter> :</term>
202
193
<listitem><simpara> Default left value in the entry.
203
194
</simpara></listitem></varlistentry>
204
<varlistentry><term><parameter>right</parameter> :</term>
195
<varlistentry><term><parameter>right</parameter> :</term>
205
196
<listitem><simpara> Default right value in the entry.
206
197
</simpara></listitem></varlistentry>
207
</variablelist><para role="since">Since GIMP 2.4
198
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
209
199
<refsect2 id="gimp-number-pair-entry-get-default-values" role="function" condition="since:GIMP 2.4">
210
200
<title>gimp_number_pair_entry_get_default_values ()</title>
211
<indexterm zone="gimp-number-pair-entry-get-default-values" role="GIMP 2.4"><primary>gimp_number_pair_entry_get_default_values</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_get_default_values
201
<indexterm zone="gimp-number-pair-entry-get-default-values" role="GIMP 2.4"><primary sortas="gimp_number_pair_entry_get_default_values">gimp_number_pair_entry_get_default_values</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_get_default_values
212
202
(<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry,
213
203
<link linkend="gdouble">gdouble</link> *left,
214
204
<link linkend="gdouble">gdouble</link> *right);</programlisting>
219
208
</para><variablelist role="params">
220
<varlistentry><term><parameter>entry</parameter> :</term>
209
<varlistentry><term><parameter>entry</parameter> :</term>
221
210
<listitem><simpara> A <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
222
211
</simpara></listitem></varlistentry>
223
<varlistentry><term><parameter>left</parameter> :</term>
212
<varlistentry><term><parameter>left</parameter> :</term>
224
213
<listitem><simpara> Pointer of where to put left value.
225
214
</simpara></listitem></varlistentry>
226
<varlistentry><term><parameter>right</parameter> :</term>
215
<varlistentry><term><parameter>right</parameter> :</term>
227
216
<listitem><simpara> Pointer of where to put right value.
228
217
</simpara></listitem></varlistentry>
229
</variablelist><para role="since">Since GIMP 2.4
218
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
231
219
<refsect2 id="gimp-number-pair-entry-set-values" role="function" condition="since:GIMP 2.4">
232
220
<title>gimp_number_pair_entry_set_values ()</title>
233
<indexterm zone="gimp-number-pair-entry-set-values" role="GIMP 2.4"><primary>gimp_number_pair_entry_set_values</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_set_values (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry,
221
<indexterm zone="gimp-number-pair-entry-set-values" role="GIMP 2.4"><primary sortas="gimp_number_pair_entry_set_values">gimp_number_pair_entry_set_values</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_set_values (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry,
234
222
<link linkend="gdouble">gdouble</link> left,
235
223
<link linkend="gdouble">gdouble</link> right);</programlisting>
238
226
ignoring if the user has set his/her own value. The state of
239
227
user-override will not be changed.</para>
242
229
</para><variablelist role="params">
243
<varlistentry><term><parameter>entry</parameter> :</term>
230
<varlistentry><term><parameter>entry</parameter> :</term>
244
231
<listitem><simpara> A <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
245
232
</simpara></listitem></varlistentry>
246
<varlistentry><term><parameter>left</parameter> :</term>
233
<varlistentry><term><parameter>left</parameter> :</term>
247
234
<listitem><simpara> Left number in the entry.
248
235
</simpara></listitem></varlistentry>
249
<varlistentry><term><parameter>right</parameter> :</term>
236
<varlistentry><term><parameter>right</parameter> :</term>
250
237
<listitem><simpara> Right number in the entry.
251
238
</simpara></listitem></varlistentry>
252
</variablelist><para role="since">Since GIMP 2.4
239
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
254
240
<refsect2 id="gimp-number-pair-entry-get-values" role="function" condition="since:GIMP 2.4">
255
241
<title>gimp_number_pair_entry_get_values ()</title>
256
<indexterm zone="gimp-number-pair-entry-get-values" role="GIMP 2.4"><primary>gimp_number_pair_entry_get_values</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_get_values (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry,
242
<indexterm zone="gimp-number-pair-entry-get-values" role="GIMP 2.4"><primary sortas="gimp_number_pair_entry_get_values">gimp_number_pair_entry_get_values</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_get_values (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry,
257
243
<link linkend="gdouble">gdouble</link> *left,
258
244
<link linkend="gdouble">gdouble</link> *right);</programlisting>
260
246
Gets the numbers displayed by a <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link>.</para>
263
248
</para><variablelist role="params">
264
<varlistentry><term><parameter>entry</parameter> :</term>
249
<varlistentry><term><parameter>entry</parameter> :</term>
265
250
<listitem><simpara> A <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
266
251
</simpara></listitem></varlistentry>
267
<varlistentry><term><parameter>left</parameter> :</term>
268
<listitem><simpara> Pointer of where to store the left number (may be <link linkend="NULL:CAPS"><literal>NULL</literal></link>).
269
</simpara></listitem></varlistentry>
270
<varlistentry><term><parameter>right</parameter> :</term>
271
<listitem><simpara> Pointer of to store the right number (may be <link linkend="NULL:CAPS"><literal>NULL</literal></link>).
272
</simpara></listitem></varlistentry>
273
</variablelist><para role="since">Since GIMP 2.4
252
<varlistentry><term><parameter>left</parameter> :</term>
253
<listitem><simpara> Pointer of where to store the left number (may be <link linkend="NULL--CAPS"><literal>NULL</literal></link>).
254
</simpara></listitem></varlistentry>
255
<varlistentry><term><parameter>right</parameter> :</term>
256
<listitem><simpara> Pointer of to store the right number (may be <link linkend="NULL--CAPS"><literal>NULL</literal></link>).
257
</simpara></listitem></varlistentry>
258
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
275
259
<refsect2 id="gimp-number-pair-entry-get-aspect" role="function" condition="since:GIMP 2.4">
276
260
<title>gimp_number_pair_entry_get_aspect ()</title>
277
<indexterm zone="gimp-number-pair-entry-get-aspect" role="GIMP 2.4"><primary>gimp_number_pair_entry_get_aspect</primary></indexterm><programlisting><link linkend="GimpAspectType">GimpAspectType</link> gimp_number_pair_entry_get_aspect (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry);</programlisting>
261
<indexterm zone="gimp-number-pair-entry-get-aspect" role="GIMP 2.4"><primary sortas="gimp_number_pair_entry_get_aspect">gimp_number_pair_entry_get_aspect</primary></indexterm><programlisting><link linkend="GimpAspectType">GimpAspectType</link> gimp_number_pair_entry_get_aspect (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry);</programlisting>
279
263
Gets the aspect of the ratio displayed by a <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link>.</para>
282
265
</para><variablelist role="params">
283
<varlistentry><term><parameter>entry</parameter> :</term>
266
<varlistentry><term><parameter>entry</parameter> :</term>
284
267
<listitem><simpara> A <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
285
268
</simpara></listitem></varlistentry>
286
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The entry's current aspect.
269
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The entry's current aspect.
288
271
</simpara></listitem></varlistentry>
289
</variablelist><para role="since">Since GIMP 2.4
272
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
291
273
<refsect2 id="gimp-number-pair-entry-set-aspect" role="function" condition="since:GIMP 2.4">
292
274
<title>gimp_number_pair_entry_set_aspect ()</title>
293
<indexterm zone="gimp-number-pair-entry-set-aspect" role="GIMP 2.4"><primary>gimp_number_pair_entry_set_aspect</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_set_aspect (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry,
275
<indexterm zone="gimp-number-pair-entry-set-aspect" role="GIMP 2.4"><primary sortas="gimp_number_pair_entry_set_aspect">gimp_number_pair_entry_set_aspect</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_set_aspect (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry,
294
276
<link linkend="GimpAspectType">GimpAspectType</link> aspect);</programlisting>
296
278
Sets the aspect of the ratio by swapping the left_number and
297
279
right_number if necessary (or setting them to 1.0 in case that
298
<parameter>aspect</parameter> is <link linkend="GIMP-ASPECT-SQUARE:CAPS"><literal>GIMP_ASPECT_SQUARE</literal></link>).</para>
280
<parameter>aspect</parameter> is <link linkend="GIMP-ASPECT-SQUARE--CAPS"><literal>GIMP_ASPECT_SQUARE</literal></link>).</para>
301
282
</para><variablelist role="params">
302
<varlistentry><term><parameter>entry</parameter> :</term>
283
<varlistentry><term><parameter>entry</parameter> :</term>
303
284
<listitem><simpara> A <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
304
285
</simpara></listitem></varlistentry>
305
<varlistentry><term><parameter>aspect</parameter> :</term>
286
<varlistentry><term><parameter>aspect</parameter> :</term>
306
287
<listitem><simpara> The new aspect.
307
288
</simpara></listitem></varlistentry>
308
</variablelist><para role="since">Since GIMP 2.4
289
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
310
290
<refsect2 id="gimp-number-pair-entry-get-ratio" role="function" condition="since:GIMP 2.4">
311
291
<title>gimp_number_pair_entry_get_ratio ()</title>
312
<indexterm zone="gimp-number-pair-entry-get-ratio" role="GIMP 2.4"><primary>gimp_number_pair_entry_get_ratio</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_number_pair_entry_get_ratio (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry);</programlisting>
292
<indexterm zone="gimp-number-pair-entry-get-ratio" role="GIMP 2.4"><primary sortas="gimp_number_pair_entry_get_ratio">gimp_number_pair_entry_get_ratio</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_number_pair_entry_get_ratio (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry);</programlisting>
314
294
Retrieves the ratio of the numbers displayed by a <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link>.</para>
317
296
</para><variablelist role="params">
318
<varlistentry><term><parameter>entry</parameter> :</term>
297
<varlistentry><term><parameter>entry</parameter> :</term>
319
298
<listitem><simpara> A <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
320
299
</simpara></listitem></varlistentry>
321
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The ratio value.
300
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The ratio value.
323
302
</simpara></listitem></varlistentry>
324
</variablelist><para role="since">Since GIMP 2.4
303
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
326
304
<refsect2 id="gimp-number-pair-entry-set-ratio" role="function" condition="since:GIMP 2.4">
327
305
<title>gimp_number_pair_entry_set_ratio ()</title>
328
<indexterm zone="gimp-number-pair-entry-set-ratio" role="GIMP 2.4"><primary>gimp_number_pair_entry_set_ratio</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_set_ratio (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry,
306
<indexterm zone="gimp-number-pair-entry-set-ratio" role="GIMP 2.4"><primary sortas="gimp_number_pair_entry_set_ratio">gimp_number_pair_entry_set_ratio</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_set_ratio (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry,
329
307
<link linkend="gdouble">gdouble</link> ratio);</programlisting>
331
309
Sets the numbers of the <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> to have the desired
336
314
An attempt is made to convert the decimal number into a fraction
337
315
with left_number and right_number < 1000.</para>
340
317
</para><variablelist role="params">
341
<varlistentry><term><parameter>entry</parameter> :</term>
318
<varlistentry><term><parameter>entry</parameter> :</term>
342
319
<listitem><simpara> A <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
343
320
</simpara></listitem></varlistentry>
344
<varlistentry><term><parameter>ratio</parameter> :</term>
321
<varlistentry><term><parameter>ratio</parameter> :</term>
345
322
<listitem><simpara> Ratio to set in the widget.
346
323
</simpara></listitem></varlistentry>
347
</variablelist><para role="since">Since GIMP 2.4
324
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
349
325
<refsect2 id="gimp-number-pair-entry-get-user-override" role="function" condition="since:GIMP 2.4">
350
326
<title>gimp_number_pair_entry_get_user_override ()</title>
351
<indexterm zone="gimp-number-pair-entry-get-user-override" role="GIMP 2.4"><primary>gimp_number_pair_entry_get_user_override</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_number_pair_entry_get_user_override
327
<indexterm zone="gimp-number-pair-entry-get-user-override" role="GIMP 2.4"><primary sortas="gimp_number_pair_entry_get_user_override">gimp_number_pair_entry_get_user_override</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_number_pair_entry_get_user_override
352
328
(<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry);</programlisting>
357
332
</para><variablelist role="params">
358
<varlistentry><term><parameter>entry</parameter> :</term>
333
<varlistentry><term><parameter>entry</parameter> :</term>
359
334
<listitem><simpara> A <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
360
335
</simpara></listitem></varlistentry>
361
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> Wether or not the the widget is in user overridden mode.
336
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> Wether or not the the widget is in user overridden mode.
363
338
</simpara></listitem></varlistentry>
364
</variablelist><para role="since">Since GIMP 2.4
339
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
366
340
<refsect2 id="gimp-number-pair-entry-set-user-override" role="function" condition="since:GIMP 2.4">
367
341
<title>gimp_number_pair_entry_set_user_override ()</title>
368
<indexterm zone="gimp-number-pair-entry-set-user-override" role="GIMP 2.4"><primary>gimp_number_pair_entry_set_user_override</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_set_user_override
342
<indexterm zone="gimp-number-pair-entry-set-user-override" role="GIMP 2.4"><primary sortas="gimp_number_pair_entry_set_user_override">gimp_number_pair_entry_set_user_override</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_set_user_override
369
343
(<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry,
370
344
<link linkend="gboolean">gboolean</link> user_override);</programlisting>
373
347
change when the default values are changed. When in user overridden
374
348
mode, setting default values will not affect the active values.</para>
377
350
</para><variablelist role="params">
378
<varlistentry><term><parameter>entry</parameter> :</term>
351
<varlistentry><term><parameter>entry</parameter> :</term>
379
352
<listitem><simpara> A <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
380
353
</simpara></listitem></varlistentry>
381
<varlistentry><term><parameter>user_override</parameter> :</term>
382
<listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> sets the entry in user overridden mode,
383
<link linkend="FALSE:CAPS"><literal>FALSE</literal></link> disables.
354
<varlistentry><term><parameter>user_override</parameter> :</term>
355
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> sets the entry in user overridden mode,
356
<link linkend="FALSE--CAPS"><literal>FALSE</literal></link> disables.
384
357
</simpara></listitem></varlistentry>
385
</variablelist><para role="since">Since GIMP 2.4
358
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
387
359
<refsect2 id="gimp-number-pair-entry-get-default-text" role="function" condition="since:GIMP 2.4">
388
360
<title>gimp_number_pair_entry_get_default_text ()</title>
389
<indexterm zone="gimp-number-pair-entry-get-default-text" role="GIMP 2.4"><primary>gimp_number_pair_entry_get_default_text</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gimp_number_pair_entry_get_default_text
361
<indexterm zone="gimp-number-pair-entry-get-default-text" role="GIMP 2.4"><primary sortas="gimp_number_pair_entry_get_default_text">gimp_number_pair_entry_get_default_text</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> * gimp_number_pair_entry_get_default_text
390
362
(<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry);</programlisting>
395
366
</para><variablelist role="params">
396
<varlistentry><term><parameter>entry</parameter> :</term>
367
<varlistentry><term><parameter>entry</parameter> :</term>
397
368
<listitem><simpara> A <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
398
369
</simpara></listitem></varlistentry>
399
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the string manully set to be shown, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if values are
370
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the string manully set to be shown, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if values are
400
371
shown in a normal fashion.
402
373
</simpara></listitem></varlistentry>
403
</variablelist><para role="since">Since GIMP 2.4
374
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
405
375
<refsect2 id="gimp-number-pair-entry-set-default-text" role="function" condition="since:GIMP 2.4">
406
376
<title>gimp_number_pair_entry_set_default_text ()</title>
407
<indexterm zone="gimp-number-pair-entry-set-default-text" role="GIMP 2.4"><primary>gimp_number_pair_entry_set_default_text</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_set_default_text
377
<indexterm zone="gimp-number-pair-entry-set-default-text" role="GIMP 2.4"><primary sortas="gimp_number_pair_entry_set_default_text">gimp_number_pair_entry_set_default_text</primary></indexterm><programlisting><link linkend="void">void</link> gimp_number_pair_entry_set_default_text
408
378
(<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *entry,
409
379
const <link linkend="gchar">gchar</link> *string);</programlisting>
414
384
and API calls are not affected.
417
Set the default string to <link linkend="NULL:CAPS"><literal>NULL</literal></link> to display default values as
387
Set the default string to <link linkend="NULL--CAPS"><literal>NULL</literal></link> to display default values as
421
390
</para><variablelist role="params">
422
<varlistentry><term><parameter>entry</parameter> :</term>
391
<varlistentry><term><parameter>entry</parameter> :</term>
423
392
<listitem><simpara> A <link linkend="GimpNumberPairEntry"><type>GimpNumberPairEntry</type></link> widget.
424
393
</simpara></listitem></varlistentry>
425
<varlistentry><term><parameter>string</parameter> :</term>
394
<varlistentry><term><parameter>string</parameter> :</term>
426
395
<listitem><simpara> Default string.
427
396
</simpara></listitem></varlistentry>
428
</variablelist><para role="since">Since GIMP 2.4
397
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
432
400
<refsect1 id="GimpNumberPairEntry.property-details" role="property_details">
433
401
<title role="property_details.title">Property Details</title>
434
<refsect2 id="GimpNumberPairEntry--allow-simplification"><title>The <literal>"allow-simplification"</literal> property</title>
435
<indexterm zone="GimpNumberPairEntry--allow-simplification"><primary>GimpNumberPairEntry:allow-simplification</primary></indexterm><programlisting> "allow-simplification" <link linkend="gboolean">gboolean</link> : Read / Write</programlisting>
402
<refsect2 id="GimpNumberPairEntry--allow-simplification" role="property"><title>The <literal>"allow-simplification"</literal> property</title>
403
<indexterm zone="GimpNumberPairEntry--allow-simplification"><primary sortas="GimpNumberPairEntry:allow-simplification">GimpNumberPairEntry:allow-simplification</primary></indexterm><programlisting> "allow-simplification" <link linkend="gboolean">gboolean</link> : Read / Write</programlisting>
436
404
<para>Whether to allow simplification.</para><para>Default value: FALSE</para>
438
<refsect2 id="GimpNumberPairEntry--aspect"><title>The <literal>"aspect"</literal> property</title>
439
<indexterm zone="GimpNumberPairEntry--aspect"><primary>GimpNumberPairEntry:aspect</primary></indexterm><programlisting> "aspect" <link linkend="GimpAspectType">GimpAspectType</link> : Read / Write</programlisting>
406
<refsect2 id="GimpNumberPairEntry--aspect" role="property"><title>The <literal>"aspect"</literal> property</title>
407
<indexterm zone="GimpNumberPairEntry--aspect"><primary sortas="GimpNumberPairEntry:aspect">GimpNumberPairEntry:aspect</primary></indexterm><programlisting> "aspect" <link linkend="GimpAspectType">GimpAspectType</link> : Read / Write</programlisting>
440
408
<para></para><para>Default value: GIMP_ASPECT_SQUARE</para>
442
<refsect2 id="GimpNumberPairEntry--default-left-number"><title>The <literal>"default-left-number"</literal> property</title>
443
<indexterm zone="GimpNumberPairEntry--default-left-number"><primary>GimpNumberPairEntry:default-left-number</primary></indexterm><programlisting> "default-left-number" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
444
<para></para><para>Allowed values: >= G_MINDOUBLE</para>
445
<para>Default value: 100</para>
447
<refsect2 id="GimpNumberPairEntry--default-right-number"><title>The <literal>"default-right-number"</literal> property</title>
448
<indexterm zone="GimpNumberPairEntry--default-right-number"><primary>GimpNumberPairEntry:default-right-number</primary></indexterm><programlisting> "default-right-number" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
449
<para></para><para>Allowed values: >= G_MINDOUBLE</para>
450
<para>Default value: 100</para>
452
<refsect2 id="GimpNumberPairEntry--default-text"><title>The <literal>"default-text"</literal> property</title>
453
<indexterm zone="GimpNumberPairEntry--default-text"><primary>GimpNumberPairEntry:default-text</primary></indexterm><programlisting> "default-text" <link linkend="gchar">gchar</link>* : Read / Write</programlisting>
410
<refsect2 id="GimpNumberPairEntry--default-left-number" role="property"><title>The <literal>"default-left-number"</literal> property</title>
411
<indexterm zone="GimpNumberPairEntry--default-left-number"><primary sortas="GimpNumberPairEntry:default-left-number">GimpNumberPairEntry:default-left-number</primary></indexterm><programlisting> "default-left-number" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
412
<para></para><para>Allowed values: >= G_MINDOUBLE</para>
413
<para>Default value: 100</para>
415
<refsect2 id="GimpNumberPairEntry--default-right-number" role="property"><title>The <literal>"default-right-number"</literal> property</title>
416
<indexterm zone="GimpNumberPairEntry--default-right-number"><primary sortas="GimpNumberPairEntry:default-right-number">GimpNumberPairEntry:default-right-number</primary></indexterm><programlisting> "default-right-number" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
417
<para></para><para>Allowed values: >= G_MINDOUBLE</para>
418
<para>Default value: 100</para>
420
<refsect2 id="GimpNumberPairEntry--default-text" role="property"><title>The <literal>"default-text"</literal> property</title>
421
<indexterm zone="GimpNumberPairEntry--default-text"><primary sortas="GimpNumberPairEntry:default-text">GimpNumberPairEntry:default-text</primary></indexterm><programlisting> "default-text" <link linkend="gchar">gchar</link>* : Read / Write</programlisting>
454
422
<para>String to show when in automatic mode.</para><para>Default value: NULL</para>
456
<refsect2 id="GimpNumberPairEntry--left-number"><title>The <literal>"left-number"</literal> property</title>
457
<indexterm zone="GimpNumberPairEntry--left-number"><primary>GimpNumberPairEntry:left-number</primary></indexterm><programlisting> "left-number" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
424
<refsect2 id="GimpNumberPairEntry--left-number" role="property"><title>The <literal>"left-number"</literal> property</title>
425
<indexterm zone="GimpNumberPairEntry--left-number"><primary sortas="GimpNumberPairEntry:left-number">GimpNumberPairEntry:left-number</primary></indexterm><programlisting> "left-number" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
458
426
<para></para><para>Allowed values: >= G_MINDOUBLE</para>
459
427
<para>Default value: 100</para>
461
<refsect2 id="GimpNumberPairEntry--max-valid-value"><title>The <literal>"max-valid-value"</literal> property</title>
462
<indexterm zone="GimpNumberPairEntry--max-valid-value"><primary>GimpNumberPairEntry:max-valid-value</primary></indexterm><programlisting> "max-valid-value" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
429
<refsect2 id="GimpNumberPairEntry--max-valid-value" role="property"><title>The <literal>"max-valid-value"</literal> property</title>
430
<indexterm zone="GimpNumberPairEntry--max-valid-value"><primary sortas="GimpNumberPairEntry:max-valid-value">GimpNumberPairEntry:max-valid-value</primary></indexterm><programlisting> "max-valid-value" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
463
431
<para>Maximum value valid when parsing input.</para><para>Allowed values: >= G_MINDOUBLE</para>
464
432
<para>Default value: 1.79769e+308</para>
466
<refsect2 id="GimpNumberPairEntry--min-valid-value"><title>The <literal>"min-valid-value"</literal> property</title>
467
<indexterm zone="GimpNumberPairEntry--min-valid-value"><primary>GimpNumberPairEntry:min-valid-value</primary></indexterm><programlisting> "min-valid-value" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
434
<refsect2 id="GimpNumberPairEntry--min-valid-value" role="property"><title>The <literal>"min-valid-value"</literal> property</title>
435
<indexterm zone="GimpNumberPairEntry--min-valid-value"><primary sortas="GimpNumberPairEntry:min-valid-value">GimpNumberPairEntry:min-valid-value</primary></indexterm><programlisting> "min-valid-value" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
468
436
<para>Minimum value valid when parsing input.</para><para>Allowed values: >= G_MINDOUBLE</para>
469
437
<para>Default value: 2.22507e-308</para>
471
<refsect2 id="GimpNumberPairEntry--ratio"><title>The <literal>"ratio"</literal> property</title>
472
<indexterm zone="GimpNumberPairEntry--ratio"><primary>GimpNumberPairEntry:ratio</primary></indexterm><programlisting> "ratio" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
439
<refsect2 id="GimpNumberPairEntry--ratio" role="property"><title>The <literal>"ratio"</literal> property</title>
440
<indexterm zone="GimpNumberPairEntry--ratio"><primary sortas="GimpNumberPairEntry:ratio">GimpNumberPairEntry:ratio</primary></indexterm><programlisting> "ratio" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
473
441
<para></para><para>Allowed values: >= G_MINDOUBLE</para>
474
442
<para>Default value: 1</para>
476
<refsect2 id="GimpNumberPairEntry--right-number"><title>The <literal>"right-number"</literal> property</title>
477
<indexterm zone="GimpNumberPairEntry--right-number"><primary>GimpNumberPairEntry:right-number</primary></indexterm><programlisting> "right-number" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
444
<refsect2 id="GimpNumberPairEntry--right-number" role="property"><title>The <literal>"right-number"</literal> property</title>
445
<indexterm zone="GimpNumberPairEntry--right-number"><primary sortas="GimpNumberPairEntry:right-number">GimpNumberPairEntry:right-number</primary></indexterm><programlisting> "right-number" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
478
446
<para></para><para>Allowed values: >= G_MINDOUBLE</para>
479
447
<para>Default value: 100</para>
481
<refsect2 id="GimpNumberPairEntry--separators"><title>The <literal>"separators"</literal> property</title>
482
<indexterm zone="GimpNumberPairEntry--separators"><primary>GimpNumberPairEntry:separators</primary></indexterm><programlisting> "separators" <link linkend="gchar">gchar</link>* : Read / Write / Construct Only</programlisting>
449
<refsect2 id="GimpNumberPairEntry--separators" role="property"><title>The <literal>"separators"</literal> property</title>
450
<indexterm zone="GimpNumberPairEntry--separators"><primary sortas="GimpNumberPairEntry:separators">GimpNumberPairEntry:separators</primary></indexterm><programlisting> "separators" <link linkend="gchar">gchar</link>* : Read / Write / Construct Only</programlisting>
483
451
<para>A string of valid separators.</para><para>Default value: NULL</para>
485
<refsect2 id="GimpNumberPairEntry--user-override"><title>The <literal>"user-override"</literal> property</title>
486
<indexterm zone="GimpNumberPairEntry--user-override"><primary>GimpNumberPairEntry:user-override</primary></indexterm><programlisting> "user-override" <link linkend="gboolean">gboolean</link> : Read / Write</programlisting>
453
<refsect2 id="GimpNumberPairEntry--user-override" role="property"><title>The <literal>"user-override"</literal> property</title>
454
<indexterm zone="GimpNumberPairEntry--user-override"><primary sortas="GimpNumberPairEntry:user-override">GimpNumberPairEntry:user-override</primary></indexterm><programlisting> "user-override" <link linkend="gboolean">gboolean</link> : Read / Write</programlisting>
487
455
<para>Whether the widget is in 'user override' mode.</para><para>Default value: FALSE</para>
492
459
<refsect1 id="GimpNumberPairEntry.signal-details" role="signals">
493
460
<title role="signals.title">Signal Details</title>
494
<refsect2 id="GimpNumberPairEntry-numbers-changed"><title>The <literal>"numbers-changed"</literal> signal</title>
495
<indexterm zone="GimpNumberPairEntry-numbers-changed"><primary>GimpNumberPairEntry::numbers-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *gimpnumberpairentry,
461
<refsect2 id="GimpNumberPairEntry-numbers-changed" role="signal"><title>The <literal>"numbers-changed"</literal> signal</title>
462
<indexterm zone="GimpNumberPairEntry-numbers-changed"><primary sortas="GimpNumberPairEntry::numbers-changed">GimpNumberPairEntry::numbers-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *gimpnumberpairentry,
496
463
<link linkend="gpointer">gpointer</link> user_data) : Run First</programlisting>
499
465
</para><variablelist role="params">
500
<varlistentry><term><parameter>gimpnumberpairentry</parameter> :</term>
466
<varlistentry><term><parameter>gimpnumberpairentry</parameter> :</term>
501
467
<listitem><simpara>the object which received the signal.
503
468
</simpara></listitem></varlistentry>
504
<varlistentry><term><parameter>user_data</parameter> :</term>
469
<varlistentry><term><parameter>user_data</parameter> :</term>
505
470
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
506
</variablelist></refsect2><refsect2 id="GimpNumberPairEntry-ratio-changed"><title>The <literal>"ratio-changed"</literal> signal</title>
507
<indexterm zone="GimpNumberPairEntry-ratio-changed"><primary>GimpNumberPairEntry::ratio-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *gimpnumberpairentry,
471
</variablelist></refsect2><refsect2 id="GimpNumberPairEntry-ratio-changed" role="signal"><title>The <literal>"ratio-changed"</literal> signal</title>
472
<indexterm zone="GimpNumberPairEntry-ratio-changed"><primary sortas="GimpNumberPairEntry::ratio-changed">GimpNumberPairEntry::ratio-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpNumberPairEntry">GimpNumberPairEntry</link> *gimpnumberpairentry,
508
473
<link linkend="gpointer">gpointer</link> user_data) : Run First</programlisting>
511
475
</para><variablelist role="params">
512
<varlistentry><term><parameter>gimpnumberpairentry</parameter> :</term>
476
<varlistentry><term><parameter>gimpnumberpairentry</parameter> :</term>
513
477
<listitem><simpara>the object which received the signal.
515
478
</simpara></listitem></varlistentry>
516
<varlistentry><term><parameter>user_data</parameter> :</term>
479
<varlistentry><term><parameter>user_data</parameter> :</term>
517
480
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
518
481
</variablelist></refsect2>