← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/gimp/oneiric

« back to all changes in this revision

Viewing changes to devel-docs/libgimpwidgets/xml/gimpwidgets.xml

  • Committer: Bazaar Package Importer
  • Author(s): Robert Ancell
  • Date: 2009-08-31 10:24:10 UTC
  • mfrom: (1.1.21 upstream) (0.1.5 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090831102410-eqawgw6fhdyi91ee
Tags: 2.6.7-1ubuntu1
https://launchpad.net/bugs/419593
* Merge with Debian unstable (LP: #419593), remaining changes:
  - debian/patches/02_help-message.patch,
    debian/patches/03_gimp.desktop.in.in.patch:
    + updated some strings for ubuntu
  - debian/rules:
    + updated translation templates
  - debian/control:
    + Drop webkit build dependency. gimp is the only thing pulling in webkit
      for the desktop CDs, and makes them explode. Without the webkit help
      browser plugin, help will just be displayed in the default browser.
* debian/patches/01_debian-gimprc.patch:
  - Updated
* debian/control:
  - Added a BZR link

Show diffs side-by-side

added added

removed removed

Lines of Context:
devel-docs/libgimpwidgets/xml/gimpwidgets.xml
13
13
<refname>GimpWidgets</refname>
14
14
<refpurpose>A collection of convenient widget constructors, standard callbacks and
15
15
helper functions.</refpurpose>
16
 
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
17
16
</refnamediv>
18
17
 
19
18
<refsynopsisdiv id="libgimpwidgets-GimpWidgets.synopsis" role="synopsis">
20
19
<title role="synopsis.title">Synopsis</title>
21
20
 
22
21
<synopsis>
23
 
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-radio-group-new">gimp_radio_group_new</link>                (<link linkend="gboolean">gboolean</link> in_frame,
 
22
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gimp-radio-group-new">gimp_radio_group_new</link>                (<link linkend="gboolean">gboolean</link> in_frame,
24
23
                                                         const <link linkend="gchar">gchar</link> *frame_title,
25
24
                                                         ...);
26
 
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-radio-group-new2">gimp_radio_group_new2</link>               (<link linkend="gboolean">gboolean</link> in_frame,
 
25
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gimp-radio-group-new2">gimp_radio_group_new2</link>               (<link linkend="gboolean">gboolean</link> in_frame,
27
26
                                                         const <link linkend="gchar">gchar</link> *frame_title,
28
27
                                                         <link linkend="GCallback">GCallback</link> radio_button_callback,
29
28
                                                         <link linkend="gpointer">gpointer</link> radio_button_callback_data,
31
30
                                                         ...);
32
31
<link linkend="void">void</link>                <link linkend="gimp-radio-group-set-active">gimp_radio_group_set_active</link>         (<link linkend="GtkRadioButton">GtkRadioButton</link> *radio_button,
33
32
                                                         <link linkend="gpointer">gpointer</link> item_data);
34
 
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-int-radio-group-new">gimp_int_radio_group_new</link>            (<link linkend="gboolean">gboolean</link> in_frame,
 
33
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gimp-int-radio-group-new">gimp_int_radio_group_new</link>            (<link linkend="gboolean">gboolean</link> in_frame,
35
34
                                                         const <link linkend="gchar">gchar</link> *frame_title,
36
35
                                                         <link linkend="GCallback">GCallback</link> radio_button_callback,
37
36
                                                         <link linkend="gpointer">gpointer</link> radio_button_callback_data,
39
38
                                                         ...);
40
39
<link linkend="void">void</link>                <link linkend="gimp-int-radio-group-set-active">gimp_int_radio_group_set_active</link>     (<link linkend="GtkRadioButton">GtkRadioButton</link> *radio_button,
41
40
                                                         <link linkend="gint">gint</link> item_data);
42
 
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-spin-button-new">gimp_spin_button_new</link>                (<link linkend="GtkObject">GtkObject</link> **adjustment,
 
41
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gimp-spin-button-new">gimp_spin_button_new</link>                (<link linkend="GtkObject">GtkObject</link> **adjustment,
43
42
                                                         <link linkend="gdouble">gdouble</link> value,
44
43
                                                         <link linkend="gdouble">gdouble</link> lower,
45
44
                                                         <link linkend="gdouble">gdouble</link> upper,
48
47
                                                         <link linkend="gdouble">gdouble</link> page_size,
49
48
                                                         <link linkend="gdouble">gdouble</link> climb_rate,
50
49
                                                         <link linkend="guint">guint</link> digits);
51
 
#define             <link linkend="GIMP-SCALE-ENTRY-LABEL:CAPS">GIMP_SCALE_ENTRY_LABEL</link>              (adj)
52
 
#define             <link linkend="GIMP-SCALE-ENTRY-SCALE:CAPS">GIMP_SCALE_ENTRY_SCALE</link>              (adj)
53
 
#define             <link linkend="GIMP-SCALE-ENTRY-SCALE-ADJ:CAPS">GIMP_SCALE_ENTRY_SCALE_ADJ</link>          (adj)
54
 
#define             <link linkend="GIMP-SCALE-ENTRY-SPINBUTTON:CAPS">GIMP_SCALE_ENTRY_SPINBUTTON</link>         (adj)
55
 
#define             <link linkend="GIMP-SCALE-ENTRY-SPINBUTTON-ADJ:CAPS">GIMP_SCALE_ENTRY_SPINBUTTON_ADJ</link>     (adj)
56
 
<link linkend="GtkObject">GtkObject</link>*          <link linkend="gimp-scale-entry-new">gimp_scale_entry_new</link>                (<link linkend="GtkTable">GtkTable</link> *table,
 
50
#define             <link linkend="GIMP-SCALE-ENTRY-LABEL--CAPS">GIMP_SCALE_ENTRY_LABEL</link>              (adj)
 
51
#define             <link linkend="GIMP-SCALE-ENTRY-SCALE--CAPS">GIMP_SCALE_ENTRY_SCALE</link>              (adj)
 
52
#define             <link linkend="GIMP-SCALE-ENTRY-SCALE-ADJ--CAPS">GIMP_SCALE_ENTRY_SCALE_ADJ</link>          (adj)
 
53
#define             <link linkend="GIMP-SCALE-ENTRY-SPINBUTTON--CAPS">GIMP_SCALE_ENTRY_SPINBUTTON</link>         (adj)
 
54
#define             <link linkend="GIMP-SCALE-ENTRY-SPINBUTTON-ADJ--CAPS">GIMP_SCALE_ENTRY_SPINBUTTON_ADJ</link>     (adj)
 
55
<link linkend="GtkObject">GtkObject</link> *         <link linkend="gimp-scale-entry-new">gimp_scale_entry_new</link>                (<link linkend="GtkTable">GtkTable</link> *table,
57
56
                                                         <link linkend="gint">gint</link> column,
58
57
                                                         <link linkend="gint">gint</link> row,
59
58
                                                         const <link linkend="gchar">gchar</link> *text,
75
74
<link linkend="void">void</link>                <link linkend="gimp-scale-entry-set-logarithmic">gimp_scale_entry_set_logarithmic</link>    (<link linkend="GtkObject">GtkObject</link> *adjustment,
76
75
                                                         <link linkend="gboolean">gboolean</link> logarithmic);
77
76
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-scale-entry-get-logarithmic">gimp_scale_entry_get_logarithmic</link>    (<link linkend="GtkObject">GtkObject</link> *adjustment);
78
 
<link linkend="GtkObject">GtkObject</link>*          <link linkend="gimp-color-scale-entry-new">gimp_color_scale_entry_new</link>          (<link linkend="GtkTable">GtkTable</link> *table,
 
77
<link linkend="GtkObject">GtkObject</link> *         <link linkend="gimp-color-scale-entry-new">gimp_color_scale_entry_new</link>          (<link linkend="GtkTable">GtkTable</link> *table,
79
78
                                                         <link linkend="gint">gint</link> column,
80
79
                                                         <link linkend="gint">gint</link> row,
81
80
                                                         const <link linkend="gchar">gchar</link> *text,
89
88
                                                         <link linkend="guint">guint</link> digits,
90
89
                                                         const <link linkend="gchar">gchar</link> *tooltip,
91
90
                                                         const <link linkend="gchar">gchar</link> *help_id);
92
 
#define             <link linkend="GIMP-RANDOM-SEED-SPINBUTTON:CAPS">GIMP_RANDOM_SEED_SPINBUTTON</link>         (hbox)
93
 
#define             <link linkend="GIMP-RANDOM-SEED-SPINBUTTON-ADJ:CAPS">GIMP_RANDOM_SEED_SPINBUTTON_ADJ</link>     (hbox)
94
 
#define             <link linkend="GIMP-RANDOM-SEED-TOGGLE:CAPS">GIMP_RANDOM_SEED_TOGGLE</link>             (hbox)
95
 
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-random-seed-new">gimp_random_seed_new</link>                (<link linkend="guint32">guint32</link> *seed,
 
91
#define             <link linkend="GIMP-RANDOM-SEED-SPINBUTTON--CAPS">GIMP_RANDOM_SEED_SPINBUTTON</link>         (hbox)
 
92
#define             <link linkend="GIMP-RANDOM-SEED-SPINBUTTON-ADJ--CAPS">GIMP_RANDOM_SEED_SPINBUTTON_ADJ</link>     (hbox)
 
93
#define             <link linkend="GIMP-RANDOM-SEED-TOGGLE--CAPS">GIMP_RANDOM_SEED_TOGGLE</link>             (hbox)
 
94
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gimp-random-seed-new">gimp_random_seed_new</link>                (<link linkend="guint32">guint32</link> *seed,
96
95
                                                         <link linkend="gboolean">gboolean</link> *random_seed);
97
 
#define             <link linkend="GIMP-COORDINATES-CHAINBUTTON:CAPS">GIMP_COORDINATES_CHAINBUTTON</link>        (sizeentry)
98
 
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-coordinates-new">gimp_coordinates_new</link>                (<link linkend="GimpUnit">GimpUnit</link> unit,
 
96
#define             <link linkend="GIMP-COORDINATES-CHAINBUTTON--CAPS">GIMP_COORDINATES_CHAINBUTTON</link>        (sizeentry)
 
97
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gimp-coordinates-new">gimp_coordinates_new</link>                (<link linkend="GimpUnit">GimpUnit</link> unit,
99
98
                                                         const <link linkend="gchar">gchar</link> *unit_format,
100
99
                                                         <link linkend="gboolean">gboolean</link> menu_show_pixels,
101
100
                                                         <link linkend="gboolean">gboolean</link> menu_show_percent,
117
116
                                                         <link linkend="gdouble">gdouble</link> upper_boundary_y,
118
117
                                                         <link linkend="gdouble">gdouble</link> ysize_0,
119
118
                                                         <link linkend="gdouble">gdouble</link> ysize_100);
120
 
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-pixmap-button-new">gimp_pixmap_button_new</link>              (<link linkend="gchar">gchar</link> **xpm_data,
 
119
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gimp-pixmap-button-new">gimp_pixmap_button_new</link>              (<link linkend="gchar">gchar</link> **xpm_data,
121
120
                                                         const <link linkend="gchar">gchar</link> *text);
122
121
<link linkend="void">void</link>                <link linkend="gimp-toggle-button-sensitive-update">gimp_toggle_button_sensitive_update</link> (<link linkend="GtkToggleButton">GtkToggleButton</link> *toggle_button);
123
122
<link linkend="void">void</link>                <link linkend="gimp-toggle-button-update">gimp_toggle_button_update</link>           (<link linkend="GtkWidget">GtkWidget</link> *widget,
134
133
                                                         <link linkend="gpointer">gpointer</link> data);
