1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>GimpPropWidgets</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
8
<link rel="up" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
9
<link rel="prev" href="libgimpwidgets-GimpEnumWidgets.html" title="GimpEnumWidgets">
10
<link rel="next" href="libgimpwidgets-GimpWidgets.html" title="GimpWidgets">
11
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="part" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
14
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
15
<link rel="chapter" href="libgimpwidgets-gallery.html" title="Widget Gallery">
16
<link rel="chapter" href="libgimpwidgets-cell-renderers.html" title="Cell Renderers for GtkTreeView">
17
<link rel="part" href="libgimpwidgets-colordisplay.html" title="Part II. GIMP Display Filters">
18
<link rel="part" href="libgimpwidgets-colorselector.html" title="Part III. GIMP Color Selectors">
19
<link rel="part" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
20
<link rel="part" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
21
<link rel="part" href="libgimpwidgets-deprecated.html" title="Part VI. Deprecated API">
22
<link rel="index" href="libgimpwidgets-index.html" title="Index">
23
<link rel="index" href="libgimpwidgets-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
24
<link rel="index" href="libgimpwidgets-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
25
<link rel="index" href="libgimpwidgets-index-deprecated.html" title="Index of deprecated symbols">
27
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
28
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
30
<td><a accesskey="p" href="libgimpwidgets-GimpEnumWidgets.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
31
<td><a accesskey="u" href="libgimpwidgets-utils.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
32
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
33
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
34
<td><a accesskey="n" href="libgimpwidgets-GimpWidgets.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
36
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2646482" class="shortcut">Top</a>
38
<a href="#id2669367" class="shortcut">Description</a></nobr></td></tr>
40
<div class="refentry" lang="en">
41
<a name="libgimpwidgets-GimpPropWidgets"></a><div class="titlepage"></div>
42
<div class="refnamediv"><table width="100%"><tr>
45
<a name="id2646482"></a><span class="refentrytitle">GimpPropWidgets</span>
47
<p>GimpPropWidgets</p>
49
<td valign="top" align="right"></td>
51
<div class="refsynopsisdiv">
53
<pre class="synopsis">
57
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-boolean-combo-box-new">gimp_prop_boolean_combo_box_new</a> (GObject *config,
58
const gchar *property_name,
59
const gchar *true_text,
60
const gchar *false_text);
61
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-boolean-radio-frame-new">gimp_prop_boolean_radio_frame_new</a> (GObject *config,
62
const gchar *property_name,
64
const gchar *true_text,
65
const gchar *false_text);
66
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-check-button-new">gimp_prop_check_button_new</a> (GObject *config,
67
const gchar *property_name,
69
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-color-area-new">gimp_prop_color_area_new</a> (GObject *config,
70
const gchar *property_name,
73
<a href="GimpColorArea.html#GimpColorAreaType">GimpColorAreaType</a> type);
74
gboolean <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-coordinates-connect">gimp_prop_coordinates_connect</a> (GObject *config,
75
const gchar *x_property_name,
76
const gchar *y_property_name,
77
const gchar *unit_property_name,
79
GtkWidget *chainbutton,
82
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-coordinates-new">gimp_prop_coordinates_new</a> (GObject *config,
83
const gchar *x_property_name,
84
const gchar *y_property_name,
85
const gchar *unit_property_name,
86
const gchar *unit_format,
87
<a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy,
90
gboolean has_chainbutton);
91
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-entry-new">gimp_prop_entry_new</a> (GObject *config,
92
const gchar *property_name,
94
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-check-button-new">gimp_prop_enum_check_button_new</a> (GObject *config,
95
const gchar *property_name,
99
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-combo-box-new">gimp_prop_enum_combo_box_new</a> (GObject *config,
100
const gchar *property_name,
103
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-label-new">gimp_prop_enum_label_new</a> (GObject *config,
104
const gchar *property_name);
105
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-radio-box-new">gimp_prop_enum_radio_box_new</a> (GObject *config,
106
const gchar *property_name,
109
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-radio-frame-new">gimp_prop_enum_radio_frame_new</a> (GObject *config,
110
const gchar *property_name,
114
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-stock-box-new">gimp_prop_enum_stock_box_new</a> (GObject *config,
115
const gchar *property_name,
116
const gchar *stock_prefix,
119
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-expander-new">gimp_prop_expander_new</a> (GObject *config,
120
const gchar *property_name,
122
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-file-chooser-button-new">gimp_prop_file_chooser_button_new</a> (GObject *config,
123
const gchar *property_name,
125
GtkFileChooserAction action);
126
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-file-chooser-button-new-with-dialog">gimp_prop_file_chooser_button_new_with_dialog</a>
128
const gchar *property_name,
130
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-hscale-new">gimp_prop_hscale_new</a> (GObject *config,
131
const gchar *property_name,
132
gdouble step_increment,
133
gdouble page_increment,
135
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-int-combo-box-new">gimp_prop_int_combo_box_new</a> (GObject *config,
136
const gchar *property_name,
137
<a href="GimpIntStore.html" title="GimpIntStore">GimpIntStore</a> *store);
138
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-label-new">gimp_prop_label_new</a> (GObject *config,
139
const gchar *property_name);
140
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-memsize-entry-new">gimp_prop_memsize_entry_new</a> (GObject *config,
141
const gchar *property_name);
142
GtkObject* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-opacity-entry-new">gimp_prop_opacity_entry_new</a> (GObject *config,
143
const gchar *property_name,
148
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-path-editor-new">gimp_prop_path_editor_new</a> (GObject *config,
149
const gchar *path_property_name,
150
const gchar *writable_property_name,
151
const gchar *filesel_title);
152
GtkObject* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-scale-entry-new">gimp_prop_scale_entry_new</a> (GObject *config,
153
const gchar *property_name,
158
gdouble step_increment,
159
gdouble page_increment,
161
gboolean limit_scale,
163
gdouble upper_limit);
164
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-size-entry-new">gimp_prop_size_entry_new</a> (GObject *config,
165
const gchar *property_name,
166
const gchar *unit_property_name,
167
const gchar *unit_format,
168
<a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy,
170
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-spin-button-new">gimp_prop_spin_button_new</a> (GObject *config,
171
const gchar *property_name,
172
gdouble step_increment,
173
gdouble page_increment,
175
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-stock-image-new">gimp_prop_stock_image_new</a> (GObject *config,
176
const gchar *property_name,
177
GtkIconSize icon_size);
178
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-string-combo-box-new">gimp_prop_string_combo_box_new</a> (GObject *config,
179
const gchar *property_name,
183
GtkTextBuffer* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-text-buffer-new">gimp_prop_text_buffer_new</a> (GObject *config,
184
const gchar *property_name,
186
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-unit-menu-new">gimp_prop_unit_menu_new</a> (GObject *config,
187
const gchar *property_name,
188
const gchar *unit_format);
191
<div class="refsect1" lang="en">
192
<a name="id2669367"></a><h2>Description</h2>
197
<div class="refsect1" lang="en">
198
<a name="id2669383"></a><h2>Details</h2>
199
<div class="refsect2" lang="en">
200
<a name="id2669393"></a><h3>
201
<a name="gimp-prop-boolean-combo-box-new"></a>gimp_prop_boolean_combo_box_new ()</h3>
202
<a class="indexterm" name="id2669407"></a><pre class="programlisting">GtkWidget* gimp_prop_boolean_combo_box_new (GObject *config,
203
const gchar *property_name,
204
const gchar *true_text,
205
const gchar *false_text);</pre>
207
Creates a <span class="type">GtkComboBox</span> widget to display and set the specified
208
boolean property. The combo box will have two entries, one
209
displaying the <em class="parameter"><code>true_text</code></em> label, the other displaying the
210
<em class="parameter"><code>false_text</code></em> label.</p>
214
<div class="variablelist"><table border="0">
215
<col align="left" valign="top">
218
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
219
<td> Object to which property is attached.
223
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
224
<td> Name of boolean property controlled by combo box.
228
<td><span class="term"><em class="parameter"><code>true_text</code></em> :</span></td>
229
<td> Label used for entry corresponding to <code class="literal">TRUE</code> value.
233
<td><span class="term"><em class="parameter"><code>false_text</code></em> :</span></td>
234
<td> Label used for entry corresponding to <code class="literal">FALSE</code> value.
238
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
239
<td> The newly created <span class="type">GtkComboBox</span> widget, optionally
240
wrapped into a <span class="type">GtkEventBox</span>..
249
<div class="refsect2" lang="en">
250
<a name="id2669588"></a><h3>
251
<a name="gimp-prop-boolean-radio-frame-new"></a>gimp_prop_boolean_radio_frame_new ()</h3>
252
<a class="indexterm" name="id2669601"></a><pre class="programlisting">GtkWidget* gimp_prop_boolean_radio_frame_new (GObject *config,
253
const gchar *property_name,
255
const gchar *true_text,
256
const gchar *false_text);</pre>
258
Creates a pair of radio buttons which function to set and display
259
the specified boolean property.</p>
263
<div class="variablelist"><table border="0">
264
<col align="left" valign="top">
267
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
268
<td> Object to which property is attached.
272
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
273
<td> Name of boolean property controlled by the radio buttons.
277
<td><span class="term"><em class="parameter"><code>title</code></em> :</span></td>
278
<td> Label for the frame.
282
<td><span class="term"><em class="parameter"><code>true_text</code></em> :</span></td>
283
<td> Label for the button corresponding to <code class="literal">TRUE</code>.
287
<td><span class="term"><em class="parameter"><code>false_text</code></em> :</span></td>
288
<td> Label for the button corresponding to <code class="literal">FALSE</code>.
292
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
293
<td> A <a href="GimpFrame.html" title="GimpFrame"><span class="type">GimpFrame</span></a> containing the radio buttons.
302
<div class="refsect2" lang="en">
303
<a name="id2669777"></a><h3>
304
<a name="gimp-prop-check-button-new"></a>gimp_prop_check_button_new ()</h3>
305
<a class="indexterm" name="id2669789"></a><pre class="programlisting">GtkWidget* gimp_prop_check_button_new (GObject *config,
306
const gchar *property_name,
307
const gchar *label);</pre>
309
Creates a <span class="type">GtkCheckButton</span> that displays and sets the specified
310
boolean property.</p>
314
<div class="variablelist"><table border="0">
315
<col align="left" valign="top">
318
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
319
<td> Object to which property is attached.
323
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
324
<td> Name of boolean property controlled by checkbutton.
328
<td><span class="term"><em class="parameter"><code>label</code></em> :</span></td>
329
<td> Label to give checkbutton (including mnemonic).
333
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
334
<td> The newly created <span class="type">GtkCheckButton</span> widget.
343
<div class="refsect2" lang="en">
344
<a name="id2669909"></a><h3>
345
<a name="gimp-prop-color-area-new"></a>gimp_prop_color_area_new ()</h3>
346
<a class="indexterm" name="id2669920"></a><pre class="programlisting">GtkWidget* gimp_prop_color_area_new (GObject *config,
347
const gchar *property_name,
350
<a href="GimpColorArea.html#GimpColorAreaType">GimpColorAreaType</a> type);</pre>
352
Creates a <a href="GimpColorArea.html" title="GimpColorArea"><span class="type">GimpColorArea</span></a> to set and display the value of an RGB
357
<div class="variablelist"><table border="0">
358
<col align="left" valign="top">
361
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
362
<td> Object to which property is attached.
366
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
367
<td> Name of RGB property.
371
<td><span class="term"><em class="parameter"><code>width</code></em> :</span></td>
372
<td> Width of color area.
376
<td><span class="term"><em class="parameter"><code>height</code></em> :</span></td>
377
<td> Height of color area.
381
<td><span class="term"><em class="parameter"><code>type</code></em> :</span></td>
382
<td> How transparency is represented.
386
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
387
<td> A new <a href="GimpColorArea.html" title="GimpColorArea"><span class="type">GimpColorArea</span></a> widget.
396
<div class="refsect2" lang="en">
397
<a name="id2670083"></a><h3>
398
<a name="gimp-prop-coordinates-connect"></a>gimp_prop_coordinates_connect ()</h3>
399
<a class="indexterm" name="id2670096"></a><pre class="programlisting">gboolean gimp_prop_coordinates_connect (GObject *config,
400
const gchar *x_property_name,
401
const gchar *y_property_name,
402
const gchar *unit_property_name,
403
GtkWidget *sizeentry,
404
GtkWidget *chainbutton,
406
gdouble yresolution);</pre>
410
<div class="variablelist"><table border="0">
411
<col align="left" valign="top">
414
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
419
<td><span class="term"><em class="parameter"><code>x_property_name</code></em> :</span></td>
424
<td><span class="term"><em class="parameter"><code>y_property_name</code></em> :</span></td>
429
<td><span class="term"><em class="parameter"><code>unit_property_name</code></em> :</span></td>
434
<td><span class="term"><em class="parameter"><code>sizeentry</code></em> :</span></td>
439
<td><span class="term"><em class="parameter"><code>chainbutton</code></em> :</span></td>
444
<td><span class="term"><em class="parameter"><code>xresolution</code></em> :</span></td>
449
<td><span class="term"><em class="parameter"><code>yresolution</code></em> :</span></td>
454
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
464
<div class="refsect2" lang="en">
465
<a name="id2670303"></a><h3>
466
<a name="gimp-prop-coordinates-new"></a>gimp_prop_coordinates_new ()</h3>
467
<a class="indexterm" name="id2670315"></a><pre class="programlisting">GtkWidget* gimp_prop_coordinates_new (GObject *config,
468
const gchar *x_property_name,
469
const gchar *y_property_name,
470
const gchar *unit_property_name,
471
const gchar *unit_format,
472
<a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy,
475
gboolean has_chainbutton);</pre>
477
Creates a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> to set and display two double or int
478
properties, which will usually represent X and Y coordinates, and
479
their associated unit property.</p>
483
<div class="variablelist"><table border="0">
484
<col align="left" valign="top">
487
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
488
<td> Object to which property is attached.
492
<td><span class="term"><em class="parameter"><code>x_property_name</code></em> :</span></td>
493
<td> Name of int or double property for X coordinate.
497
<td><span class="term"><em class="parameter"><code>y_property_name</code></em> :</span></td>
498
<td> Name of int or double property for Y coordinate.
502
<td><span class="term"><em class="parameter"><code>unit_property_name</code></em> :</span></td>
503
<td> Name of unit property.
507
<td><span class="term"><em class="parameter"><code>unit_format</code></em> :</span></td>
508
<td> A printf-like unit-format string as is used with
509
<a href="GimpUnitMenu.html#gimp-unit-menu-new"><code class="function">gimp_unit_menu_new()</code></a>.
513
<td><span class="term"><em class="parameter"><code>update_policy</code></em> :</span></td>
514
<td> How the automatic pixel <-> real-world-unit
515
calculations should be done.
519
<td><span class="term"><em class="parameter"><code>xresolution</code></em> :</span></td>
520
<td> The resolution (in dpi) for the X coordinate.
524
<td><span class="term"><em class="parameter"><code>yresolution</code></em> :</span></td>
525
<td> The resolution (in dpi) for the Y coordinate.
529
<td><span class="term"><em class="parameter"><code>has_chainbutton</code></em> :</span></td>
530
<td> Whether to add a chainbutton to the size entry.
534
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
535
<td> A new <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget.
544
<div class="refsect2" lang="en">
545
<a name="id2670547"></a><h3>
546
<a name="gimp-prop-entry-new"></a>gimp_prop_entry_new ()</h3>
547
<a class="indexterm" name="id2670558"></a><pre class="programlisting">GtkWidget* gimp_prop_entry_new (GObject *config,
548
const gchar *property_name,
551
Creates a <span class="type">GtkEntry</span> to set and display the value of the specified
556
<div class="variablelist"><table border="0">
557
<col align="left" valign="top">
560
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
561
<td> Object to which property is attached.
565
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
566
<td> Name of string property.
570
<td><span class="term"><em class="parameter"><code>max_len</code></em> :</span></td>
571
<td> Maximum allowed length of string.
575
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
576
<td> A new <span class="type">GtkEntry</span> widget.
585
<div class="refsect2" lang="en">
586
<a name="id2670665"></a><h3>
587
<a name="gimp-prop-enum-check-button-new"></a>gimp_prop_enum_check_button_new ()</h3>
588
<a class="indexterm" name="id2670678"></a><pre class="programlisting">GtkWidget* gimp_prop_enum_check_button_new (GObject *config,
589
const gchar *property_name,
592
gint true_value);</pre>
594
Creates a <span class="type">GtkCheckButton</span> that displays and sets the specified
595
property of type Enum. Note that this widget only allows two values
596
for the enum, one corresponding to the "checked" state and the
597
other to the "unchecked" state.</p>
601
<div class="variablelist"><table border="0">
602
<col align="left" valign="top">
605
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
606
<td> Object to which property is attached.
610
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
611
<td> Name of enum property controlled by checkbutton.
615
<td><span class="term"><em class="parameter"><code>label</code></em> :</span></td>
616
<td> Label to give checkbutton (including mnemonic).
620
<td><span class="term"><em class="parameter"><code>false_value</code></em> :</span></td>
621
<td> Enum value corresponding to unchecked state.
625
<td><span class="term"><em class="parameter"><code>true_value</code></em> :</span></td>
626
<td> Enum value corresonding to checked state.
630
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
631
<td> The newly created <span class="type">GtkCheckButton</span> widget.
640
<div class="refsect2" lang="en">
641
<a name="id2670829"></a><h3>
642
<a name="gimp-prop-enum-combo-box-new"></a>gimp_prop_enum_combo_box_new ()</h3>
643
<a class="indexterm" name="id2670842"></a><pre class="programlisting">GtkWidget* gimp_prop_enum_combo_box_new (GObject *config,
644
const gchar *property_name,
648
Creates a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget to display and set the specified
649
enum property. The <em class="parameter"><code>mimimum_value</code></em> and <em class="parameter"><code>maximum_value</code></em> give the
650
possibility of restricting the allowed range to a subset of the
651
enum. If the two values are equal (e.g., 0, 0), then the full
652
range of the Enum is used.</p>
656
<div class="variablelist"><table border="0">
657
<col align="left" valign="top">
660
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
661
<td> Object to which property is attached.
665
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
666
<td> Name of enum property controlled by combo box.
670
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
671
<td> Smallest allowed value of enum.
675
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
676
<td> Largest allowed value of enum.
680
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
681
<td> The newly created <a href="GimpEnumComboBox.html" title="GimpEnumComboBox"><span class="type">GimpEnumComboBox</span></a> widget, optionally
682
wrapped into a <span class="type">GtkEventBox</span>.
691
<div class="refsect2" lang="en">
692
<a name="id2670991"></a><h3>
693
<a name="gimp-prop-enum-label-new"></a>gimp_prop_enum_label_new ()</h3>
694
<a class="indexterm" name="id2671001"></a><pre class="programlisting">GtkWidget* gimp_prop_enum_label_new (GObject *config,
695
const gchar *property_name);</pre>
701
<div class="variablelist"><table border="0">
702
<col align="left" valign="top">
705
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
706
<td> Object to which property is attached.
710
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
711
<td> Name of enum property to be displayed.
715
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
716
<td> The newly created <a href="GimpEnumLabel.html" title="GimpEnumLabel"><span class="type">GimpEnumLabel</span></a> widget.
725
<div class="refsect2" lang="en">
726
<a name="id2671082"></a><h3>
727
<a name="gimp-prop-enum-radio-box-new"></a>gimp_prop_enum_radio_box_new ()</h3>
728
<a class="indexterm" name="id2671094"></a><pre class="programlisting">GtkWidget* gimp_prop_enum_radio_box_new (GObject *config,
729
const gchar *property_name,
733
Creates a group of radio buttons which function to set and display
734
the specified enum property. The <em class="parameter"><code>minimum</code></em> and <em class="parameter"><code>maximum</code></em> arguments
735
allow only a subset of the enum to be used. If the two arguments
736
are equal (e.g., 0, 0), then the full range of the enum will be used.
737
If you want to assign a label to the group of radio buttons, use
738
<a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-radio-frame-new"><code class="function">gimp_prop_enum_radio_frame_new()</code></a> instead of this function.</p>
742
<div class="variablelist"><table border="0">
743
<col align="left" valign="top">
746
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
747
<td> Object to which property is attached.
751
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
752
<td> Name of enum property controlled by the radio buttons.
756
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
757
<td> Smallest value of enum to be included.
761
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
762
<td> Largest value of enum to be included.
766
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
767
<td> A <span class="type">GtkVBox</span> containing the radio buttons.
776
<div class="refsect2" lang="en">
777
<a name="id2671243"></a><h3>
778
<a name="gimp-prop-enum-radio-frame-new"></a>gimp_prop_enum_radio_frame_new ()</h3>
779
<a class="indexterm" name="id2671255"></a><pre class="programlisting">GtkWidget* gimp_prop_enum_radio_frame_new (GObject *config,
780
const gchar *property_name,
785
Creates a group of radio buttons which function to set and display
786
the specified enum property. The <em class="parameter"><code>minimum</code></em> and <em class="parameter"><code>maximum</code></em> arguments
787
allow only a subset of the enum to be used. If the two arguments
788
are equal (e.g., 0, 0), then the full range of the enum will be used.</p>
792
<div class="variablelist"><table border="0">
793
<col align="left" valign="top">
796
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
797
<td> Object to which property is attached.
801
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
802
<td> Name of enum property controlled by the radio buttons.
806
<td><span class="term"><em class="parameter"><code>title</code></em> :</span></td>
807
<td> Label for the frame holding the buttons
811
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
812
<td> Smallest value of enum to be included.
816
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
817
<td> Largest value of enum to be included.
821
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
822
<td> A <a href="GimpFrame.html" title="GimpFrame"><span class="type">GimpFrame</span></a> containing the radio buttons.
831
<div class="refsect2" lang="en">
832
<a name="id2671413"></a><h3>
833
<a name="gimp-prop-enum-stock-box-new"></a>gimp_prop_enum_stock_box_new ()</h3>
834
<a class="indexterm" name="id2671425"></a><pre class="programlisting">GtkWidget* gimp_prop_enum_stock_box_new (GObject *config,
835
const gchar *property_name,
836
const gchar *stock_prefix,
840
Creates a horizontal box of radio buttons with stock icons, which
841
function to set and display the value of the specified Enum
842
property. The stock_id for each icon is created by appending the
843
enum_value's nick to the given <em class="parameter"><code>stock_prefix</code></em>. See
844
<a href="libgimpwidgets-GimpEnumWidgets.html#gimp-enum-stock-box-new"><code class="function">gimp_enum_stock_box_new()</code></a> for more information.</p>
848
<div class="variablelist"><table border="0">
849
<col align="left" valign="top">
852
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
853
<td> Object to which property is attached.
857
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
858
<td> Name of enum property controlled by the radio buttons.
862
<td><span class="term"><em class="parameter"><code>stock_prefix</code></em> :</span></td>
863
<td> The prefix of the group of stock ids to use.
867
<td><span class="term"><em class="parameter"><code>minimum</code></em> :</span></td>
868
<td> Smallest value of enum to be included.
872
<td><span class="term"><em class="parameter"><code>maximum</code></em> :</span></td>
873
<td> Largest value of enum to be included.
877
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
878
<td> A <span class="type">GimpEnumStockBox</span> containing the radio buttons.
887
<div class="refsect2" lang="en">
888
<a name="id2671585"></a><h3>
889
<a name="gimp-prop-expander-new"></a>gimp_prop_expander_new ()</h3>
890
<a class="indexterm" name="id2671596"></a><pre class="programlisting">GtkWidget* gimp_prop_expander_new (GObject *config,
891
const gchar *property_name,
892
const gchar *label);</pre>
894
Creates a <span class="type">GtkExpander</span> controlled by the specified boolean property.
895
A value of <code class="literal">TRUE</code> for the property corresponds to the expanded state
900
<div class="variablelist"><table border="0">
901
<col align="left" valign="top">
904
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
905
<td> Object to which property is attached.
909
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
910
<td> Name of boolean property.
914
<td><span class="term"><em class="parameter"><code>label</code></em> :</span></td>
915
<td> Label for expander.
919
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
920
<td> A new <span class="type">GtkExpander</span> widget.
929
<div class="refsect2" lang="en">
930
<a name="id2671712"></a><h3>
931
<a name="gimp-prop-file-chooser-button-new"></a>gimp_prop_file_chooser_button_new ()</h3>
932
<a class="indexterm" name="id2671726"></a><pre class="programlisting">GtkWidget* gimp_prop_file_chooser_button_new (GObject *config,
933
const gchar *property_name,
935
GtkFileChooserAction action);</pre>
937
Creates a <span class="type">GtkFileChooserButton</span> to edit the specified path property.
940
Note that <span class="type">GtkFileChooserButton</span> implements the <span class="type">GtkFileChooser</span>
941
interface; you can use the <span class="type">GtkFileChooser</span> API with it.</p>
945
<div class="variablelist"><table border="0">
946
<col align="left" valign="top">
949
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
950
<td> object to which property is attached.
954
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
955
<td> name of path property.
959
<td><span class="term"><em class="parameter"><code>title</code></em> :</span></td>
960
<td> the title of the browse dialog.
964
<td><span class="term"><em class="parameter"><code>action</code></em> :</span></td>
965
<td> the open mode for the widget.
969
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
970
<td> A new <span class="type">GtkFileChooserButton</span>.
979
<div class="refsect2" lang="en">
980
<a name="id2671875"></a><h3>
981
<a name="gimp-prop-file-chooser-button-new-with-dialog"></a>gimp_prop_file_chooser_button_new_with_dialog ()</h3>
982
<a class="indexterm" name="id2671888"></a><pre class="programlisting">GtkWidget* gimp_prop_file_chooser_button_new_with_dialog
984
const gchar *property_name,
985
GtkWidget *dialog);</pre>
987
Creates a <span class="type">GtkFileChooserButton</span> to edit the specified path property.
990
The button uses <em class="parameter"><code>dialog</code></em> as it's file-picking window. Note that <em class="parameter"><code>dialog</code></em>
991
must be a <span class="type">GtkFileChooserDialog</span> (or subclass) and must not have
992
<code class="literal">GTK_DIALOG_DESTROY_WITH_PARENT</code> set.
995
Note that <span class="type">GtkFileChooserButton</span> implements the <span class="type">GtkFileChooser</span>
996
interface; you can use the <span class="type">GtkFileChooser</span> API with it.</p>
1000
<div class="variablelist"><table border="0">
1001
<col align="left" valign="top">
1004
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1005
<td> object to which property is attached.
1009
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1010
<td> name of path property.
1014
<td><span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
1015
<td> the <span class="type">GtkFileChooserDialog</span> widget to use.
1019
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1020
<td> A new <span class="type">GtkFileChooserButton</span>.
1029
<div class="refsect2" lang="en">
1030
<a name="id2672056"></a><h3>
1031
<a name="gimp-prop-hscale-new"></a>gimp_prop_hscale_new ()</h3>
1032
<a class="indexterm" name="id2672067"></a><pre class="programlisting">GtkWidget* gimp_prop_hscale_new (GObject *config,
1033
const gchar *property_name,
1034
gdouble step_increment,
1035
gdouble page_increment,
1038
Creates a horizontal scale to control the value of the specified
1039
integer or double property.</p>
1043
<div class="variablelist"><table border="0">
1044
<col align="left" valign="top">
1047
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1048
<td> Object to which property is attached.
1052
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1053
<td> Name of integer or double property controlled by the scale.
1057
<td><span class="term"><em class="parameter"><code>step_increment</code></em> :</span></td>
1062
<td><span class="term"><em class="parameter"><code>page_increment</code></em> :</span></td>
1067
<td><span class="term"><em class="parameter"><code>digits</code></em> :</span></td>
1068
<td> Number of digits after decimal point to display.
1072
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1073
<td> A new <span class="type">GtkScale</span>.
1082
<div class="refsect2" lang="en">
1083
<a name="id2672208"></a><h3>
1084
<a name="gimp-prop-int-combo-box-new"></a>gimp_prop_int_combo_box_new ()</h3>
1085
<a class="indexterm" name="id2672219"></a><pre class="programlisting">GtkWidget* gimp_prop_int_combo_box_new (GObject *config,
1086
const gchar *property_name,
1087
<a href="GimpIntStore.html" title="GimpIntStore">GimpIntStore</a> *store);</pre>
1089
Creates a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget to display and set the specified
1090
property. The contents of the widget are determined by <em class="parameter"><code>store</code></em>,
1091
which should be created using <a href="GimpIntStore.html#gimp-int-store-new"><code class="function">gimp_int_store_new()</code></a>.</p>
1095
<div class="variablelist"><table border="0">
1096
<col align="left" valign="top">
1099
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1100
<td> Object to which property is attached.
1104
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1105
<td> Name of int property controlled by combo box.
1109
<td><span class="term"><em class="parameter"><code>store</code></em> :</span></td>
1110
<td> <a href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> holding list of labels, values, etc.
1114
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1115
<td> The newly created <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget, optionally
1116
wrapped into a <span class="type">GtkEventBox</span>.
1125
<div class="refsect2" lang="en">
1126
<a name="id2672356"></a><h3>
1127
<a name="gimp-prop-label-new"></a>gimp_prop_label_new ()</h3>
1128
<a class="indexterm" name="id2672366"></a><pre class="programlisting">GtkWidget* gimp_prop_label_new (GObject *config,
1129
const gchar *property_name);</pre>
1131
Creates a <span class="type">GtkLabel</span> to display the value of the specified property.
1132
The property should be a string property or at least transformable
1133
to a string. If the user should be able to edit the string, use
1134
<a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-entry-new"><code class="function">gimp_prop_entry_new()</code></a> instead.</p>
1138
<div class="variablelist"><table border="0">
1139
<col align="left" valign="top">
1142
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1143
<td> Object to which property is attached.
1147
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1148
<td> Name of string property.
1152
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1153
<td> A new <span class="type">GtkLabel</span> widget.
1162
<div class="refsect2" lang="en">
1163
<a name="id2672464"></a><h3>
1164
<a name="gimp-prop-memsize-entry-new"></a>gimp_prop_memsize_entry_new ()</h3>
1165
<a class="indexterm" name="id2672475"></a><pre class="programlisting">GtkWidget* gimp_prop_memsize_entry_new (GObject *config,
1166
const gchar *property_name);</pre>
1168
Creates a <a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry"><span class="type">GimpMemsizeEntry</span></a> (spin button and option menu) to set
1169
and display the value of the specified memsize property. See
1170
<a href="GimpMemsizeEntry.html#gimp-memsize-entry-new"><code class="function">gimp_memsize_entry_new()</code></a> for more information.</p>
1174
<div class="variablelist"><table border="0">
1175
<col align="left" valign="top">
1178
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1179
<td> Object to which property is attached.
1183
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1184
<td> Name of memsize property.
1188
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1189
<td> A new <a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry"><span class="type">GimpMemsizeEntry</span></a>.
1198
<div class="refsect2" lang="en">
1199
<a name="id2672571"></a><h3>
1200
<a name="gimp-prop-opacity-entry-new"></a>gimp_prop_opacity_entry_new ()</h3>
1201
<a class="indexterm" name="id2672582"></a><pre class="programlisting">GtkObject* gimp_prop_opacity_entry_new (GObject *config,
1202
const gchar *property_name,
1206
const gchar *label);</pre>
1208
Creates a <span class="type">GimpScaleEntry</span> (slider and spin button) to set and
1209
display the value of the specified double property, which should
1210
represent an "opacity" variable with range 0 to 100. See
1211
<a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new"><code class="function">gimp_scale_entry_new()</code></a> for more information.</p>
1215
<div class="variablelist"><table border="0">
1216
<col align="left" valign="top">
1219
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1220
<td> Object to which property is attached.
1224
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1225
<td> Name of double property controlled by the spin button.
1229
<td><span class="term"><em class="parameter"><code>table</code></em> :</span></td>
1230
<td> The <span class="type">GtkTable</span> the widgets will be attached to.
1234
<td><span class="term"><em class="parameter"><code>column</code></em> :</span></td>
1235
<td> The column to start with.
1239
<td><span class="term"><em class="parameter"><code>row</code></em> :</span></td>
1240
<td> The row to attach the widgets.
1244
<td><span class="term"><em class="parameter"><code>label</code></em> :</span></td>
1245
<td> The text for the <span class="type">GtkLabel</span> which will appear left of the
1246
<span class="type">GtkHScale</span>.
1250
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1251
<td> The <span class="type">GtkSpinButton</span>'s <span class="type">GtkAdjustment</span>.
1260
<div class="refsect2" lang="en">
1261
<a name="id2672785"></a><h3>
1262
<a name="gimp-prop-path-editor-new"></a>gimp_prop_path_editor_new ()</h3>
1263
<a class="indexterm" name="id2672796"></a><pre class="programlisting">GtkWidget* gimp_prop_path_editor_new (GObject *config,
1264
const gchar *path_property_name,
1265
const gchar *writable_property_name,
1266
const gchar *filesel_title);</pre>
1270
<div class="variablelist"><table border="0">
1271
<col align="left" valign="top">
1274
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1279
<td><span class="term"><em class="parameter"><code>path_property_name</code></em> :</span></td>
1284
<td><span class="term"><em class="parameter"><code>writable_property_name</code></em> :</span></td>
1289
<td><span class="term"><em class="parameter"><code>filesel_title</code></em> :</span></td>
1294
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1304
<div class="refsect2" lang="en">
1305
<a name="id2672904"></a><h3>
1306
<a name="gimp-prop-scale-entry-new"></a>gimp_prop_scale_entry_new ()</h3>
1307
<a class="indexterm" name="id2672916"></a><pre class="programlisting">GtkObject* gimp_prop_scale_entry_new (GObject *config,
1308
const gchar *property_name,
1313
gdouble step_increment,
1314
gdouble page_increment,
1316
gboolean limit_scale,
1317
gdouble lower_limit,
1318
gdouble upper_limit);</pre>
1320
Creates a <span class="type">GimpScaleEntry</span> (slider and spin button) to set and
1321
display the value of the specified double property. See
1322
<a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new"><code class="function">gimp_scale_entry_new()</code></a> for more information.</p>
1326
<div class="variablelist"><table border="0">
1327
<col align="left" valign="top">
1330
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1331
<td> Object to which property is attached.
1335
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1336
<td> Name of double property controlled by the spin button.
1340
<td><span class="term"><em class="parameter"><code>table</code></em> :</span></td>
1341
<td> The <span class="type">GtkTable</span> the widgets will be attached to.
1345
<td><span class="term"><em class="parameter"><code>column</code></em> :</span></td>
1346
<td> The column to start with.
1350
<td><span class="term"><em class="parameter"><code>row</code></em> :</span></td>
1351
<td> The row to attach the widgets.
1355
<td><span class="term"><em class="parameter"><code>label</code></em> :</span></td>
1356
<td> The text for the <span class="type">GtkLabel</span> which will appear left of
1357
the <span class="type">GtkHScale</span>.
1361
<td><span class="term"><em class="parameter"><code>step_increment</code></em> :</span></td>
1366
<td><span class="term"><em class="parameter"><code>page_increment</code></em> :</span></td>
1371
<td><span class="term"><em class="parameter"><code>digits</code></em> :</span></td>
1372
<td> Number of digits after decimal point to display.
1376
<td><span class="term"><em class="parameter"><code>limit_scale</code></em> :</span></td>
1377
<td> <code class="literal">TRUE</code> if the range of possible values of the
1378
GtkSpinButton should be the same as of the GtkHScale.
1382
<td><span class="term"><em class="parameter"><code>lower_limit</code></em> :</span></td>
1383
<td> The spinbutton's lower boundary if <em class="parameter"><code>limit_scale</code></em> is <code class="literal">FALSE</code>.
1387
<td><span class="term"><em class="parameter"><code>upper_limit</code></em> :</span></td>
1388
<td> The spinbutton's upper boundary if <em class="parameter"><code>limit_scale</code></em> is <code class="literal">FALSE</code>.
1392
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1393
<td> The <span class="type">GtkSpinButton</span>'s <span class="type">GtkAdjustment</span>.
1402
<div class="refsect2" lang="en">
1403
<a name="id2673305"></a><h3>
1404
<a name="gimp-prop-size-entry-new"></a>gimp_prop_size_entry_new ()</h3>
1405
<a class="indexterm" name="id2673319"></a><pre class="programlisting">GtkWidget* gimp_prop_size_entry_new (GObject *config,
1406
const gchar *property_name,
1407
const gchar *unit_property_name,
1408
const gchar *unit_format,
1409
<a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy,
1410
gdouble resolution);</pre>
1412
Creates a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> to set and display the specified double or
1413
int property, and its associated unit property. Note that this
1414
function is only suitable for creating a size entry holding a
1415
single value. Use <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-coordinates-new"><code class="function">gimp_prop_coordinates_new()</code></a> to create a size
1416
entry holding two values.</p>
1420
<div class="variablelist"><table border="0">
1421
<col align="left" valign="top">
1424
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1425
<td> Object to which property is attached.
1429
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1430
<td> Name of int or double property.
1434
<td><span class="term"><em class="parameter"><code>unit_property_name</code></em> :</span></td>
1435
<td> Name of unit property.
1439
<td><span class="term"><em class="parameter"><code>unit_format</code></em> :</span></td>
1440
<td> A printf-like unit-format string as is used with
1441
<a href="GimpUnitMenu.html#gimp-unit-menu-new"><code class="function">gimp_unit_menu_new()</code></a>.
1445
<td><span class="term"><em class="parameter"><code>update_policy</code></em> :</span></td>
1446
<td> How the automatic pixel <-> real-world-unit
1447
calculations should be done.
1451
<td><span class="term"><em class="parameter"><code>resolution</code></em> :</span></td>
1452
<td> The resolution (in dpi) for the field.
1456
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1457
<td> A new <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget.
1466
<div class="refsect2" lang="en">
1467
<a name="id2673531"></a><h3>
1468
<a name="gimp-prop-spin-button-new"></a>gimp_prop_spin_button_new ()</h3>
1469
<a class="indexterm" name="id2673545"></a><pre class="programlisting">GtkWidget* gimp_prop_spin_button_new (GObject *config,
1470
const gchar *property_name,
1471
gdouble step_increment,
1472
gdouble page_increment,
1475
Creates a spin button to set and display the value of the
1476
specified double property.</p>
1480
<div class="variablelist"><table border="0">
1481
<col align="left" valign="top">
1484
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1485
<td> Object to which property is attached.
1489
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1490
<td> Name of double property controlled by the spin button.
1494
<td><span class="term"><em class="parameter"><code>step_increment</code></em> :</span></td>
1499
<td><span class="term"><em class="parameter"><code>page_increment</code></em> :</span></td>
1504
<td><span class="term"><em class="parameter"><code>digits</code></em> :</span></td>
1505
<td> Number of digits after decimal point to display.
1509
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1510
<td> A new <span class="type">GimpSpinButton</span>.
1519
<div class="refsect2" lang="en">
1520
<a name="id2673703"></a><h3>
1521
<a name="gimp-prop-stock-image-new"></a>gimp_prop_stock_image_new ()</h3>
1522
<a class="indexterm" name="id2673717"></a><pre class="programlisting">GtkWidget* gimp_prop_stock_image_new (GObject *config,
1523
const gchar *property_name,
1524
GtkIconSize icon_size);</pre>
1526
Creates a widget to display a stock image representing the value of the
1527
specified string property, which should encode a Stock ID.
1528
See <code class="function">gtk_image_new_from_stock()</code> for more information.</p>
1532
<div class="variablelist"><table border="0">
1533
<col align="left" valign="top">
1536
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1537
<td> Object to which property is attached.
1541
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1542
<td> Name of string property.
1546
<td><span class="term"><em class="parameter"><code>icon_size</code></em> :</span></td>
1547
<td> Size of desired stock image.
1551
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1552
<td> A new <span class="type">GtkImage</span> widget.
1561
<div class="refsect2" lang="en">
1562
<a name="id2673841"></a><h3>
1563
<a name="gimp-prop-string-combo-box-new"></a>gimp_prop_string_combo_box_new ()</h3>
1564
<a class="indexterm" name="id2673855"></a><pre class="programlisting">GtkWidget* gimp_prop_string_combo_box_new (GObject *config,
1565
const gchar *property_name,
1566
GtkTreeModel *model,
1568
gint label_column);</pre>
1570
Creates a <a href="GimpStringComboBox.html" title="GimpStringComboBox"><span class="type">GimpStringComboBox</span></a> widget to display and set the
1571
specified property. The contents of the widget are determined by
1572
<em class="parameter"><code>store</code></em>.</p>
1576
<div class="variablelist"><table border="0">
1577
<col align="left" valign="top">
1580
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1581
<td> Object to which property is attached.
1585
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1586
<td> Name of int property controlled by combo box.
1590
<td><span class="term"><em class="parameter"><code>model</code></em> :</span></td>
1591
<td> <span class="type">GtkTreeStore</span> holding list of values
1595
<td><span class="term"><em class="parameter"><code>id_column</code></em> :</span></td>
1596
<td> column in <em class="parameter"><code>store</code></em> that holds string IDs
1600
<td><span class="term"><em class="parameter"><code>label_column</code></em> :</span></td>
1601
<td> column in <em class="parameter"><code>store</code></em> that holds labels to use in the combo-box
1605
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1606
<td> The newly created <a href="GimpStringComboBox.html" title="GimpStringComboBox"><span class="type">GimpStringComboBox</span></a> widget, optionally
1607
wrapped into a <span class="type">GtkEventBox</span>.
1616
<div class="refsect2" lang="en">
1617
<a name="id2674054"></a><h3>
1618
<a name="gimp-prop-text-buffer-new"></a>gimp_prop_text_buffer_new ()</h3>
1619
<a class="indexterm" name="id2674069"></a><pre class="programlisting">GtkTextBuffer* gimp_prop_text_buffer_new (GObject *config,
1620
const gchar *property_name,
1621
gint max_len);</pre>
1623
Creates a <span class="type">GtkTextBuffer</span> to set and display the value of the
1624
specified string property. Unless the string is expected to
1625
contain multiple lines or a large amount of text, use
1626
<a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-entry-new"><code class="function">gimp_prop_entry_new()</code></a> instead. See <span class="type">GtkTextView</span> for information on
1627
how to insert a text buffer into a visible widget.
1630
If <em class="parameter"><code>max_len</code></em> is 0 or negative, the text buffer allows an unlimited
1631
number of characters to be entered.</p>
1635
<div class="variablelist"><table border="0">
1636
<col align="left" valign="top">
1639
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1640
<td> Object to which property is attached.
1644
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1645
<td> Name of string property.
1649
<td><span class="term"><em class="parameter"><code>max_len</code></em> :</span></td>
1650
<td> Maximum allowed length of text (in characters).
1654
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1655
<td> A new <span class="type">GtkTextBuffer</span>.
1664
<div class="refsect2" lang="en">
1665
<a name="id2674220"></a><h3>
1666
<a name="gimp-prop-unit-menu-new"></a>gimp_prop_unit_menu_new ()</h3>
1667
<a class="indexterm" name="id2674234"></a><pre class="programlisting">GtkWidget* gimp_prop_unit_menu_new (GObject *config,
1668
const gchar *property_name,
1669
const gchar *unit_format);</pre>
1671
Creates a <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a> to set and display the value of a Unit
1672
property. See <a href="GimpUnitMenu.html#gimp-unit-menu-new"><code class="function">gimp_unit_menu_new()</code></a> for more information.</p>
1676
<div class="variablelist"><table border="0">
1677
<col align="left" valign="top">
1680
<td><span class="term"><em class="parameter"><code>config</code></em> :</span></td>
1681
<td> Object to which property is attached.
1685
<td><span class="term"><em class="parameter"><code>property_name</code></em> :</span></td>
1686
<td> Name of Unit property.
1690
<td><span class="term"><em class="parameter"><code>unit_format</code></em> :</span></td>
1691
<td> A printf-like format string which is used to create
1696
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1697
<td> A new <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a> widget.