135
134
<link linkend="void">void</link>                <link linkend="gimp-unit-menu-update">gimp_unit_menu_update</link>               (<link linkend="GtkWidget">GtkWidget</link> *widget,
136
135
                                                         <link linkend="gpointer">gpointer</link> data);
137
 
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-table-attach-aligned">gimp_table_attach_aligned</link>           (<link linkend="GtkTable">GtkTable</link> *table,
 
136
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gimp-table-attach-aligned">gimp_table_attach_aligned</link>           (<link linkend="GtkTable">GtkTable</link> *table,
138
137
                                                         <link linkend="gint">gint</link> column,
139
138
                                                         <link linkend="gint">gint</link> row,
140
139
                                                         const <link linkend="gchar">gchar</link> *label_text,
159
158
<refsect1 id="libgimpwidgets-GimpWidgets.description" role="desc">
160
159
<title role="desc.title">Description</title>
161
160
<para>
162
 
 
163
161
</para>
164
162
</refsect1>
165
163
 
167
165
<title role="details.title">Details</title>
168
166
<refsect2 id="gimp-radio-group-new" role="function">
169
167
<title>gimp_radio_group_new ()</title>
170
 
<indexterm zone="gimp-radio-group-new"><primary>gimp_radio_group_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_radio_group_new                (<link linkend="gboolean">gboolean</link> in_frame,
 
168
<indexterm zone="gimp-radio-group-new"><primary sortas="gimp_radio_group_new">gimp_radio_group_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gimp_radio_group_new                (<link linkend="gboolean">gboolean</link> in_frame,
171
169
                                                         const <link linkend="gchar">gchar</link> *frame_title,
172
170
                                                         ...);</programlisting>
173
171
<para>
174
172
Convenience function to create a group of radio buttons embedded into
175
173
a <link linkend="GtkFrame"><type>GtkFrame</type></link> or <link linkend="GtkVbox"><type>GtkVbox</type></link>.</para>
176
174
<para>
177
 
 
178
175
</para><variablelist role="params">
179
 
<varlistentry><term><parameter>in_frame</parameter>&nbsp;:</term>
180
 
<listitem><simpara>    <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if you want a <link linkend="GtkFrame"><type>GtkFrame</type></link> around the radio button group.
181
 
</simpara></listitem></varlistentry>
182
 
<varlistentry><term><parameter>frame_title</parameter>&nbsp;:</term>
183
 
<listitem><simpara> The title of the Frame or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if you don't want a title.
184
 
</simpara></listitem></varlistentry>
185
 
<varlistentry><term><parameter>...</parameter>&nbsp;:</term>
186
 
<listitem><simpara>         A <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated <parameter>va_list</parameter> describing the radio buttons.
187
 
</simpara></listitem></varlistentry>
188
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A <link linkend="GtkFrame"><type>GtkFrame</type></link> or <link linkend="GtkVbox"><type>GtkVbox</type></link> (depending on <parameter>in_frame</parameter>).
 
176
<varlistentry><term><parameter>in_frame</parameter>&#160;:</term>
 
177
<listitem><simpara>    <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if you want a <link linkend="GtkFrame"><type>GtkFrame</type></link> around the radio button group.
 
178
</simpara></listitem></varlistentry>
 
179
<varlistentry><term><parameter>frame_title</parameter>&#160;:</term>
 
180
<listitem><simpara> The title of the Frame or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if you don't want a title.
 
181
</simpara></listitem></varlistentry>
 
182
<varlistentry><term><parameter>...</parameter>&#160;:</term>
 
183
<listitem><simpara>         A <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated <parameter>va_list</parameter> describing the radio buttons.
 
184
</simpara></listitem></varlistentry>
 
185
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GtkFrame"><type>GtkFrame</type></link> or <link linkend="GtkVbox"><type>GtkVbox</type></link> (depending on <parameter>in_frame</parameter>).
189
186
</simpara></listitem></varlistentry>
190
187
</variablelist></refsect2>
191
188
<refsect2 id="gimp-radio-group-new2" role="function">
192
189
<title>gimp_radio_group_new2 ()</title>
193
 
<indexterm zone="gimp-radio-group-new2"><primary>gimp_radio_group_new2</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_radio_group_new2               (<link linkend="gboolean">gboolean</link> in_frame,
 
190
<indexterm zone="gimp-radio-group-new2"><primary sortas="gimp_radio_group_new2">gimp_radio_group_new2</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gimp_radio_group_new2               (<link linkend="gboolean">gboolean</link> in_frame,
194
191
                                                         const <link linkend="gchar">gchar</link> *frame_title,
195
192
                                                         <link linkend="GCallback">GCallback</link> radio_button_callback,
196
193
                                                         <link linkend="gpointer">gpointer</link> radio_button_callback_data,
200
197
Convenience function to create a group of radio buttons embedded into
201
198
a <link linkend="GtkFrame"><type>GtkFrame</type></link> or <link linkend="GtkVbox"><type>GtkVbox</type></link>.</para>
202
199
<para>
203
 
 
204
200
</para><variablelist role="params">
205
 
<varlistentry><term><parameter>in_frame</parameter>&nbsp;:</term>
206
 
<listitem><simpara>              <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if you want a <link linkend="GtkFrame"><type>GtkFrame</type></link> around the
 
201
<varlistentry><term><parameter>in_frame</parameter>&#160;:</term>
 
202
<listitem><simpara>              <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if you want a <link linkend="GtkFrame"><type>GtkFrame</type></link> around the
207
203
                        radio button group.
208
204
</simpara></listitem></varlistentry>
209
 
<varlistentry><term><parameter>frame_title</parameter>&nbsp;:</term>
210
 
<listitem><simpara>           The title of the Frame or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if you don't want
 
205
<varlistentry><term><parameter>frame_title</parameter>&#160;:</term>
 
206
<listitem><simpara>           The title of the Frame or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if you don't want
211
207
                        a title.
212
208
</simpara></listitem></varlistentry>
213
 
<varlistentry><term><parameter>radio_button_callback</parameter>&nbsp;:</term>
 
209
<varlistentry><term><parameter>radio_button_callback</parameter>&#160;:</term>
214
210
<listitem><simpara> The callback each button's "toggled" signal will
215
211
                        be connected with.
216
212
</simpara></listitem></varlistentry>
217
 
<varlistentry><term><parameter>radio_button_callback_data</parameter>&nbsp;:</term>
 
213
<varlistentry><term><parameter>radio_button_callback_data</parameter>&#160;:</term>
218
214
<listitem><simpara>
219
215
                        The data which will be passed to <link linkend="g-signal-connect"><function>g_signal_connect()</function></link>.
220
216
</simpara></listitem></varlistentry>
221
 
<varlistentry><term><parameter>initial</parameter>&nbsp;:</term>
 
217
<varlistentry><term><parameter>initial</parameter>&#160;:</term>
222
218
<listitem><simpara>               The <parameter>item_data</parameter> of the initially pressed radio button.
223
219
</simpara></listitem></varlistentry>
224
 
<varlistentry><term><parameter>...</parameter>&nbsp;:</term>
225
 
<listitem><simpara>                   A <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated <parameter>va_list</parameter> describing
 
220
<varlistentry><term><parameter>...</parameter>&#160;:</term>
 
221
<listitem><simpara>                   A <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated <parameter>va_list</parameter> describing
226
222
                        the radio buttons.
227
223
</simpara></listitem></varlistentry>
228
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A <link linkend="GtkFrame"><type>GtkFrame</type></link> or <link linkend="GtkVbox"><type>GtkVbox</type></link> (depending on <parameter>in_frame</parameter>).
 
224
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GtkFrame"><type>GtkFrame</type></link> or <link linkend="GtkVbox"><type>GtkVbox</type></link> (depending on <parameter>in_frame</parameter>).
229
225
</simpara></listitem></varlistentry>
230
226
</variablelist></refsect2>
231
227
<refsect2 id="gimp-radio-group-set-active" role="function">
232
228
<title>gimp_radio_group_set_active ()</title>
233
 
<indexterm zone="gimp-radio-group-set-active"><primary>gimp_radio_group_set_active</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_radio_group_set_active         (<link linkend="GtkRadioButton">GtkRadioButton</link> *radio_button,
 
229
<indexterm zone="gimp-radio-group-set-active"><primary sortas="gimp_radio_group_set_active">gimp_radio_group_set_active</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_radio_group_set_active         (<link linkend="GtkRadioButton">GtkRadioButton</link> *radio_button,
234
230
                                                         <link linkend="gpointer">gpointer</link> item_data);</programlisting>
235
231
<para>
236
232
Calls <link linkend="gtk-toggle-button-set-active"><function>gtk_toggle_button_set_active()</function></link> with the radio button that was
237
233
created with a matching <parameter>item_data</parameter>.</para>
238
234
<para>
239
 
 
240
235
</para><variablelist role="params">
241
 
<varlistentry><term><parameter>radio_button</parameter>&nbsp;:</term>
 
236
<varlistentry><term><parameter>radio_button</parameter>&#160;:</term>
242
237
<listitem><simpara> Pointer to a <link linkend="GtkRadioButton"><type>GtkRadioButton</type></link>.
243
238
</simpara></listitem></varlistentry>
244
 
<varlistentry><term><parameter>item_data</parameter>&nbsp;:</term>
 
239
<varlistentry><term><parameter>item_data</parameter>&#160;:</term>
245
240
<listitem><simpara> The <parameter>item_data</parameter> of the radio button you want to select.
246
241
</simpara></listitem></varlistentry>
247
242
</variablelist></refsect2>
248
243
<refsect2 id="gimp-int-radio-group-new" role="function">
249
244
<title>gimp_int_radio_group_new ()</title>
250
 
<indexterm zone="gimp-int-radio-group-new"><primary>gimp_int_radio_group_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_int_radio_group_new            (<link linkend="gboolean">gboolean</link> in_frame,
 
245
<indexterm zone="gimp-int-radio-group-new"><primary sortas="gimp_int_radio_group_new">gimp_int_radio_group_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gimp_int_radio_group_new            (<link linkend="gboolean">gboolean</link> in_frame,
251
246
                                                         const <link linkend="gchar">gchar</link> *frame_title,
252
247
                                                         <link linkend="GCallback">GCallback</link> radio_button_callback,
253
248
                                                         <link linkend="gpointer">gpointer</link> radio_button_callback_data,
260
255
pointers, since that is a very common case (mapping an enum to a radio
261
256
group).</para>
262
257
<para>
263
 
 
264
258
</para><variablelist role="params">
265
 
<varlistentry><term><parameter>in_frame</parameter>&nbsp;:</term>
266
 
<listitem><simpara>              <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if you want a <link linkend="GtkFrame"><type>GtkFrame</type></link> around the
 
259
<varlistentry><term><parameter>in_frame</parameter>&#160;:</term>
 
260
<listitem><simpara>              <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if you want a <link linkend="GtkFrame"><type>GtkFrame</type></link> around the
267
261
                        radio button group.
268
262
</simpara></listitem></varlistentry>
269
 
<varlistentry><term><parameter>frame_title</parameter>&nbsp;:</term>
270
 
<listitem><simpara>           The title of the Frame or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if you don't want
 
263
<varlistentry><term><parameter>frame_title</parameter>&#160;:</term>
 
264
<listitem><simpara>           The title of the Frame or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if you don't want
271
265
                        a title.
272
266
</simpara></listitem></varlistentry>
273
 
<varlistentry><term><parameter>radio_button_callback</parameter>&nbsp;:</term>
 
267
<varlistentry><term><parameter>radio_button_callback</parameter>&#160;:</term>
274
268
<listitem><simpara> The callback each button's "toggled" signal will
275
269
                        be connected with.
276
270
</simpara></listitem></varlistentry>
277
 
<varlistentry><term><parameter>radio_button_callback_data</parameter>&nbsp;:</term>
 
271
<varlistentry><term><parameter>radio_button_callback_data</parameter>&#160;:</term>
278
272
<listitem><simpara>
279
273
                        The data which will be passed to <link linkend="g-signal-connect"><function>g_signal_connect()</function></link>.
280
274
</simpara></listitem></varlistentry>
281
 
<varlistentry><term><parameter>initial</parameter>&nbsp;:</term>
 
275
<varlistentry><term><parameter>initial</parameter>&#160;:</term>
282
276
<listitem><simpara>               The <parameter>item_data</parameter> of the initially pressed radio button.
283
277
</simpara></listitem></varlistentry>
284
 
<varlistentry><term><parameter>...</parameter>&nbsp;:</term>
285
 
<listitem><simpara>                   A <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated <parameter>va_list</parameter> describing
 
278
<varlistentry><term><parameter>...</parameter>&#160;:</term>
 
279
<listitem><simpara>                   A <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated <parameter>va_list</parameter> describing
286
280
                        the radio buttons.
287
281
</simpara></listitem></varlistentry>
288
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A <link linkend="GtkFrame"><type>GtkFrame</type></link> or <link linkend="GtkVbox"><type>GtkVbox</type></link> (depending on <parameter>in_frame</parameter>).
 
282
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GtkFrame"><type>GtkFrame</type></link> or <link linkend="GtkVbox"><type>GtkVbox</type></link> (depending on <parameter>in_frame</parameter>).
289
283
</simpara></listitem></varlistentry>
290
284
</variablelist></refsect2>
291
285
<refsect2 id="gimp-int-radio-group-set-active" role="function">
292
286
<title>gimp_int_radio_group_set_active ()</title>
293
 
<indexterm zone="gimp-int-radio-group-set-active"><primary>gimp_int_radio_group_set_active</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_int_radio_group_set_active     (<link linkend="GtkRadioButton">GtkRadioButton</link> *radio_button,
 
287
<indexterm zone="gimp-int-radio-group-set-active"><primary sortas="gimp_int_radio_group_set_active">gimp_int_radio_group_set_active</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_int_radio_group_set_active     (<link linkend="GtkRadioButton">GtkRadioButton</link> *radio_button,
294
288
                                                         <link linkend="gint">gint</link> item_data);</programlisting>
295
289
<para>
296
290
Calls <link linkend="gtk-toggle-button-set-active"><function>gtk_toggle_button_set_active()</function></link> with the radio button that was created
298
292
<link linkend="gimp-radio-group-set-active"><function>gimp_radio_group_set_active()</function></link>, but takes integers as <parameter>item_data</parameter> instead
299
293
of pointers.</para>
300
294
<para>
301
 
 
302
295
</para><variablelist role="params">
303
 
<varlistentry><term><parameter>radio_button</parameter>&nbsp;:</term>
 
296
<varlistentry><term><parameter>radio_button</parameter>&#160;:</term>
304
297
<listitem><simpara> Pointer to a <link linkend="GtkRadioButton"><type>GtkRadioButton</type></link>.
305
298
</simpara></listitem></varlistentry>
306
 
<varlistentry><term><parameter>item_data</parameter>&nbsp;:</term>
 
299
<varlistentry><term><parameter>item_data</parameter>&#160;:</term>
307
300
<listitem><simpara> The <parameter>item_data</parameter> of the radio button you want to select.
308
301
</simpara></listitem></varlistentry>
309
302
</variablelist></refsect2>
310
303
<refsect2 id="gimp-spin-button-new" role="function">
311
304
<title>gimp_spin_button_new ()</title>
312
 
<indexterm zone="gimp-spin-button-new"><primary>gimp_spin_button_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_spin_button_new                (<link linkend="GtkObject">GtkObject</link> **adjustment,
 
305
<indexterm zone="gimp-spin-button-new"><primary sortas="gimp_spin_button_new">gimp_spin_button_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gimp_spin_button_new                (<link linkend="GtkObject">GtkObject</link> **adjustment,
313
306
                                                         <link linkend="gdouble">gdouble</link> value,
314
307
                                                         <link linkend="gdouble">gdouble</link> lower,
315
308
                                                         <link linkend="gdouble">gdouble</link> upper,
324
317
<link linkend="gtk-spin-button-set-numeric"><function>gtk_spin_button_set_numeric()</function></link> so that non-numeric text cannot be
325
318
entered.</para>
326
319
<para>
327
 
 
328
320
</para><variablelist role="params">
329
 
<varlistentry><term><parameter>adjustment</parameter>&nbsp;:</term>
 
321
<varlistentry><term><parameter>adjustment</parameter>&#160;:</term>
330
322
<listitem><simpara>     Returns the spinbutton's <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
331
323
</simpara></listitem></varlistentry>
332
 
<varlistentry><term><parameter>value</parameter>&nbsp;:</term>
 
324
<varlistentry><term><parameter>value</parameter>&#160;:</term>
333
325
<listitem><simpara>          The initial value of the spinbutton.
334
326
</simpara></listitem></varlistentry>
335
 
<varlistentry><term><parameter>lower</parameter>&nbsp;:</term>
 
327
<varlistentry><term><parameter>lower</parameter>&#160;:</term>
336
328
<listitem><simpara>          The lower boundary.
337
329
</simpara></listitem></varlistentry>
338
 
<varlistentry><term><parameter>upper</parameter>&nbsp;:</term>
 
330
<varlistentry><term><parameter>upper</parameter>&#160;:</term>
339
331
<listitem><simpara>          The uppper boundary.
340
332
</simpara></listitem></varlistentry>
341
 
<varlistentry><term><parameter>step_increment</parameter>&nbsp;:</term>
 
333
<varlistentry><term><parameter>step_increment</parameter>&#160;:</term>
342
334
<listitem><simpara> The spinbutton's step increment.
343
335
</simpara></listitem></varlistentry>
344
 
<varlistentry><term><parameter>page_increment</parameter>&nbsp;:</term>
 
336
<varlistentry><term><parameter>page_increment</parameter>&#160;:</term>
345
337
<listitem><simpara> The spinbutton's page increment (mouse button 2).
346
338
</simpara></listitem></varlistentry>
347
 
<varlistentry><term><parameter>page_size</parameter>&nbsp;:</term>
 
339
<varlistentry><term><parameter>page_size</parameter>&#160;:</term>
348
340
<listitem><simpara>      The spinbutton's page size.
349
341
</simpara></listitem></varlistentry>
350
 
<varlistentry><term><parameter>climb_rate</parameter>&nbsp;:</term>
 
342
<varlistentry><term><parameter>climb_rate</parameter>&#160;:</term>
351
343
<listitem><simpara>     The spinbutton's climb rate.
352
344
</simpara></listitem></varlistentry>
353
 
<varlistentry><term><parameter>digits</parameter>&nbsp;:</term>
 
345
<varlistentry><term><parameter>digits</parameter>&#160;:</term>
354
346
<listitem><simpara>         The spinbutton's number of decimal digits.
355
347
</simpara></listitem></varlistentry>
356
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A <link linkend="GtkSpinbutton"><type>GtkSpinbutton</type></link> and it's <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
 
348
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GtkSpinbutton"><type>GtkSpinbutton</type></link> and it's <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
357
349
</simpara></listitem></varlistentry>
358
350
</variablelist></refsect2>
359
 
<refsect2 id="GIMP-SCALE-ENTRY-LABEL:CAPS" role="macro">
 
351
<refsect2 id="GIMP-SCALE-ENTRY-LABEL--CAPS" role="macro">
360
352
<title>GIMP_SCALE_ENTRY_LABEL()</title>
361
 
<indexterm zone="GIMP-SCALE-ENTRY-LABEL:CAPS"><primary>GIMP_SCALE_ENTRY_LABEL</primary></indexterm><programlisting>#define             GIMP_SCALE_ENTRY_LABEL(adj)</programlisting>
 
353
<indexterm zone="GIMP-SCALE-ENTRY-LABEL--CAPS"><primary sortas="GIMP_SCALE_ENTRY_LABEL">GIMP_SCALE_ENTRY_LABEL</primary></indexterm><programlisting>#define             GIMP_SCALE_ENTRY_LABEL(adj)</programlisting>
362
354
<para>
363
355
Returns the scale_entry's <link linkend="GtkLabel"><type>GtkLabel</type></link>.
364
356
</para><variablelist role="params">
365
 
<varlistentry><term><parameter>adj</parameter>&nbsp;:</term>
 
357
<varlistentry><term><parameter>adj</parameter>&#160;:</term>
366
358
<listitem><simpara>The <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> returned by <link linkend="gimp-scale-entry-new"><function>gimp_scale_entry_new()</function></link>.
367
 
 
368
 
 
369
359
</simpara></listitem></varlistentry>
370
360
</variablelist></refsect2>
371
 
<refsect2 id="GIMP-SCALE-ENTRY-SCALE:CAPS" role="macro">
 
361
<refsect2 id="GIMP-SCALE-ENTRY-SCALE--CAPS" role="macro">
372
362
<title>GIMP_SCALE_ENTRY_SCALE()</title>
373
 
<indexterm zone="GIMP-SCALE-ENTRY-SCALE:CAPS"><primary>GIMP_SCALE_ENTRY_SCALE</primary></indexterm><programlisting>#define             GIMP_SCALE_ENTRY_SCALE(adj)</programlisting>
 
363
<indexterm zone="GIMP-SCALE-ENTRY-SCALE--CAPS"><primary sortas="GIMP_SCALE_ENTRY_SCALE">GIMP_SCALE_ENTRY_SCALE</primary></indexterm><programlisting>#define             GIMP_SCALE_ENTRY_SCALE(adj)</programlisting>
374
364
<para>
375
365
Returns the scale_entry's <link linkend="GtkHScale"><type>GtkHScale</type></link>.
376
366
</para><variablelist role="params">
377
 
<varlistentry><term><parameter>adj</parameter>&nbsp;:</term>
 
367
<varlistentry><term><parameter>adj</parameter>&#160;:</term>
378
368
<listitem><simpara>The <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> returned by <link linkend="gimp-scale-entry-new"><function>gimp_scale_entry_new()</function></link>.
379
 
 
380
 
 
381
369
</simpara></listitem></varlistentry>
382
370
</variablelist></refsect2>
383
 
<refsect2 id="GIMP-SCALE-ENTRY-SCALE-ADJ:CAPS" role="macro">
 
371
<refsect2 id="GIMP-SCALE-ENTRY-SCALE-ADJ--CAPS" role="macro">
384
372
<title>GIMP_SCALE_ENTRY_SCALE_ADJ()</title>
385
 
<indexterm zone="GIMP-SCALE-ENTRY-SCALE-ADJ:CAPS"><primary>GIMP_SCALE_ENTRY_SCALE_ADJ</primary></indexterm><programlisting>#define             GIMP_SCALE_ENTRY_SCALE_ADJ(adj)</programlisting>
 
373
<indexterm zone="GIMP-SCALE-ENTRY-SCALE-ADJ--CAPS"><primary sortas="GIMP_SCALE_ENTRY_SCALE_ADJ">GIMP_SCALE_ENTRY_SCALE_ADJ</primary></indexterm><programlisting>#define             GIMP_SCALE_ENTRY_SCALE_ADJ(adj)</programlisting>
386
374
<para>
387
375
Returns the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> of the scale_entry's <link linkend="GtkHScale"><type>GtkHScale</type></link>.
388
376
</para><variablelist role="params">
389
 
<varlistentry><term><parameter>adj</parameter>&nbsp;:</term>
 
377
<varlistentry><term><parameter>adj</parameter>&#160;:</term>
390
378
<listitem><simpara>The <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> returned by <link linkend="gimp-scale-entry-new"><function>gimp_scale_entry_new()</function></link>.
391
 
 
392
 
 
393
379
</simpara></listitem></varlistentry>
394
380
</variablelist></refsect2>
395
 
<refsect2 id="GIMP-SCALE-ENTRY-SPINBUTTON:CAPS" role="macro">
 
381
<refsect2 id="GIMP-SCALE-ENTRY-SPINBUTTON--CAPS" role="macro">
396
382
<title>GIMP_SCALE_ENTRY_SPINBUTTON()</title>
397
 
<indexterm zone="GIMP-SCALE-ENTRY-SPINBUTTON:CAPS"><primary>GIMP_SCALE_ENTRY_SPINBUTTON</primary></indexterm><programlisting>#define             GIMP_SCALE_ENTRY_SPINBUTTON(adj)</programlisting>
 
383
<indexterm zone="GIMP-SCALE-ENTRY-SPINBUTTON--CAPS"><primary sortas="GIMP_SCALE_ENTRY_SPINBUTTON">GIMP_SCALE_ENTRY_SPINBUTTON</primary></indexterm><programlisting>#define             GIMP_SCALE_ENTRY_SPINBUTTON(adj)</programlisting>
398
384
<para>
399
385
Returns the scale_entry's <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>.
400
386
</para><variablelist role="params">
401
 
<varlistentry><term><parameter>adj</parameter>&nbsp;:</term>
 
387
<varlistentry><term><parameter>adj</parameter>&#160;:</term>
402
388
<listitem><simpara>The <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> returned by <link linkend="gimp-scale-entry-new"><function>gimp_scale_entry_new()</function></link>.
403
 
 
404
 
 
405
389
</simpara></listitem></varlistentry>
406
390
</variablelist></refsect2>
407
 
<refsect2 id="GIMP-SCALE-ENTRY-SPINBUTTON-ADJ:CAPS" role="macro">
 
391
<refsect2 id="GIMP-SCALE-ENTRY-SPINBUTTON-ADJ--CAPS" role="macro">
408
392
<title>GIMP_SCALE_ENTRY_SPINBUTTON_ADJ()</title>
409
 
<indexterm zone="GIMP-SCALE-ENTRY-SPINBUTTON-ADJ:CAPS"><primary>GIMP_SCALE_ENTRY_SPINBUTTON_ADJ</primary></indexterm><programlisting>#define             GIMP_SCALE_ENTRY_SPINBUTTON_ADJ(adj)</programlisting>
 
393
<indexterm zone="GIMP-SCALE-ENTRY-SPINBUTTON-ADJ--CAPS"><primary sortas="GIMP_SCALE_ENTRY_SPINBUTTON_ADJ">GIMP_SCALE_ENTRY_SPINBUTTON_ADJ</primary></indexterm><programlisting>#define             GIMP_SCALE_ENTRY_SPINBUTTON_ADJ(adj)</programlisting>
410
394
<para>
411
395
Returns the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> of the scale_entry's <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>.
412
396
</para><variablelist role="params">
413
 
<varlistentry><term><parameter>adj</parameter>&nbsp;:</term>
 
397
<varlistentry><term><parameter>adj</parameter>&#160;:</term>
414
398
<listitem><simpara>The <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> returned by <link linkend="gimp-scale-entry-new"><function>gimp_scale_entry_new()</function></link>.
415
 
 
416
 
 
417
399
</simpara></listitem></varlistentry>
418
400
</variablelist></refsect2>
419
401
<refsect2 id="gimp-scale-entry-new" role="function">
420
402
<title>gimp_scale_entry_new ()</title>
421
 
<indexterm zone="gimp-scale-entry-new"><primary>gimp_scale_entry_new</primary></indexterm><programlisting><link linkend="GtkObject">GtkObject</link>*          gimp_scale_entry_new                (<link linkend="GtkTable">GtkTable</link> *table,
 
403
<indexterm zone="gimp-scale-entry-new"><primary sortas="gimp_scale_entry_new">gimp_scale_entry_new</primary></indexterm><programlisting><link linkend="GtkObject">GtkObject</link> *         gimp_scale_entry_new                (<link linkend="GtkTable">GtkTable</link> *table,
422
404
                                                         <link linkend="gint">gint</link> column,
423
405
                                                         <link linkend="gint">gint</link> row,
424
406
                                                         const <link linkend="gchar">gchar</link> *text,
439
421
This function creates a <link linkend="GtkLabel"><type>GtkLabel</type></link>, a <link linkend="GtkHScale"><type>GtkHScale</type></link> and a <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link> and
440
422
attaches them to a 3-column <link linkend="GtkTable"><type>GtkTable</type></link>.</para>
441
423
<para>
442
 
 
443
424
</para><variablelist role="params">
444
 
<varlistentry><term><parameter>table</parameter>&nbsp;:</term>
 
425
<varlistentry><term><parameter>table</parameter>&#160;:</term>
445
426
<listitem><simpara>               The <link linkend="GtkTable"><type>GtkTable</type></link> the widgets will be attached to.
446
427
</simpara></listitem></varlistentry>
447
 
<varlistentry><term><parameter>column</parameter>&nbsp;:</term>
 
428
<varlistentry><term><parameter>column</parameter>&#160;:</term>
448
429
<listitem><simpara>              The column to start with.
449
430
</simpara></listitem></varlistentry>
450
 
<varlistentry><term><parameter>row</parameter>&nbsp;:</term>
 
431
<varlistentry><term><parameter>row</parameter>&#160;:</term>
451
432
<listitem><simpara>                 The row to attach the widgets.
452
433
</simpara></listitem></varlistentry>
453
 
<varlistentry><term><parameter>text</parameter>&nbsp;:</term>
 
434
<varlistentry><term><parameter>text</parameter>&#160;:</term>
454
435
<listitem><simpara>                The text for the <link linkend="GtkLabel"><type>GtkLabel</type></link> which will appear
455
436
                      left of the <link linkend="GtkHScale"><type>GtkHScale</type></link>.
456
437
</simpara></listitem></varlistentry>
457
 
<varlistentry><term><parameter>scale_width</parameter>&nbsp;:</term>
 
438
<varlistentry><term><parameter>scale_width</parameter>&#160;:</term>
458
439
<listitem><simpara>         The minimum horizontal size of the <link linkend="GtkHScale"><type>GtkHScale</type></link>.
459
440
</simpara></listitem></varlistentry>
460
 
<varlistentry><term><parameter>spinbutton_width</parameter>&nbsp;:</term>
 
441
<varlistentry><term><parameter>spinbutton_width</parameter>&#160;:</term>
461
442
<listitem><simpara>    The minimum horizontal size of the <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>.
462
443
</simpara></listitem></varlistentry>
463
 
<varlistentry><term><parameter>value</parameter>&nbsp;:</term>
 
444
<varlistentry><term><parameter>value</parameter>&#160;:</term>
464
445
<listitem><simpara>               The initial value.
465
446
</simpara></listitem></varlistentry>
466
 
<varlistentry><term><parameter>lower</parameter>&nbsp;:</term>
 
447
<varlistentry><term><parameter>lower</parameter>&#160;:</term>
467
448
<listitem><simpara>               The lower boundary.
468
449
</simpara></listitem></varlistentry>
469
 
<varlistentry><term><parameter>upper</parameter>&nbsp;:</term>
 
450
<varlistentry><term><parameter>upper</parameter>&#160;:</term>
470
451
<listitem><simpara>               The upper boundary.
471
452
</simpara></listitem></varlistentry>
472
 
<varlistentry><term><parameter>step_increment</parameter>&nbsp;:</term>
 
453
<varlistentry><term><parameter>step_increment</parameter>&#160;:</term>
473
454
<listitem><simpara>      The step increment.
474
455
</simpara></listitem></varlistentry>
475
 
<varlistentry><term><parameter>page_increment</parameter>&nbsp;:</term>
 
456
<varlistentry><term><parameter>page_increment</parameter>&#160;:</term>
476
457
<listitem><simpara>      The page increment.
477
458
</simpara></listitem></varlistentry>
478
 
<varlistentry><term><parameter>digits</parameter>&nbsp;:</term>
 
459
<varlistentry><term><parameter>digits</parameter>&#160;:</term>
479
460
<listitem><simpara>              The number of decimal digits.
480
461
</simpara></listitem></varlistentry>
481
 
<varlistentry><term><parameter>constrain</parameter>&nbsp;:</term>
482
 
<listitem><simpara>           <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the range of possible values of the
 
462
<varlistentry><term><parameter>constrain</parameter>&#160;:</term>
 
463
<listitem><simpara>           <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the range of possible values of the
483
464
                      <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link> should be the same as of the <link linkend="GtkHScale"><type>GtkHScale</type></link>.
484
465
</simpara></listitem></varlistentry>
485
 
<varlistentry><term><parameter>unconstrained_lower</parameter>&nbsp;:</term>
 
466
<varlistentry><term><parameter>unconstrained_lower</parameter>&#160;:</term>
486
467
<listitem><simpara> The spinbutton's lower boundary
487
 
                      if <parameter>constrain</parameter> == <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
 
468
                      if <parameter>constrain</parameter> == <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.
488
469
</simpara></listitem></varlistentry>
489
 
<varlistentry><term><parameter>unconstrained_upper</parameter>&nbsp;:</term>
 
470
<varlistentry><term><parameter>unconstrained_upper</parameter>&#160;:</term>
490
471
<listitem><simpara> The spinbutton's upper boundary
491
 
                      if <parameter>constrain</parameter> == <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
 
472
                      if <parameter>constrain</parameter> == <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.
492
473
</simpara></listitem></varlistentry>
493
 
<varlistentry><term><parameter>tooltip</parameter>&nbsp;:</term>
 
474
<varlistentry><term><parameter>tooltip</parameter>&#160;:</term>
494
475
<listitem><simpara>             A tooltip message for the scale and the spinbutton.
495
476
</simpara></listitem></varlistentry>
496
 
<varlistentry><term><parameter>help_id</parameter>&nbsp;:</term>
 
477
<varlistentry><term><parameter>help_id</parameter>&#160;:</term>
497
478
<listitem><simpara>             The widgets' help_id (see <link linkend="gimp-help-set-help-data"><function>gimp_help_set_help_data()</function></link>).
498
479
</simpara></listitem></varlistentry>
499
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>'s <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
 
480
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>'s <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
500
481
</simpara></listitem></varlistentry>
501
482
</variablelist></refsect2>
502
483
<refsect2 id="gimp-scale-entry-set-sensitive" role="function">
503
484
<title>gimp_scale_entry_set_sensitive ()</title>
504
 
<indexterm zone="gimp-scale-entry-set-sensitive"><primary>gimp_scale_entry_set_sensitive</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_scale_entry_set_sensitive      (<link linkend="GtkObject">GtkObject</link> *adjustment,
 
485
<indexterm zone="gimp-scale-entry-set-sensitive"><primary sortas="gimp_scale_entry_set_sensitive">gimp_scale_entry_set_sensitive</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_scale_entry_set_sensitive      (<link linkend="GtkObject">GtkObject</link> *adjustment,
505
486
                                                         <link linkend="gboolean">gboolean</link> sensitive);</programlisting>
506
487
<para>
507
488
Sets the sensitivity of the scale_entry's <link linkend="GtkLabel"><type>GtkLabel</type></link>, <link linkend="GtkHScale"><type>GtkHScale</type></link> and
508
489
<link linkend="GtkSpinbutton"><type>GtkSpinbutton</type></link>.</para>
509
490
<para>
510
 
 
511
491
</para><variablelist role="params">
512
 
<varlistentry><term><parameter>adjustment</parameter>&nbsp;:</term>
 
492
<varlistentry><term><parameter>adjustment</parameter>&#160;:</term>
513
493
<listitem><simpara> a <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> returned by <link linkend="gimp-scale-entry-new"><function>gimp_scale_entry_new()</function></link>
514
494
</simpara></listitem></varlistentry>
515
 
<varlistentry><term><parameter>sensitive</parameter>&nbsp;:</term>
 
495
<varlistentry><term><parameter>sensitive</parameter>&#160;:</term>
516
496
<listitem><simpara>  a boolean value with the same semantics as the <parameter>sensitive</parameter>
517
497
             parameter of <link linkend="gtk-widget-set-sensitive"><function>gtk_widget_set_sensitive()</function></link>
518
498
</simpara></listitem></varlistentry>
519
499
</variablelist></refsect2>
520
500
<refsect2 id="gimp-scale-entry-set-logarithmic" role="function" condition="since:GIMP 2.2">
521
501
<title>gimp_scale_entry_set_logarithmic ()</title>
522
 
<indexterm zone="gimp-scale-entry-set-logarithmic" role="GIMP 2.2"><primary>gimp_scale_entry_set_logarithmic</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_scale_entry_set_logarithmic    (<link linkend="GtkObject">GtkObject</link> *adjustment,
 
502
<indexterm zone="gimp-scale-entry-set-logarithmic" role="GIMP 2.2"><primary sortas="gimp_scale_entry_set_logarithmic">gimp_scale_entry_set_logarithmic</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_scale_entry_set_logarithmic    (<link linkend="GtkObject">GtkObject</link> *adjustment,
523
503
                                                         <link linkend="gboolean">gboolean</link> logarithmic);</programlisting>
524
504
<para>
525
505
Sets whether the scale_entry's scale widget will behave in a linear
527
507
ranges, but smaller selections on that range require a finer
528
508
adjustment.</para>
529
509
<para>
530
 
 
531
510
</para><variablelist role="params">
532
 
<varlistentry><term><parameter>adjustment</parameter>&nbsp;:</term>
 
511
<varlistentry><term><parameter>adjustment</parameter>&#160;:</term>
533
512
<listitem><simpara>  a  <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> as returned by <link linkend="gimp-scale-entry-new"><function>gimp_scale_entry_new()</function></link>
534
513
</simpara></listitem></varlistentry>
535
 
<varlistentry><term><parameter>logarithmic</parameter>&nbsp;:</term>
 
514
<varlistentry><term><parameter>logarithmic</parameter>&#160;:</term>
536
515
<listitem><simpara> a boolean value to set or reset logarithmic behaviour
537
516
              of the scale widget
538
517
</simpara></listitem></varlistentry>
539
 
</variablelist><para role="since">Since  GIMP 2.2
540
 
</para></refsect2>
 
518
</variablelist><para role="since">Since GIMP 2.2</para></refsect2>
541
519
<refsect2 id="gimp-scale-entry-get-logarithmic" role="function" condition="since:GIMP 2.2">
542
520
<title>gimp_scale_entry_get_logarithmic ()</title>
543
 
<indexterm zone="gimp-scale-entry-get-logarithmic" role="GIMP 2.2"><primary>gimp_scale_entry_get_logarithmic</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_scale_entry_get_logarithmic    (<link linkend="GtkObject">GtkObject</link> *adjustment);</programlisting>
 
521
<indexterm zone="gimp-scale-entry-get-logarithmic" role="GIMP 2.2"><primary sortas="gimp_scale_entry_get_logarithmic">gimp_scale_entry_get_logarithmic</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_scale_entry_get_logarithmic    (<link linkend="GtkObject">GtkObject</link> *adjustment);</programlisting>
544
522
<para>
545
523
</para>
546
524
<para>
547
 
 
548
525
</para><variablelist role="params">
549
 
<varlistentry><term><parameter>adjustment</parameter>&nbsp;:</term>
 
526
<varlistentry><term><parameter>adjustment</parameter>&#160;:</term>
550
527
<listitem><simpara> a  <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> as returned by <link linkend="gimp-scale-entry-new"><function>gimp_scale_entry_new()</function></link>
551
528
</simpara></listitem></varlistentry>
552
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the the entry's scale widget will behave in
553
 
              logharithmic fashion, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> for linear behaviour.
 
529
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the the entry's scale widget will behave in
 
530
              logharithmic fashion, <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> for linear behaviour.
554
531
 
555
532
</simpara></listitem></varlistentry>
556
 
</variablelist><para role="since">Since  GIMP 2.2
557
 
</para></refsect2>
 
533
</variablelist><para role="since">Since GIMP 2.2</para></refsect2>
558
534
<refsect2 id="gimp-color-scale-entry-new" role="function">
559
535
<title>gimp_color_scale_entry_new ()</title>
560
 
<indexterm zone="gimp-color-scale-entry-new"><primary>gimp_color_scale_entry_new</primary></indexterm><programlisting><link linkend="GtkObject">GtkObject</link>*          gimp_color_scale_entry_new          (<link linkend="GtkTable">GtkTable</link> *table,
 
536
<indexterm zone="gimp-color-scale-entry-new"><primary sortas="gimp_color_scale_entry_new">gimp_color_scale_entry_new</primary></indexterm><programlisting><link linkend="GtkObject">GtkObject</link> *         gimp_color_scale_entry_new          (<link linkend="GtkTable">GtkTable</link> *table,
561
537
                                                         <link linkend="gint">gint</link> column,
562
538
                                                         <link linkend="gint">gint</link> row,
563
539
                                                         const <link linkend="gchar">gchar</link> *text,
575
551
This function creates a <link linkend="GtkLabel"><type>GtkLabel</type></link>, a <link linkend="GimpColorScale"><type>GimpColorScale</type></link> and a
576
552
<link linkend="GtkSpinButton"><type>GtkSpinButton</type></link> and attaches them to a 3-column <link linkend="GtkTable"><type>GtkTable</type></link>.</para>
577
553
<para>
578
 
 
579
554
</para><variablelist role="params">
580
 
<varlistentry><term><parameter>table</parameter>&nbsp;:</term>
 
555
<varlistentry><term><parameter>table</parameter>&#160;:</term>
581
556
<listitem><simpara>               The <link linkend="GtkTable"><type>GtkTable</type></link> the widgets will be attached to.
582
557
</simpara></listitem></varlistentry>
583
 
<varlistentry><term><parameter>column</parameter>&nbsp;:</term>
 
558
<varlistentry><term><parameter>column</parameter>&#160;:</term>
584
559
<listitem><simpara>              The column to start with.
585
560
</simpara></listitem></varlistentry>
586
 
<varlistentry><term><parameter>row</parameter>&nbsp;:</term>
 
561
<varlistentry><term><parameter>row</parameter>&#160;:</term>
587
562
<listitem><simpara>                 The row to attach the widgets.
588
563
</simpara></listitem></varlistentry>
589
 
<varlistentry><term><parameter>text</parameter>&nbsp;:</term>
 
564
<varlistentry><term><parameter>text</parameter>&#160;:</term>
590
565
<listitem><simpara>                The text for the <link linkend="GtkLabel"><type>GtkLabel</type></link> which will appear
591
566
                      left of the <link linkend="GtkHScale"><type>GtkHScale</type></link>.
592
567
</simpara></listitem></varlistentry>
593
 
<varlistentry><term><parameter>scale_width</parameter>&nbsp;:</term>
 
568
<varlistentry><term><parameter>scale_width</parameter>&#160;:</term>
594
569
<listitem><simpara>         The minimum horizontal size of the <link linkend="GtkHScale"><type>GtkHScale</type></link>.
595
570
</simpara></listitem></varlistentry>
596
 
<varlistentry><term><parameter>spinbutton_width</parameter>&nbsp;:</term>
 
571
<varlistentry><term><parameter>spinbutton_width</parameter>&#160;:</term>
597
572
<listitem><simpara>    The minimum horizontal size of the <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>.
598
573
</simpara></listitem></varlistentry>
599
 
<varlistentry><term><parameter>value</parameter>&nbsp;:</term>
 
574
<varlistentry><term><parameter>value</parameter>&#160;:</term>
600
575
<listitem><simpara>               The initial value.
601
576
</simpara></listitem></varlistentry>
602
 
<varlistentry><term><parameter>lower</parameter>&nbsp;:</term>
 
577
<varlistentry><term><parameter>lower</parameter>&#160;:</term>
603
578
<listitem><simpara>               The lower boundary.
604
579
</simpara></listitem></varlistentry>
605
 
<varlistentry><term><parameter>upper</parameter>&nbsp;:</term>
 
580
<varlistentry><term><parameter>upper</parameter>&#160;:</term>
606
581
<listitem><simpara>               The upper boundary.
607
582
</simpara></listitem></varlistentry>
608
 
<varlistentry><term><parameter>step_increment</parameter>&nbsp;:</term>
 
583
<varlistentry><term><parameter>step_increment</parameter>&#160;:</term>
609
584
<listitem><simpara>      The step increment.
610
585
</simpara></listitem></varlistentry>
611
 
<varlistentry><term><parameter>page_increment</parameter>&nbsp;:</term>
 
586
<varlistentry><term><parameter>page_increment</parameter>&#160;:</term>
612
587
<listitem><simpara>      The page increment.
613
588
</simpara></listitem></varlistentry>
614
 
<varlistentry><term><parameter>digits</parameter>&nbsp;:</term>
 
589
<varlistentry><term><parameter>digits</parameter>&#160;:</term>
615
590
<listitem><simpara>              The number of decimal digits.
616
591
</simpara></listitem></varlistentry>
617
 
<varlistentry><term><parameter>tooltip</parameter>&nbsp;:</term>
 
592
<varlistentry><term><parameter>tooltip</parameter>&#160;:</term>
618
593
<listitem><simpara>             A tooltip message for the scale and the spinbutton.
619
594
</simpara></listitem></varlistentry>
620
 
<varlistentry><term><parameter>help_id</parameter>&nbsp;:</term>
 
595
<varlistentry><term><parameter>help_id</parameter>&#160;:</term>
621
596
<listitem><simpara>             The widgets' help_id (see <link linkend="gimp-help-set-help-data"><function>gimp_help_set_help_data()</function></link>).
622
597
</simpara></listitem></varlistentry>
623
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>'s <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
 
598
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>'s <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
624
599
</simpara></listitem></varlistentry>
625
600
</variablelist></refsect2>
626
 
<refsect2 id="GIMP-RANDOM-SEED-SPINBUTTON:CAPS" role="macro">
 
601
<refsect2 id="GIMP-RANDOM-SEED-SPINBUTTON--CAPS" role="macro">
627
602
<title>GIMP_RANDOM_SEED_SPINBUTTON()</title>
628
 
<indexterm zone="GIMP-RANDOM-SEED-SPINBUTTON:CAPS"><primary>GIMP_RANDOM_SEED_SPINBUTTON</primary></indexterm><programlisting>#define             GIMP_RANDOM_SEED_SPINBUTTON(hbox)</programlisting>
 
603
<indexterm zone="GIMP-RANDOM-SEED-SPINBUTTON--CAPS"><primary sortas="GIMP_RANDOM_SEED_SPINBUTTON">GIMP_RANDOM_SEED_SPINBUTTON</primary></indexterm><programlisting>#define             GIMP_RANDOM_SEED_SPINBUTTON(hbox)</programlisting>
629
604
<para>
630
605
Returns the random_seed's <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>.
631
606
</para><variablelist role="params">
632
 
<varlistentry><term><parameter>hbox</parameter>&nbsp;:</term>
 
607
<varlistentry><term><parameter>hbox</parameter>&#160;:</term>
633
608
<listitem><simpara>The <link linkend="GtkHBox"><type>GtkHBox</type></link> returned by <link linkend="gimp-random-seed-new"><function>gimp_random_seed_new()</function></link>.
634
 
 
635
 
 
636
609
</simpara></listitem></varlistentry>
637
610
</variablelist></refsect2>
638
 
<refsect2 id="GIMP-RANDOM-SEED-SPINBUTTON-ADJ:CAPS" role="macro">
 
611
<refsect2 id="GIMP-RANDOM-SEED-SPINBUTTON-ADJ--CAPS" role="macro">
639
612
<title>GIMP_RANDOM_SEED_SPINBUTTON_ADJ()</title>
640
 
<indexterm zone="GIMP-RANDOM-SEED-SPINBUTTON-ADJ:CAPS"><primary>GIMP_RANDOM_SEED_SPINBUTTON_ADJ</primary></indexterm><programlisting>#define             GIMP_RANDOM_SEED_SPINBUTTON_ADJ(hbox)</programlisting>
 
613
<indexterm zone="GIMP-RANDOM-SEED-SPINBUTTON-ADJ--CAPS"><primary sortas="GIMP_RANDOM_SEED_SPINBUTTON_ADJ">GIMP_RANDOM_SEED_SPINBUTTON_ADJ</primary></indexterm><programlisting>#define             GIMP_RANDOM_SEED_SPINBUTTON_ADJ(hbox)</programlisting>
641
614
<para>
642
615
Returns the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> of the random_seed's <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>.
643
616
</para><variablelist role="params">
644
 
<varlistentry><term><parameter>hbox</parameter>&nbsp;:</term>
 
617
<varlistentry><term><parameter>hbox</parameter>&#160;:</term>
645
618
<listitem><simpara>The <link linkend="GtkHBox"><type>GtkHBox</type></link> returned by <link linkend="gimp-random-seed-new"><function>gimp_random_seed_new()</function></link>.
646
 
 
647
 
 
648
619
</simpara></listitem></varlistentry>
649
620
</variablelist></refsect2>
650
 
<refsect2 id="GIMP-RANDOM-SEED-TOGGLE:CAPS" role="macro">
 
621
<refsect2 id="GIMP-RANDOM-SEED-TOGGLE--CAPS" role="macro">
651
622
<title>GIMP_RANDOM_SEED_TOGGLE()</title>
652
 
<indexterm zone="GIMP-RANDOM-SEED-TOGGLE:CAPS"><primary>GIMP_RANDOM_SEED_TOGGLE</primary></indexterm><programlisting>#define             GIMP_RANDOM_SEED_TOGGLE(hbox)</programlisting>
 
623
<indexterm zone="GIMP-RANDOM-SEED-TOGGLE--CAPS"><primary sortas="GIMP_RANDOM_SEED_TOGGLE">GIMP_RANDOM_SEED_TOGGLE</primary></indexterm><programlisting>#define             GIMP_RANDOM_SEED_TOGGLE(hbox)</programlisting>
653
624
<para>
654
 
 
655
625
</para><variablelist role="params">
656
 
<varlistentry><term><parameter>hbox</parameter>&nbsp;:</term>
 
626
<varlistentry><term><parameter>hbox</parameter>&#160;:</term>
657
627
<listitem><simpara>
658
 
 
659
 
 
660
628
</simpara></listitem></varlistentry>
661
629
</variablelist></refsect2>
662
630
<refsect2 id="gimp-random-seed-new" role="function">
663
631
<title>gimp_random_seed_new ()</title>
664
 
<indexterm zone="gimp-random-seed-new"><primary>gimp_random_seed_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_random_seed_new                (<link linkend="guint32">guint32</link> *seed,
 
632
<indexterm zone="gimp-random-seed-new"><primary sortas="gimp_random_seed_new">gimp_random_seed_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gimp_random_seed_new                (<link linkend="guint32">guint32</link> *seed,
665
633
                                                         <link linkend="gboolean">gboolean</link> *random_seed);</programlisting>
666
634
<para>
667
635
Creates a widget that allows the user to control how the random number
668
636
generator is initialized.</para>
669
637
<para>
670
 
 
671
638
</para><variablelist role="params">
672
 
<varlistentry><term><parameter>seed</parameter>&nbsp;:</term>
 
639
<varlistentry><term><parameter>seed</parameter>&#160;:</term>
673
640
<listitem><simpara>        A pointer to the variable which stores the random seed.
674
641
</simpara></listitem></varlistentry>
675
 
<varlistentry><term><parameter>random_seed</parameter>&nbsp;:</term>
 
642
<varlistentry><term><parameter>random_seed</parameter>&#160;:</term>
676
643
<listitem><simpara> A pointer to a boolean indicating whether seed should be
677
644
              initialised randomly or not.
678
645
</simpara></listitem></varlistentry>
679
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A <link linkend="GtkHBox"><type>GtkHBox</type></link> containing a <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link> for the seed and
 
646
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GtkHBox"><type>GtkHBox</type></link> containing a <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link> for the seed and
680
647
         a <link linkend="GtkButton"><type>GtkButton</type></link> for setting a random seed.
681
648
</simpara></listitem></varlistentry>
682
649
</variablelist></refsect2>
683
 
<refsect2 id="GIMP-COORDINATES-CHAINBUTTON:CAPS" role="macro">
 
650
<refsect2 id="GIMP-COORDINATES-CHAINBUTTON--CAPS" role="macro">
684
651
<title>GIMP_COORDINATES_CHAINBUTTON()</title>
685
 
<indexterm zone="GIMP-COORDINATES-CHAINBUTTON:CAPS"><primary>GIMP_COORDINATES_CHAINBUTTON</primary></indexterm><programlisting>#define             GIMP_COORDINATES_CHAINBUTTON(sizeentry)</programlisting>
 
652
<indexterm zone="GIMP-COORDINATES-CHAINBUTTON--CAPS"><primary sortas="GIMP_COORDINATES_CHAINBUTTON">GIMP_COORDINATES_CHAINBUTTON</primary></indexterm><programlisting>#define             GIMP_COORDINATES_CHAINBUTTON(sizeentry)</programlisting>
686
653
<para>
687
654
Returns the <link linkend="GimpChainButton"><type>GimpChainButton</type></link> which is attached to the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>.
688
655
</para><variablelist role="params">
689
 
<varlistentry><term><parameter>sizeentry</parameter>&nbsp;:</term>
 
656
<varlistentry><term><parameter>sizeentry</parameter>&#160;:</term>
690
657
<listitem><simpara>The <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link> returned by <link linkend="gimp-coordinates-new"><function>gimp_coordinates_new()</function></link>.
691
 
 
692
 
 
693
658
</simpara></listitem></varlistentry>
694
659
</variablelist></refsect2>
695
660
<refsect2 id="gimp-coordinates-new" role="function">
696
661
<title>gimp_coordinates_new ()</title>
697
 
<indexterm zone="gimp-coordinates-new"><primary>gimp_coordinates_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_coordinates_new                (<link linkend="GimpUnit">GimpUnit</link> unit,
 
662
<indexterm zone="gimp-coordinates-new"><primary sortas="gimp_coordinates_new">gimp_coordinates_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gimp_coordinates_new                (<link linkend="GimpUnit">GimpUnit</link> unit,
698
663
                                                         const <link linkend="gchar">gchar</link> *unit_format,
699
664
                                                         <link linkend="gboolean">gboolean</link> menu_show_pixels,
700
665
                                                         <link linkend="gboolean">gboolean</link> menu_show_percent,
721
686
coordinates/sizes with a <link linkend="GimpChainButton"><type>GimpChainButton</type></link> attached to constrain either the
722
687
two fields' values or the ratio between them.</para>
723
688
<para>
724
 
 
725
689
</para><variablelist role="params">
726
 
<varlistentry><term><parameter>unit</parameter>&nbsp;:</term>
 
690
<varlistentry><term><parameter>unit</parameter>&#160;:</term>
727
691
<listitem><simpara>                   The initial unit of the <link linkend="GimpUnitMenu"><type>GimpUnitMenu</type></link>.
728
692
</simpara></listitem></varlistentry>
729
 
<varlistentry><term><parameter>unit_format</parameter>&nbsp;:</term>
 
693
<varlistentry><term><parameter>unit_format</parameter>&#160;:</term>
730
694
<listitem><simpara>            A printf-like unit-format string as is used with
731
695
                         <link linkend="gimp-unit-menu-new"><function>gimp_unit_menu_new()</function></link>.
732
696
</simpara></listitem></varlistentry>
733
 
<varlistentry><term><parameter>menu_show_pixels</parameter>&nbsp;:</term>
734
 
<listitem><simpara>       <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the <link linkend="GimpUnitMenu"><type>GimpUnitMenu</type></link> should contain an item
 
697
<varlistentry><term><parameter>menu_show_pixels</parameter>&#160;:</term>
 
698
<listitem><simpara>       <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the <link linkend="GimpUnitMenu"><type>GimpUnitMenu</type></link> should contain an item
735
699
                         for GIMP_UNIT_PIXEL.
736
700
</simpara></listitem></varlistentry>
737
 
<varlistentry><term><parameter>menu_show_percent</parameter>&nbsp;:</term>
738
 
<listitem><simpara>      <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the <link linkend="GimpUnitMenu"><type>GimpUnitMenu</type></link> should contain an item
 
701
<varlistentry><term><parameter>menu_show_percent</parameter>&#160;:</term>
 
702
<listitem><simpara>      <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the <link linkend="GimpUnitMenu"><type>GimpUnitMenu</type></link> should contain an item
739
703
                         for GIMP_UNIT_PERCENT.
740
704
</simpara></listitem></varlistentry>
741
 
<varlistentry><term><parameter>spinbutton_width</parameter>&nbsp;:</term>
 
705
<varlistentry><term><parameter>spinbutton_width</parameter>&#160;:</term>
742
706
<listitem><simpara>       The horizontal size of the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>'s
743
707
                          <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>'s.
744
708
</simpara></listitem></varlistentry>
745
 
<varlistentry><term><parameter>update_policy</parameter>&nbsp;:</term>
 
709
<varlistentry><term><parameter>update_policy</parameter>&#160;:</term>
746
710
<listitem><simpara>          The update policy for the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>.
747
711
</simpara></listitem></varlistentry>
748
 
<varlistentry><term><parameter>chainbutton_active</parameter>&nbsp;:</term>
749
 
<listitem><simpara>     <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the attached <link linkend="GimpChainButton"><type>GimpChainButton</type></link> should be
 
712
<varlistentry><term><parameter>chainbutton_active</parameter>&#160;:</term>
 
713
<listitem><simpara>     <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the attached <link linkend="GimpChainButton"><type>GimpChainButton</type></link> should be
750
714
                         active.
751
715
</simpara></listitem></varlistentry>
752
 
<varlistentry><term><parameter>chain_constrains_ratio</parameter>&nbsp;:</term>
753
 
<listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the chainbutton should constrain the
754
 
                         fields' aspect ratio. If <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>, the values will
 
716
<varlistentry><term><parameter>chain_constrains_ratio</parameter>&#160;:</term>
 
717
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the chainbutton should constrain the
 
718
                         fields' aspect ratio. If <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>, the values will
755
719
                         be constrained.
756
720
</simpara></listitem></varlistentry>
757
 
<varlistentry><term><parameter>xlabel</parameter>&nbsp;:</term>
 
721
<varlistentry><term><parameter>xlabel</parameter>&#160;:</term>
758
722
<listitem><simpara>                 The label for the X coordinate.
759
723
</simpara></listitem></varlistentry>
760
 
<varlistentry><term><parameter>x</parameter>&nbsp;:</term>
 
724
<varlistentry><term><parameter>x</parameter>&#160;:</term>
761
725
<listitem><simpara>                      The initial value of the X coordinate.
762
726
</simpara></listitem></varlistentry>
763
 
<varlistentry><term><parameter>xres</parameter>&nbsp;:</term>
 
727
<varlistentry><term><parameter>xres</parameter>&#160;:</term>
764
728
<listitem><simpara>                   The horizontal resolution in DPI.
765
729
</simpara></listitem></varlistentry>
766
 
<varlistentry><term><parameter>lower_boundary_x</parameter>&nbsp;:</term>
 
730
<varlistentry><term><parameter>lower_boundary_x</parameter>&#160;:</term>
767
731
<listitem><simpara>       The lower boundary of the X coordinate.
768
732
</simpara></listitem></varlistentry>
769
 
<varlistentry><term><parameter>upper_boundary_x</parameter>&nbsp;:</term>
 
733
<varlistentry><term><parameter>upper_boundary_x</parameter>&#160;:</term>
770
734
<listitem><simpara>       The upper boundary of the X coordinate.
771
735
</simpara></listitem></varlistentry>
772
 
<varlistentry><term><parameter>xsize_0</parameter>&nbsp;:</term>
 
736
<varlistentry><term><parameter>xsize_0</parameter>&#160;:</term>
773
737
<listitem><simpara>                The X value which will be treated as 0%.
774
738
</simpara></listitem></varlistentry>
775
 
<varlistentry><term><parameter>xsize_100</parameter>&nbsp;:</term>
 
739
<varlistentry><term><parameter>xsize_100</parameter>&#160;:</term>
776
740
<listitem><simpara>              The X value which will be treated as 100%.
777
741
</simpara></listitem></varlistentry>
778
 
<varlistentry><term><parameter>ylabel</parameter>&nbsp;:</term>
 
742
<varlistentry><term><parameter>ylabel</parameter>&#160;:</term>
779
743
<listitem><simpara>                 The label for the Y coordinate.
780
744
</simpara></listitem></varlistentry>
781
 
<varlistentry><term><parameter>y</parameter>&nbsp;:</term>
 
745
<varlistentry><term><parameter>y</parameter>&#160;:</term>
782
746
<listitem><simpara>                      The initial value of the Y coordinate.
783
747
</simpara></listitem></varlistentry>
784
 
<varlistentry><term><parameter>yres</parameter>&nbsp;:</term>
 
748
<varlistentry><term><parameter>yres</parameter>&#160;:</term>
785
749
<listitem><simpara>                   The vertical resolution in DPI.
786
750
</simpara></listitem></varlistentry>
787
 
<varlistentry><term><parameter>lower_boundary_y</parameter>&nbsp;:</term>
 
751
<varlistentry><term><parameter>lower_boundary_y</parameter>&#160;:</term>
788
752
<listitem><simpara>       The lower boundary of the Y coordinate.
789
753
</simpara></listitem></varlistentry>
790
 
<varlistentry><term><parameter>upper_boundary_y</parameter>&nbsp;:</term>
 
754
<varlistentry><term><parameter>upper_boundary_y</parameter>&#160;:</term>
791
755
<listitem><simpara>       The upper boundary of the Y coordinate.
792
756
</simpara></listitem></varlistentry>
793
 
<varlistentry><term><parameter>ysize_0</parameter>&nbsp;:</term>
 
757
<varlistentry><term><parameter>ysize_0</parameter>&#160;:</term>
794
758
<listitem><simpara>                The Y value which will be treated as 0%.
795
759
</simpara></listitem></varlistentry>
796
 
<varlistentry><term><parameter>ysize_100</parameter>&nbsp;:</term>
 
760
<varlistentry><term><parameter>ysize_100</parameter>&#160;:</term>
797
761
<listitem><simpara>              The Y value which will be treated as 100%.
798
762
</simpara></listitem></varlistentry>
799
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The new <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>.
 
763
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The new <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>.
800
764
</simpara></listitem></varlistentry>
801
765
</variablelist></refsect2>
802
766
<refsect2 id="gimp-pixmap-button-new" role="function" condition="deprecated:">
803
767
<title>gimp_pixmap_button_new ()</title>
804
 
<indexterm zone="gimp-pixmap-button-new" role="deprecated"><primary>gimp_pixmap_button_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_pixmap_button_new              (<link linkend="gchar">gchar</link> **xpm_data,
 
768
<indexterm zone="gimp-pixmap-button-new" role="deprecated"><primary sortas="gimp_pixmap_button_new">gimp_pixmap_button_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gimp_pixmap_button_new              (<link linkend="gchar">gchar</link> **xpm_data,
805
769
                                                         const <link linkend="gchar">gchar</link> *text);</programlisting>
806
770
<warning><para><literal>gimp_pixmap_button_new</literal> is deprecated and should not be used in newly-written code.</para></warning>
807
771
<para>
808
772
Convenience function that creates a <link linkend="GtkButton"><type>GtkButton</type></link> with a <link linkend="GimpPixmap"><type>GimpPixmap</type></link>
809
773
and an optional <link linkend="GtkLabel"><type>GtkLabel</type></link>.</para>
810
774
<para>
811
 
 
812
775
</para><variablelist role="params">
813
 
<varlistentry><term><parameter>xpm_data</parameter>&nbsp;:</term>
 
776
<varlistentry><term><parameter>xpm_data</parameter>&#160;:</term>
814
777
<listitem><simpara> The XPM data which will be passed to <link linkend="gimp-pixmap-new"><function>gimp_pixmap_new()</function></link>.
815
778
</simpara></listitem></varlistentry>
816
 
<varlistentry><term><parameter>text</parameter>&nbsp;:</term>
 
779
<varlistentry><term><parameter>text</parameter>&#160;:</term>
817
780
<listitem><simpara>     An optional text which will appear right of the pixmap.
818
781
</simpara></listitem></varlistentry>
819
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The new <link linkend="GtkButton"><type>GtkButton</type></link>.
 
782
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The new <link linkend="GtkButton"><type>GtkButton</type></link>.
820
783
</simpara></listitem></varlistentry>
821
784
</variablelist></refsect2>
822
785
<refsect2 id="gimp-toggle-button-sensitive-update" role="function">
823
786
<title>gimp_toggle_button_sensitive_update ()</title>
824
 
<indexterm zone="gimp-toggle-button-sensitive-update"><primary>gimp_toggle_button_sensitive_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_toggle_button_sensitive_update (<link linkend="GtkToggleButton">GtkToggleButton</link> *toggle_button);</programlisting>
 
787
<indexterm zone="gimp-toggle-button-sensitive-update"><primary sortas="gimp_toggle_button_sensitive_update">gimp_toggle_button_sensitive_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_toggle_button_sensitive_update (<link linkend="GtkToggleButton">GtkToggleButton</link> *toggle_button);</programlisting>
825
788
<para>
826
789
If you attached a pointer to a <link linkend="GtkWidget"><type>GtkWidget</type></link> with <link linkend="g-object-set-data"><function>g_object_set_data()</function></link> and
827
790
the "set_sensitive" key to the <link linkend="GtkToggleButton"><type>GtkToggleButton</type></link>, the sensitive state of
837
800
button's inverse "active" state by attaching widgets with the
838
801
"inverse_sensitive" key.</para>
839
802
<para>
840
 
 
841
803
</para><variablelist role="params">
842
 
<varlistentry><term><parameter>toggle_button</parameter>&nbsp;:</term>
 
804
<varlistentry><term><parameter>toggle_button</parameter>&#160;:</term>
843
805
<listitem><simpara> The <link linkend="GtkToggleButton"><type>GtkToggleButton</type></link> the "set_sensitive" and
844
806
                "inverse_sensitive" lists are attached to.
845
807
</simpara></listitem></varlistentry>
846
808
</variablelist></refsect2>
847
809
<refsect2 id="gimp-toggle-button-update" role="function">
848
810
<title>gimp_toggle_button_update ()</title>
849
 
<indexterm zone="gimp-toggle-button-update"><primary>gimp_toggle_button_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_toggle_button_update           (<link linkend="GtkWidget">GtkWidget</link> *widget,
 
811
<indexterm zone="gimp-toggle-button-update"><primary sortas="gimp_toggle_button_update">gimp_toggle_button_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_toggle_button_update           (<link linkend="GtkWidget">GtkWidget</link> *widget,
850
812
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
851
813
<para>
852
814
Note that this function calls <link linkend="gimp-toggle-button-sensitive-update"><function>gimp_toggle_button_sensitive_update()</function></link>.</para>
853
815
<para>
854
 
 
855
816
</para><variablelist role="params">
856
 
<varlistentry><term><parameter>widget</parameter>&nbsp;:</term>
 
817
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
857
818
<listitem><simpara> A <link linkend="GtkToggleButton"><type>GtkToggleButton</type></link>.
858
819
</simpara></listitem></varlistentry>
859
 
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
 
820
<varlistentry><term><parameter>data</parameter>&#160;:</term>
860
821
<listitem><simpara>   A pointer to a <link linkend="gint"><type>gint</type></link> variable which will store the value of
861
822
         <link linkend="gtk-toggle-button-get-active"><function>gtk_toggle_button_get_active()</function></link>.
862
823
</simpara></listitem></varlistentry>
863
824
</variablelist></refsect2>
864
825
<refsect2 id="gimp-radio-button-update" role="function">
865
826
<title>gimp_radio_button_update ()</title>
866
 
<indexterm zone="gimp-radio-button-update"><primary>gimp_radio_button_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_radio_button_update            (<link linkend="GtkWidget">GtkWidget</link> *widget,
 
827
<indexterm zone="gimp-radio-button-update"><primary sortas="gimp_radio_button_update">gimp_radio_button_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_radio_button_update            (<link linkend="GtkWidget">GtkWidget</link> *widget,
867
828
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
868
829
<para>
869
830
Note that this function calls <link linkend="gimp-toggle-button-sensitive-update"><function>gimp_toggle_button_sensitive_update()</function></link>.</para>
870
831
<para>
871
 
 
872
832
</para><variablelist role="params">
873
 
<varlistentry><term><parameter>widget</parameter>&nbsp;:</term>
 
833
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
874
834
<listitem><simpara> A <link linkend="GtkRadioButton"><type>GtkRadioButton</type></link>.
875
835
</simpara></listitem></varlistentry>
876
 
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
 
836
<varlistentry><term><parameter>data</parameter>&#160;:</term>
877
837
<listitem><simpara>   A pointer to a <link linkend="gint"><type>gint</type></link> variable which will store the value of
878
838
         GPOINTER_TO_INT (g_object_get_data (<parameter>widget</parameter>, "gimp-item-data")).
879
839
</simpara></listitem></varlistentry>
880
840
</variablelist></refsect2>
881
841
<refsect2 id="gimp-int-adjustment-update" role="function">
882
842
<title>gimp_int_adjustment_update ()</title>
883
 
<indexterm zone="gimp-int-adjustment-update"><primary>gimp_int_adjustment_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_int_adjustment_update          (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
 
843
<indexterm zone="gimp-int-adjustment-update"><primary sortas="gimp_int_adjustment_update">gimp_int_adjustment_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_int_adjustment_update          (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
884
844
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
885
845
<para>
886
846
Note that the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>'s value (which is a <link linkend="gdouble"><type>gdouble</type></link>) will be
887
 
rounded with <link linkend="RINT:CAPS"><function>RINT()</function></link>.</para>
 
847
rounded with <link linkend="RINT--CAPS"><function>RINT()</function></link>.</para>
888
848
<para>
889
 
 
890
849
</para><variablelist role="params">
891
 
<varlistentry><term><parameter>adjustment</parameter>&nbsp;:</term>
 
850
<varlistentry><term><parameter>adjustment</parameter>&#160;:</term>
892
851
<listitem><simpara> A <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
893
852
</simpara></listitem></varlistentry>
894
 
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
 
853
<varlistentry><term><parameter>data</parameter>&#160;:</term>
895
854
<listitem><simpara>       A pointer to a <link linkend="gint"><type>gint</type></link> variable which will store the
896
855
             <parameter>adjustment</parameter>'s value.
897
856
</simpara></listitem></varlistentry>
898
857
</variablelist></refsect2>
899
858
<refsect2 id="gimp-uint-adjustment-update" role="function">
900
859
<title>gimp_uint_adjustment_update ()</title>
901
 
<indexterm zone="gimp-uint-adjustment-update"><primary>gimp_uint_adjustment_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_uint_adjustment_update         (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
 
860
<indexterm zone="gimp-uint-adjustment-update"><primary sortas="gimp_uint_adjustment_update">gimp_uint_adjustment_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_uint_adjustment_update         (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
902
861
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
903
862
<para>
904
863
Note that the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>'s value (which is a <link linkend="gdouble"><type>gdouble</type></link>) will be rounded
905
864
with (<link linkend="guint"><type>guint</type></link>) (value + 0.5).</para>
906
865
<para>
907
 
 
908
866
</para><variablelist role="params">
909
 
<varlistentry><term><parameter>adjustment</parameter>&nbsp;:</term>
 
867
<varlistentry><term><parameter>adjustment</parameter>&#160;:</term>
910
868
<listitem><simpara> A <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
911
869
</simpara></listitem></varlistentry>
912
 
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
 
870
<varlistentry><term><parameter>data</parameter>&#160;:</term>
913
871
<listitem><simpara>       A pointer to a <link linkend="guint"><type>guint</type></link> variable which will store the
914
872
             <parameter>adjustment</parameter>'s value.
915
873
</simpara></listitem></varlistentry>
916
874
</variablelist></refsect2>
917
875
<refsect2 id="gimp-float-adjustment-update" role="function">
918
876
<title>gimp_float_adjustment_update ()</title>
919
 
<indexterm zone="gimp-float-adjustment-update"><primary>gimp_float_adjustment_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_float_adjustment_update        (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
 
877
<indexterm zone="gimp-float-adjustment-update"><primary sortas="gimp_float_adjustment_update">gimp_float_adjustment_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_float_adjustment_update        (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
920
878
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
921
879
<para>
922
880
</para>
923
881
<para>
924
 
 
925
882
</para><variablelist role="params">
926
 
<varlistentry><term><parameter>adjustment</parameter>&nbsp;:</term>
 
883
<varlistentry><term><parameter>adjustment</parameter>&#160;:</term>
927
884
<listitem><simpara> A <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
928
885
</simpara></listitem></varlistentry>
929
 
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
 
886
<varlistentry><term><parameter>data</parameter>&#160;:</term>
930
887
<listitem><simpara>       A pointer to a <link linkend="gfloat"><type>gfloat</type></link> varaiable which will store the
931
888
             <parameter>adjustment</parameter>'s value.
932
889
</simpara></listitem></varlistentry>
933
890
</variablelist></refsect2>
934
891
<refsect2 id="gimp-double-adjustment-update" role="function">
935
892
<title>gimp_double_adjustment_update ()</title>
936
 
<indexterm zone="gimp-double-adjustment-update"><primary>gimp_double_adjustment_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_double_adjustment_update       (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
 
893
<indexterm zone="gimp-double-adjustment-update"><primary sortas="gimp_double_adjustment_update">gimp_double_adjustment_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_double_adjustment_update       (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
937
894
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
938
895
<para>
939
896
</para>
940
897
<para>
941
 
 
942
898
</para><variablelist role="params">
943
 
<varlistentry><term><parameter>adjustment</parameter>&nbsp;:</term>
 
899
<varlistentry><term><parameter>adjustment</parameter>&#160;:</term>
944
900
<listitem><simpara> A <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
945
901
</simpara></listitem></varlistentry>
946
 
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
 
902
<varlistentry><term><parameter>data</parameter>&#160;:</term>
947
903
<listitem><simpara>       A pointer to a <link linkend="gdouble"><type>gdouble</type></link> variable which will store the
948
904
             <parameter>adjustment</parameter>'s value.
949
905
</simpara></listitem></varlistentry>
950
906
</variablelist></refsect2>
951
907
<refsect2 id="gimp-unit-menu-update" role="function">
952
908
<title>gimp_unit_menu_update ()</title>
953
 
<indexterm zone="gimp-unit-menu-update"><primary>gimp_unit_menu_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_unit_menu_update               (<link linkend="GtkWidget">GtkWidget</link> *widget,
 
909
<indexterm zone="gimp-unit-menu-update"><primary sortas="gimp_unit_menu_update">gimp_unit_menu_update</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_unit_menu_update               (<link linkend="GtkWidget">GtkWidget</link> *widget,
954
910
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
955
911
<para>
956
912
This callback can set the number of decimal digits of an arbitrary number
962
918
See <link linkend="gimp-toggle-button-sensitive-update"><function>gimp_toggle_button_sensitive_update()</function></link> for a description of how
963
919
to set up the list.</para>
964
920
<para>
965
 
 
966
921
</para><variablelist role="params">
967
 
<varlistentry><term><parameter>widget</parameter>&nbsp;:</term>
 
922
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
968
923
<listitem><simpara> A <link linkend="GimpUnitMenu"><type>GimpUnitMenu</type></link>.
969
924
</simpara></listitem></varlistentry>
970
 
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
 
925
<varlistentry><term><parameter>data</parameter>&#160;:</term>
971
926
<listitem><simpara>   A pointer to a <link linkend="GimpUnit"><type>GimpUnit</type></link> variable which will store the unit menu's
972
927
         value.
973
928
</simpara></listitem></varlistentry>
974
929
</variablelist></refsect2>
975
930
<refsect2 id="gimp-table-attach-aligned" role="function">
976
931
<title>gimp_table_attach_aligned ()</title>
977
 
<indexterm zone="gimp-table-attach-aligned"><primary>gimp_table_attach_aligned</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_table_attach_aligned           (<link linkend="GtkTable">GtkTable</link> *table,
 
932
<indexterm zone="gimp-table-attach-aligned"><primary sortas="gimp_table_attach_aligned">gimp_table_attach_aligned</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gimp_table_attach_aligned           (<link linkend="GtkTable">GtkTable</link> *table,
978
933
                                                         <link linkend="gint">gint</link> column,
979
934
                                                         <link linkend="gint">gint</link> row,
980
935
                                                         const <link linkend="gchar">gchar</link> *label_text,
984
939
                                                         <link linkend="gint">gint</link> colspan,
985
940
                                                         <link linkend="gboolean">gboolean</link> left_align);</programlisting>
986
941
<para>
987
 
Note that the <parameter>label_text</parameter> can be <link linkend="NULL:CAPS"><literal>NULL</literal></link> and that the widget will be
 
942
Note that the <parameter>label_text</parameter> can be <link linkend="NULL--CAPS"><literal>NULL</literal></link> and that the widget will be
988
943
attached starting at (<parameter>column</parameter> + 1) in this case, too.</para>
989
944
<para>
990
 
 
991
945
</para><variablelist role="params">
992
 
<varlistentry><term><parameter>table</parameter>&nbsp;:</term>
 
946
<varlistentry><term><parameter>table</parameter>&#160;:</term>
993
947
<listitem><simpara>      The <link linkend="GtkTable"><type>GtkTable</type></link> the widgets will be attached to.
994
948
</simpara></listitem></varlistentry>
995
 
<varlistentry><term><parameter>column</parameter>&nbsp;:</term>
 
949
<varlistentry><term><parameter>column</parameter>&#160;:</term>
996
950
<listitem><simpara>     The column to start with.
997
951
</simpara></listitem></varlistentry>
998
 
<varlistentry><term><parameter>row</parameter>&nbsp;:</term>
 
952
<varlistentry><term><parameter>row</parameter>&#160;:</term>
999
953
<listitem><simpara>        The row to attach the widgets.
1000
954
</simpara></listitem></varlistentry>
1001
 
<varlistentry><term><parameter>label_text</parameter>&nbsp;:</term>
 
955
<varlistentry><term><parameter>label_text</parameter>&#160;:</term>
1002
956
<listitem><simpara> The text for the <link linkend="GtkLabel"><type>GtkLabel</type></link> which will be attached left of
1003
957
             the widget.
1004
958
</simpara></listitem></varlistentry>
1005
 
<varlistentry><term><parameter>xalign</parameter>&nbsp;:</term>
 
959
<varlistentry><term><parameter>xalign</parameter>&#160;:</term>
1006
960
<listitem><simpara>     The horizontal alignment of the <link linkend="GtkLabel"><type>GtkLabel</type></link>.
1007
961
</simpara></listitem></varlistentry>
1008
 
<varlistentry><term><parameter>yalign</parameter>&nbsp;:</term>
 
962
<varlistentry><term><parameter>yalign</parameter>&#160;:</term>
1009
963
<listitem><simpara>     The vertival alignment of the <link linkend="GtkLabel"><type>GtkLabel</type></link>.
1010
964
</simpara></listitem></varlistentry>
1011
 
<varlistentry><term><parameter>widget</parameter>&nbsp;:</term>
 
965
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
1012
966
<listitem><simpara>     The <link linkend="GtkWidget"><type>GtkWidget</type></link> to attach right of the label.
1013
967
</simpara></listitem></varlistentry>
1014
 
<varlistentry><term><parameter>colspan</parameter>&nbsp;:</term>
 
968
<varlistentry><term><parameter>colspan</parameter>&#160;:</term>
1015
969
<listitem><simpara>    The number of columns the widget will use.
1016
970
</simpara></listitem></varlistentry>
1017
 
<varlistentry><term><parameter>left_align</parameter>&nbsp;:</term>
1018
 
<listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the widget should be left-aligned.
 
971
<varlistentry><term><parameter>left_align</parameter>&#160;:</term>
 
972
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the widget should be left-aligned.
1019
973
</simpara></listitem></varlistentry>
1020
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The created <link linkend="GtkLabel"><type>GtkLabel</type></link>.
 
974
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The created <link linkend="GtkLabel"><type>GtkLabel</type></link>.
1021
975
</simpara></listitem></varlistentry>
1022
976
</variablelist></refsect2>
1023
977
<refsect2 id="gimp-label-set-attributes" role="function" condition="since:GIMP 2.2">
1024
978
<title>gimp_label_set_attributes ()</title>
1025
 
<indexterm zone="gimp-label-set-attributes" role="GIMP 2.2"><primary>gimp_label_set_attributes</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_label_set_attributes           (<link linkend="GtkLabel">GtkLabel</link> *label,
 
979
<indexterm zone="gimp-label-set-attributes" role="GIMP 2.2"><primary sortas="gimp_label_set_attributes">gimp_label_set_attributes</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_label_set_attributes           (<link linkend="GtkLabel">GtkLabel</link> *label,
1026
980
                                                         ...);</programlisting>
1027
981
<para>
1028
982
Sets Pango attributes on a <link linkend="GtkLabel"><type>GtkLabel</type></link> in a more convenient way than
1038
992
you need to set attributes on part of the label, you will have to
1039
993
use the PangoAttributes API directly.</para>
1040
994
<para>
1041
 
 
1042
995
</para><variablelist role="params">
1043
 
<varlistentry><term><parameter>label</parameter>&nbsp;:</term>
 
996
<varlistentry><term><parameter>label</parameter>&#160;:</term>
1044
997
<listitem><simpara> a <link linkend="GtkLabel"><type>GtkLabel</type></link>
1045
998
</simpara></listitem></varlistentry>
1046
 
<varlistentry><term><parameter>...</parameter>&nbsp;:</term>
 
999
<varlistentry><term><parameter>...</parameter>&#160;:</term>
1047
1000
<listitem><simpara>   a list of PangoAttrType and value pairs terminated by -1.
1048
1001
</simpara></listitem></varlistentry>
1049
 
</variablelist><para role="since">Since  GIMP 2.2
1050
 
</para></refsect2>
 
1002
</variablelist><para role="since">Since GIMP 2.2</para></refsect2>
1051
1003
 
1052
1004
</refsect1>
1053
1005