← Back to branch summary

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

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Holbach
  • Date: 2007-05-02 16:33:03 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20070502163303-bvzhjzbpw8qglc4y
Tags: 2.3.16-1ubuntu1
* Resynchronized with Debian, remaining Ubuntu changes:
  - debian/rules: i18n magic.
* debian/control.in:
  - Maintainer: Ubuntu Core Developers <ubuntu-devel@lists.ubuntu.com>
* debian/patches/02_help-message.patch,
  debian/patches/03_gimp.desktop.in.in.patch,
  debian/patches/10_dont_show_wizard.patch: updated.
* debian/patches/04_composite-signedness.patch,
  debian/patches/05_add-letter-spacing.patch: dropped, used upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
devel-docs/libgimpwidgets/xml/gimpsizeentry.xml
4
4
 
5
5
<refentry id="GimpSizeEntry">
6
6
<refmeta>
7
 
<refentrytitle id="top_of_page">GimpSizeEntry</refentrytitle>
 
7
<refentrytitle role="top_of_page">GimpSizeEntry</refentrytitle>
8
8
<manvolnum>3</manvolnum>
9
9
<refmiscinfo>LIBGIMPWIDGETS Library</refmiscinfo>
10
10
</refmeta>
15
15
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
16
16
</refnamediv>
17
17
 
18
 
<refsynopsisdiv id="synopsis">
19
 
<title id="synopsis.title">Synopsis</title>
 
18
<refsynopsisdiv role="synopsis">
 
19
<title role="synopsis.title">Synopsis</title>
20
20
 
21
21
<synopsis>
22
22
 
23
23
 
24
24
 
25
 
            <link linkend="GimpSizeEntry-struct">GimpSizeEntry</link>;
26
 
            <link linkend="GimpSizeEntryField">GimpSizeEntryField</link>;
27
 
enum        <link linkend="GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</link>;
28
 
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gimp-size-entry-new">gimp_size_entry_new</link>             (<link linkend="gint">gint</link> number_of_fields,
29
 
                                             <link linkend="GimpUnit">GimpUnit</link> unit,
30
 
                                             const <link linkend="gchar">gchar</link> *unit_format,
31
 
                                             <link linkend="gboolean">gboolean</link> menu_show_pixels,
32
 
                                             <link linkend="gboolean">gboolean</link> menu_show_percent,
33
 
                                             <link linkend="gboolean">gboolean</link> show_refval,
34
 
                                             <link linkend="gint">gint</link> spinbutton_width,
35
 
                                             <link linkend="GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</link> update_policy);
36
 
<link linkend="void">void</link>        <link linkend="gimp-size-entry-add-field">gimp_size_entry_add_field</link>       (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
37
 
                                             <link linkend="GtkSpinButton">GtkSpinButton</link> *value_spinbutton,
38
 
                                             <link linkend="GtkSpinButton">GtkSpinButton</link> *refval_spinbutton);
39
 
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gimp-size-entry-attach-label">gimp_size_entry_attach_label</link>    (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
40
 
                                             const <link linkend="gchar">gchar</link> *text,
41
 
                                             <link linkend="gint">gint</link> row,
42
 
                                             <link linkend="gint">gint</link> column,
43
 
                                             <link linkend="gfloat">gfloat</link> alignment);
44
 
<link linkend="void">void</link>        <link linkend="gimp-size-entry-set-resolution">gimp_size_entry_set_resolution</link>  (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
45
 
                                             <link linkend="gint">gint</link> field,
46
 
                                             <link linkend="gdouble">gdouble</link> resolution,
47
 
                                             <link linkend="gboolean">gboolean</link> keep_size);
48
 
<link linkend="void">void</link>        <link linkend="gimp-size-entry-set-size">gimp_size_entry_set_size</link>        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
49
 
                                             <link linkend="gint">gint</link> field,
50
 
                                             <link linkend="gdouble">gdouble</link> lower,
51
 
                                             <link linkend="gdouble">gdouble</link> upper);
52
 
<link linkend="void">void</link>        <link linkend="gimp-size-entry-set-value-boundaries">gimp_size_entry_set_value_boundaries</link>
53
 
                                            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
54
 
                                             <link linkend="gint">gint</link> field,
55
 
                                             <link linkend="gdouble">gdouble</link> lower,
56
 
                                             <link linkend="gdouble">gdouble</link> upper);
57
 
<link linkend="gdouble">gdouble</link>     <link linkend="gimp-size-entry-get-value">gimp_size_entry_get_value</link>       (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
58
 
                                             <link linkend="gint">gint</link> field);
59
 
<link linkend="void">void</link>        <link linkend="gimp-size-entry-set-value">gimp_size_entry_set_value</link>       (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
60
 
                                             <link linkend="gint">gint</link> field,
61
 
                                             <link linkend="gdouble">gdouble</link> value);
62
 
<link linkend="void">void</link>        <link linkend="gimp-size-entry-set-refval-boundaries">gimp_size_entry_set_refval_boundaries</link>
63
 
                                            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
64
 
                                             <link linkend="gint">gint</link> field,
65
 
                                             <link linkend="gdouble">gdouble</link> lower,
66
 
                                             <link linkend="gdouble">gdouble</link> upper);
67
 
<link linkend="void">void</link>        <link linkend="gimp-size-entry-set-refval-digits">gimp_size_entry_set_refval_digits</link>
68
 
                                            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
69
 
                                             <link linkend="gint">gint</link> field,
70
 
                                             <link linkend="gint">gint</link> digits);
71
 
<link linkend="gdouble">gdouble</link>     <link linkend="gimp-size-entry-get-refval">gimp_size_entry_get_refval</link>      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
72
 
                                             <link linkend="gint">gint</link> field);
73
 
<link linkend="void">void</link>        <link linkend="gimp-size-entry-set-refval">gimp_size_entry_set_refval</link>      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
74
 
                                             <link linkend="gint">gint</link> field,
75
 
                                             <link linkend="gdouble">gdouble</link> refval);
76
 
<link linkend="GimpUnit">GimpUnit</link>    <link linkend="gimp-size-entry-get-unit">gimp_size_entry_get_unit</link>        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse);
77
 
<link linkend="void">void</link>        <link linkend="gimp-size-entry-set-unit">gimp_size_entry_set_unit</link>        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
78
 
                                             <link linkend="GimpUnit">GimpUnit</link> unit);
79
 
<link linkend="void">void</link>        <link linkend="gimp-size-entry-set-pixel-digits">gimp_size_entry_set_pixel_digits</link>
80
 
                                            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
81
 
                                             <link linkend="gint">gint</link> digits);
82
 
<link linkend="void">void</link>        <link linkend="gimp-size-entry-grab-focus">gimp_size_entry_grab_focus</link>      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse);
83
 
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gimp-size-entry-get-help-widget">gimp_size_entry_get_help_widget</link> (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
84
 
                                             <link linkend="gint">gint</link> field);
 
25
                    <link linkend="GimpSizeEntry-struct">GimpSizeEntry</link>;
 
26
                    <link linkend="GimpSizeEntryField">GimpSizeEntryField</link>;
 
27
enum                <link linkend="GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</link>;
 
28
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-size-entry-new">gimp_size_entry_new</link>                 (<link linkend="gint">gint</link> number_of_fields,
 
29
                                                         <link linkend="GimpUnit">GimpUnit</link> unit,
 
30
                                                         const <link linkend="gchar">gchar</link> *unit_format,
 
31
                                                         <link linkend="gboolean">gboolean</link> menu_show_pixels,
 
32
                                                         <link linkend="gboolean">gboolean</link> menu_show_percent,
 
33
                                                         <link linkend="gboolean">gboolean</link> show_refval,
 
34
                                                         <link linkend="gint">gint</link> spinbutton_width,
 
35
                                                         <link linkend="GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</link> update_policy);
 
36
<link linkend="void">void</link>                <link linkend="gimp-size-entry-add-field">gimp_size_entry_add_field</link>           (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
37
                                                         <link linkend="GtkSpinButton">GtkSpinButton</link> *value_spinbutton,
 
38
                                                         <link linkend="GtkSpinButton">GtkSpinButton</link> *refval_spinbutton);
 
39
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-size-entry-attach-label">gimp_size_entry_attach_label</link>        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
40
                                                         const <link linkend="gchar">gchar</link> *text,
 
41
                                                         <link linkend="gint">gint</link> row,
 
42
                                                         <link linkend="gint">gint</link> column,
 
43
                                                         <link linkend="gfloat">gfloat</link> alignment);
 
44
<link linkend="void">void</link>                <link linkend="gimp-size-entry-set-resolution">gimp_size_entry_set_resolution</link>      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
45
                                                         <link linkend="gint">gint</link> field,
 
46
                                                         <link linkend="gdouble">gdouble</link> resolution,
 
47
                                                         <link linkend="gboolean">gboolean</link> keep_size);
 
48
<link linkend="void">void</link>                <link linkend="gimp-size-entry-set-size">gimp_size_entry_set_size</link>            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
49
                                                         <link linkend="gint">gint</link> field,
 
50
                                                         <link linkend="gdouble">gdouble</link> lower,
 
51
                                                         <link linkend="gdouble">gdouble</link> upper);
 
52
<link linkend="void">void</link>                <link linkend="gimp-size-entry-set-value-boundaries">gimp_size_entry_set_value_boundaries</link>
 
53
                                                        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
54
                                                         <link linkend="gint">gint</link> field,
 
55
                                                         <link linkend="gdouble">gdouble</link> lower,
 
56
                                                         <link linkend="gdouble">gdouble</link> upper);
 
57
<link linkend="gdouble">gdouble</link>             <link linkend="gimp-size-entry-get-value">gimp_size_entry_get_value</link>           (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
58
                                                         <link linkend="gint">gint</link> field);
 
59
<link linkend="void">void</link>                <link linkend="gimp-size-entry-set-value">gimp_size_entry_set_value</link>           (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
60
                                                         <link linkend="gint">gint</link> field,
 
61
                                                         <link linkend="gdouble">gdouble</link> value);
 
62
<link linkend="void">void</link>                <link linkend="gimp-size-entry-set-refval-boundaries">gimp_size_entry_set_refval_boundaries</link>
 
63
                                                        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
64
                                                         <link linkend="gint">gint</link> field,
 
65
                                                         <link linkend="gdouble">gdouble</link> lower,
 
66
                                                         <link linkend="gdouble">gdouble</link> upper);
 
67
<link linkend="void">void</link>                <link linkend="gimp-size-entry-set-refval-digits">gimp_size_entry_set_refval_digits</link>   (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
68
                                                         <link linkend="gint">gint</link> field,
 
69
                                                         <link linkend="gint">gint</link> digits);
 
70
<link linkend="gdouble">gdouble</link>             <link linkend="gimp-size-entry-get-refval">gimp_size_entry_get_refval</link>          (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
71
                                                         <link linkend="gint">gint</link> field);
 
72
<link linkend="void">void</link>                <link linkend="gimp-size-entry-set-refval">gimp_size_entry_set_refval</link>          (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
73
                                                         <link linkend="gint">gint</link> field,
 
74
                                                         <link linkend="gdouble">gdouble</link> refval);
 
75
<link linkend="GimpUnit">GimpUnit</link>            <link linkend="gimp-size-entry-get-unit">gimp_size_entry_get_unit</link>            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse);
 
76
<link linkend="void">void</link>                <link linkend="gimp-size-entry-set-unit">gimp_size_entry_set_unit</link>            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
77
                                                         <link linkend="GimpUnit">GimpUnit</link> unit);
 
78
<link linkend="void">void</link>                <link linkend="gimp-size-entry-set-pixel-digits">gimp_size_entry_set_pixel_digits</link>    (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
79
                                                         <link linkend="gint">gint</link> digits);
 
80
<link linkend="void">void</link>                <link linkend="gimp-size-entry-show-unit-menu">gimp_size_entry_show_unit_menu</link>      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
81
                                                         <link linkend="gboolean">gboolean</link> show);
 
82
<link linkend="void">void</link>                <link linkend="gimp-size-entry-grab-focus">gimp_size_entry_grab_focus</link>          (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse);
 
83
<link linkend="void">void</link>                <link linkend="gimp-size-entry-set-activates-default">gimp_size_entry_set_activates_default</link>
 
84
                                                        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
85
                                                         <link linkend="gboolean">gboolean</link> setting);
 
86
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-size-entry-get-help-widget">gimp_size_entry_get_help_widget</link>     (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
87
                                                         <link linkend="gint">gint</link> field);
85
88
 
86
89
</synopsis>
87
90
</refsynopsisdiv>
88
91
 
89
 
<refsect1 id="object_hierarchy">
90
 
<title id="object_hierarchy.title">Object Hierarchy</title>
 
92
<refsect1 role="object_hierarchy">
 
93
<title role="object_hierarchy.title">Object Hierarchy</title>
91
94
<synopsis>
92
95
 
93
96
  <link linkend="GObject">GObject</link>
103
106
 
104
107
 
105
108
 
106
 
<refsect1 id="impl_interfaces">
107
 
<title id="impl_interfaces.title">Implemented Interfaces</title>
 
109
<refsect1 role="impl_interfaces">
 
110
<title role="impl_interfaces.title">Implemented Interfaces</title>
108
111
<para>
109
112
GimpSizeEntry implements
110
113
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>.</para>
113
116
 
114
117
 
115
118
 
116
 
<refsect1 id="signal_proto">
117
 
<title id="signal_proto.title">Signals</title>
 
119
<refsect1 role="signal_proto">
 
120
<title role="signal_proto.title">Signals</title>
118
121
<synopsis>
119
122
 
120
 
&quot;<link linkend="GimpSizeEntry-refval-changed">refval-changed</link>&quot;
121
 
            <link linkend="void">void</link>        user_function      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gimpsizeentry,
122
 
                                            <link linkend="gpointer">gpointer</link>       user_data)          : Run first
123
 
&quot;<link linkend="GimpSizeEntry-unit-changed">unit-changed</link>&quot;
124
 
            <link linkend="void">void</link>        user_function      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gimpsizeentry,
125
 
                                            <link linkend="gpointer">gpointer</link>       user_data)          : Run first
126
 
&quot;<link linkend="GimpSizeEntry-value-changed">value-changed</link>&quot;
127
 
            <link linkend="void">void</link>        user_function      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gimpsizeentry,
128
 
                                            <link linkend="gpointer">gpointer</link>       user_data)          : Run first
 
123
  &quot;<link linkend="GimpSizeEntry-refval-changed">refval-changed</link>&quot;                                 : Run First
 
124
  &quot;<link linkend="GimpSizeEntry-unit-changed">unit-changed</link>&quot;                                   : Run First
 
125
  &quot;<link linkend="GimpSizeEntry-value-changed">value-changed</link>&quot;                                  : Run First
129
126
</synopsis>
130
127
</refsect1>
131
128
 
132
129
 
133
 
<refsect1 id="desc">
134
 
<title id="desc.title">Description</title>
 
130
<refsect1 role="desc">
 
131
<title role="desc.title">Description</title>
135
132
<para>
136
133
This widget is used to enter pixel distances/sizes and resolutions.
137
134
</para>
159
156
</para>
160
157
</refsect1>
161
158
 
162
 
<refsect1 id="details">
163
 
<title id="details.title">Details</title>
 
159
<refsect1 role="details">
 
160
<title role="details.title">Details</title>
164
161
<refsect2>
165
162
<title><anchor id="GimpSizeEntry-struct" role="struct"/>GimpSizeEntry</title>
166
163
<indexterm><primary>GimpSizeEntry</primary></indexterm><programlisting>typedef struct _GimpSizeEntry GimpSizeEntry;</programlisting>
187
184
</para></refsect2>
188
185
<refsect2>
189
186
<title><anchor id="gimp-size-entry-new" role="function"/>gimp_size_entry_new ()</title>
190
 
<indexterm><primary>gimp_size_entry_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gimp_size_entry_new             (<link linkend="gint">gint</link> number_of_fields,
191
 
                                             <link linkend="GimpUnit">GimpUnit</link> unit,
192
 
                                             const <link linkend="gchar">gchar</link> *unit_format,
193
 
                                             <link linkend="gboolean">gboolean</link> menu_show_pixels,
194
 
                                             <link linkend="gboolean">gboolean</link> menu_show_percent,
195
 
                                             <link linkend="gboolean">gboolean</link> show_refval,
196
 
                                             <link linkend="gint">gint</link> spinbutton_width,
197
 
                                             <link linkend="GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</link> update_policy);</programlisting>
 
187
<indexterm><primary>gimp_size_entry_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_size_entry_new                 (<link linkend="gint">gint</link> number_of_fields,
 
188
                                                         <link linkend="GimpUnit">GimpUnit</link> unit,
 
189
                                                         const <link linkend="gchar">gchar</link> *unit_format,
 
190
                                                         <link linkend="gboolean">gboolean</link> menu_show_pixels,
 
191
                                                         <link linkend="gboolean">gboolean</link> menu_show_percent,
 
192
                                                         <link linkend="gboolean">gboolean</link> show_refval,
 
193
                                                         <link linkend="gint">gint</link> spinbutton_width,
 
194
                                                         <link linkend="GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</link> update_policy);</programlisting>
198
195
<para>
199
196
Creates a new <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link> widget.
200
197
</para>
270
267
</variablelist></refsect2>
271
268
<refsect2>
272
269
<title><anchor id="gimp-size-entry-add-field" role="function"/>gimp_size_entry_add_field ()</title>
273
 
<indexterm><primary>gimp_size_entry_add_field</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_size_entry_add_field       (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
274
 
                                             <link linkend="GtkSpinButton">GtkSpinButton</link> *value_spinbutton,
275
 
                                             <link linkend="GtkSpinButton">GtkSpinButton</link> *refval_spinbutton);</programlisting>
 
270
<indexterm><primary>gimp_size_entry_add_field</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_add_field           (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
271
                                                         <link linkend="GtkSpinButton">GtkSpinButton</link> *value_spinbutton,
 
272
                                                         <link linkend="GtkSpinButton">GtkSpinButton</link> *refval_spinbutton);</programlisting>
276
273
<para>
277
274
Adds an input field to the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>.
278
275
</para>
296
293
</variablelist></refsect2>
297
294
<refsect2>
298
295
<title><anchor id="gimp-size-entry-attach-label" role="function"/>gimp_size_entry_attach_label ()</title>
299
 
<indexterm><primary>gimp_size_entry_attach_label</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gimp_size_entry_attach_label    (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
300
 
                                             const <link linkend="gchar">gchar</link> *text,
301
 
                                             <link linkend="gint">gint</link> row,
302
 
                                             <link linkend="gint">gint</link> column,
303
 
                                             <link linkend="gfloat">gfloat</link> alignment);</programlisting>
 
296
<indexterm><primary>gimp_size_entry_attach_label</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_size_entry_attach_label        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
297
                                                         const <link linkend="gchar">gchar</link> *text,
 
298
                                                         <link linkend="gint">gint</link> row,
 
299
                                                         <link linkend="gint">gint</link> column,
 
300
                                                         <link linkend="gfloat">gfloat</link> alignment);</programlisting>
304
301
<para>
305
302
Attaches a <link linkend="GtkLabel"><type>GtkLabel</type></link> to the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link> (which is a <link linkend="GtkTable"><type>GtkTable</type></link>).</para>
306
303
<para>
326
323
</variablelist></refsect2>
327
324
<refsect2>
328
325
<title><anchor id="gimp-size-entry-set-resolution" role="function"/>gimp_size_entry_set_resolution ()</title>
329
 
<indexterm><primary>gimp_size_entry_set_resolution</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_size_entry_set_resolution  (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
330
 
                                             <link linkend="gint">gint</link> field,
331
 
                                             <link linkend="gdouble">gdouble</link> resolution,
332
 
                                             <link linkend="gboolean">gboolean</link> keep_size);</programlisting>
 
326
<indexterm><primary>gimp_size_entry_set_resolution</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_set_resolution      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
327
                                                         <link linkend="gint">gint</link> field,
 
328
                                                         <link linkend="gdouble">gdouble</link> resolution,
 
329
                                                         <link linkend="gboolean">gboolean</link> keep_size);</programlisting>
333
330
<para>
334
331
Sets the resolution (in dpi) for field # <parameter>field</parameter> of the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>.
335
332
</para>
359
356
</variablelist></refsect2>
360
357
<refsect2>
361
358
<title><anchor id="gimp-size-entry-set-size" role="function"/>gimp_size_entry_set_size ()</title>
362
 
<indexterm><primary>gimp_size_entry_set_size</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_size_entry_set_size        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
363
 
                                             <link linkend="gint">gint</link> field,
364
 
                                             <link linkend="gdouble">gdouble</link> lower,
365
 
                                             <link linkend="gdouble">gdouble</link> upper);</programlisting>
 
359
<indexterm><primary>gimp_size_entry_set_size</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_set_size            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
360
                                                         <link linkend="gint">gint</link> field,
 
361
                                                         <link linkend="gdouble">gdouble</link> lower,
 
362
                                                         <link linkend="gdouble">gdouble</link> upper);</programlisting>
366
363
<para>
367
364
Sets the pixel values for field # <parameter>field</parameter> of the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>
368
365
which will be treated as 0% and 100%.
393
390
</variablelist></refsect2>
394
391
<refsect2>
395
392
<title><anchor id="gimp-size-entry-set-value-boundaries" role="function"/>gimp_size_entry_set_value_boundaries ()</title>
396
 
<indexterm><primary>gimp_size_entry_set_value_boundaries</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_size_entry_set_value_boundaries
397
 
                                            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
398
 
                                             <link linkend="gint">gint</link> field,
399
 
                                             <link linkend="gdouble">gdouble</link> lower,
400
 
                                             <link linkend="gdouble">gdouble</link> upper);</programlisting>
 
393
<indexterm><primary>gimp_size_entry_set_value_boundaries</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_set_value_boundaries
 
394
                                                        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
395
                                                         <link linkend="gint">gint</link> field,
 
396
                                                         <link linkend="gdouble">gdouble</link> lower,
 
397
                                                         <link linkend="gdouble">gdouble</link> upper);</programlisting>
401
398
<para>
402
399
Limits the range of possible values which can be entered in field # <parameter>field</parameter>
403
400
of the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>.
407
404
new boundaries.
408
405
</para>
409
406
<para>
410
 
NOTE: In most cases you won't be interested in these values because the
 
407
NOTE: In most cases you won't be interested in this function because the
411
408
      <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>'s purpose is to shield the programmer from unit
412
409
      calculations. Use <link linkend="gimp-size-entry-set-refval-boundaries"><function>gimp_size_entry_set_refval_boundaries()</function></link> instead.
413
410
      Whatever you do, don't mix these calls. A size entry should either
430
427
</variablelist></refsect2>
431
428
<refsect2>
432
429
<title><anchor id="gimp-size-entry-get-value" role="function"/>gimp_size_entry_get_value ()</title>
433
 
<indexterm><primary>gimp_size_entry_get_value</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link>     gimp_size_entry_get_value       (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
434
 
                                             <link linkend="gint">gint</link> field);</programlisting>
 
430
<indexterm><primary>gimp_size_entry_get_value</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link>             gimp_size_entry_get_value           (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
431
                                                         <link linkend="gint">gint</link> field);</programlisting>
435
432
<para>
436
433
Returns the value of field # <parameter>field</parameter> of the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>.
437
434
</para>
458
455
</variablelist></refsect2>
459
456
<refsect2>
460
457
<title><anchor id="gimp-size-entry-set-value" role="function"/>gimp_size_entry_set_value ()</title>
461
 
<indexterm><primary>gimp_size_entry_set_value</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_size_entry_set_value       (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
462
 
                                             <link linkend="gint">gint</link> field,
463
 
                                             <link linkend="gdouble">gdouble</link> value);</programlisting>
 
458
<indexterm><primary>gimp_size_entry_set_value</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_set_value           (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
459
                                                         <link linkend="gint">gint</link> field,
 
460
                                                         <link linkend="gdouble">gdouble</link> value);</programlisting>
464
461
<para>
465
462
Sets the value for field # <parameter>field</parameter> of the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>.
466
463
</para>
488
485
</variablelist></refsect2>
489
486
<refsect2>
490
487
<title><anchor id="gimp-size-entry-set-refval-boundaries" role="function"/>gimp_size_entry_set_refval_boundaries ()</title>
491
 
<indexterm><primary>gimp_size_entry_set_refval_boundaries</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_size_entry_set_refval_boundaries
492
 
                                            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
493
 
                                             <link linkend="gint">gint</link> field,
494
 
                                             <link linkend="gdouble">gdouble</link> lower,
495
 
                                             <link linkend="gdouble">gdouble</link> upper);</programlisting>
 
488
<indexterm><primary>gimp_size_entry_set_refval_boundaries</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_set_refval_boundaries
 
489
                                                        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
490
                                                         <link linkend="gint">gint</link> field,
 
491
                                                         <link linkend="gdouble">gdouble</link> lower,
 
492
                                                         <link linkend="gdouble">gdouble</link> upper);</programlisting>
496
493
<para>
497
494
Limits the range of possible reference values which can be entered in
498
495
field # <parameter>field</parameter> of the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>.
519
516
</variablelist></refsect2>
520
517
<refsect2>
521
518
<title><anchor id="gimp-size-entry-set-refval-digits" role="function"/>gimp_size_entry_set_refval_digits ()</title>
522
 
<indexterm><primary>gimp_size_entry_set_refval_digits</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_size_entry_set_refval_digits
523
 
                                            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
524
 
                                             <link linkend="gint">gint</link> field,
525
 
                                             <link linkend="gint">gint</link> digits);</programlisting>
 
519
<indexterm><primary>gimp_size_entry_set_refval_digits</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_set_refval_digits   (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
520
                                                         <link linkend="gint">gint</link> field,
 
521
                                                         <link linkend="gint">gint</link> digits);</programlisting>
526
522
<para>
527
523
Sets the decimal digits of field # <parameter>field</parameter> of the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link> to
528
524
<parameter>digits</parameter>.
547
543
</variablelist></refsect2>
548
544
<refsect2>
549
545
<title><anchor id="gimp-size-entry-get-refval" role="function"/>gimp_size_entry_get_refval ()</title>
550
 
<indexterm><primary>gimp_size_entry_get_refval</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link>     gimp_size_entry_get_refval      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
551
 
                                             <link linkend="gint">gint</link> field);</programlisting>
 
546
<indexterm><primary>gimp_size_entry_get_refval</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link>             gimp_size_entry_get_refval          (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
547
                                                         <link linkend="gint">gint</link> field);</programlisting>
552
548
<para>
553
549
Returns the reference value for field # <parameter>field</parameter> of the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>.
554
550
</para>
570
566
</variablelist></refsect2>
571
567
<refsect2>
572
568
<title><anchor id="gimp-size-entry-set-refval" role="function"/>gimp_size_entry_set_refval ()</title>
573
 
<indexterm><primary>gimp_size_entry_set_refval</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_size_entry_set_refval      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
574
 
                                             <link linkend="gint">gint</link> field,
575
 
                                             <link linkend="gdouble">gdouble</link> refval);</programlisting>
 
569
<indexterm><primary>gimp_size_entry_set_refval</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_set_refval          (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
570
                                                         <link linkend="gint">gint</link> field,
 
571
                                                         <link linkend="gdouble">gdouble</link> refval);</programlisting>
576
572
<para>
577
573
Sets the reference value for field # <parameter>field</parameter> of the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>.
578
574
</para>
595
591
</variablelist></refsect2>
596
592
<refsect2>
597
593
<title><anchor id="gimp-size-entry-get-unit" role="function"/>gimp_size_entry_get_unit ()</title>
598
 
<indexterm><primary>gimp_size_entry_get_unit</primary></indexterm><programlisting><link linkend="GimpUnit">GimpUnit</link>    gimp_size_entry_get_unit        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse);</programlisting>
 
594
<indexterm><primary>gimp_size_entry_get_unit</primary></indexterm><programlisting><link linkend="GimpUnit">GimpUnit</link>            gimp_size_entry_get_unit            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse);</programlisting>
599
595
<para>
600
596
Returns the <link linkend="GimpUnit"><type>GimpUnit</type></link> the user has selected in the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>'s
601
597
<link linkend="GimpUnitMenu"><type>GimpUnitMenu</type></link>.</para>
610
606
</variablelist></refsect2>
611
607
<refsect2>
612
608
<title><anchor id="gimp-size-entry-set-unit" role="function"/>gimp_size_entry_set_unit ()</title>
613
 
<indexterm><primary>gimp_size_entry_set_unit</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_size_entry_set_unit        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
614
 
                                             <link linkend="GimpUnit">GimpUnit</link> unit);</programlisting>
 
609
<indexterm><primary>gimp_size_entry_set_unit</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_set_unit            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
610
                                                         <link linkend="GimpUnit">GimpUnit</link> unit);</programlisting>
615
611
<para>
616
612
Sets the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>'s unit. The reference value for all fields will
617
613
stay the same but the value in units or pixels per unit will change
629
625
</variablelist></refsect2>
630
626
<refsect2>
631
627
<title><anchor id="gimp-size-entry-set-pixel-digits" role="function"/>gimp_size_entry_set_pixel_digits ()</title>
632
 
<indexterm><primary>gimp_size_entry_set_pixel_digits</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_size_entry_set_pixel_digits
633
 
                                            (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
634
 
                                             <link linkend="gint">gint</link> digits);</programlisting>
 
628
<indexterm><primary>gimp_size_entry_set_pixel_digits</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_set_pixel_digits    (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
629
                                                         <link linkend="gint">gint</link> digits);</programlisting>
635
630
<para>
636
631
Similar to <link linkend="gimp-unit-menu-set-pixel-digits"><function>gimp_unit_menu_set_pixel_digits()</function></link>, this function allows
637
632
you set up a <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link> so that sub-pixel sizes can be entered.</para>
646
641
</simpara></listitem></varlistentry>
647
642
</variablelist></refsect2>
648
643
<refsect2>
 
644
<title><anchor id="gimp-size-entry-show-unit-menu" role="function" condition="since:GIMP 2.4"/>gimp_size_entry_show_unit_menu ()</title>
 
645
<indexterm role="GIMP 2.4"><primary>gimp_size_entry_show_unit_menu</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_show_unit_menu      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
646
                                                         <link linkend="gboolean">gboolean</link> show);</programlisting>
 
647
<para>
 
648
Controls whether a unit menu is shown in the size entry.  If
 
649
<parameter>show</parameter> is <link linkend="TRUE:CAPS"><type>TRUE</type></link>, the menu is shown; otherwise it is hidden.</para>
 
650
<para>
 
651
 
 
652
</para><variablelist role="params">
 
653
<varlistentry><term><parameter>gse</parameter>&nbsp;:</term>
 
654
<listitem><simpara> a <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link>
 
655
</simpara></listitem></varlistentry>
 
656
<varlistentry><term><parameter>show</parameter>&nbsp;:</term>
 
657
<listitem><simpara> Boolean
 
658
</simpara></listitem></varlistentry>
 
659
</variablelist><para role="since">Since  GIMP 2.4
 
660
</para></refsect2>
 
661
<refsect2>
649
662
<title><anchor id="gimp-size-entry-grab-focus" role="function"/>gimp_size_entry_grab_focus ()</title>
650
 
<indexterm><primary>gimp_size_entry_grab_focus</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_size_entry_grab_focus      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse);</programlisting>
 
663
<indexterm><primary>gimp_size_entry_grab_focus</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_grab_focus          (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse);</programlisting>
651
664
<para>
652
665
This function is rather ugly and just a workaround for the fact that
653
666
it's impossible to implement <link linkend="gtk-widget-grab-focus"><function>gtk_widget_grab_focus()</function></link> for a <link linkend="GtkTable"><type>GtkTable</type></link>.</para>
659
672
</simpara></listitem></varlistentry>
660
673
</variablelist></refsect2>
661
674
<refsect2>
 
675
<title><anchor id="gimp-size-entry-set-activates-default" role="function" condition="since:GIMP 2.4"/>gimp_size_entry_set_activates_default ()</title>
 
676
<indexterm role="GIMP 2.4"><primary>gimp_size_entry_set_activates_default</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_size_entry_set_activates_default
 
677
                                                        (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
678
                                                         <link linkend="gboolean">gboolean</link> setting);</programlisting>
 
679
<para>
 
680
Iterates over all entries in the <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link> and calls
 
681
<link linkend="gtk-entry-set-activates-default"><function>gtk_entry_set_activates_default()</function></link> on them.</para>
 
682
<para>
 
683
 
 
684
</para><variablelist role="params">
 
685
<varlistentry><term><parameter>gse</parameter>&nbsp;:</term>
 
686
<listitem><simpara> A <link linkend="GimpSizeEntr"><type>GimpSizeEntr</type></link>
 
687
</simpara></listitem></varlistentry>
 
688
<varlistentry><term><parameter>setting</parameter>&nbsp;:</term>
 
689
<listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to activate window's default widget on Enter keypress
 
690
</simpara></listitem></varlistentry>
 
691
</variablelist><para role="since">Since  GIMP 2.4
 
692
</para></refsect2>
 
693
<refsect2>
662
694
<title><anchor id="gimp-size-entry-get-help-widget" role="function"/>gimp_size_entry_get_help_widget ()</title>
663
 
<indexterm><primary>gimp_size_entry_get_help_widget</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gimp_size_entry_get_help_widget (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
664
 
                                             <link linkend="gint">gint</link> field);</programlisting>
 
695
<indexterm><primary>gimp_size_entry_get_help_widget</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_size_entry_get_help_widget     (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gse,
 
696
                                                         <link linkend="gint">gint</link> field);</programlisting>
665
697
<para>
666
698
You shouldn't fiddle with the internals of a <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link> but
667
699
if you want to set tooltips using <link linkend="gimp-help-set-help-data"><function>gimp_help_set_help_data()</function></link> you
681
713
 
682
714
</refsect1>
683
715
 
684
 
<refsect1 id="signals">
685
 
<title id="signals.title">Signal Details</title>
 
716
<refsect1 role="signals">
 
717
<title role="signals.title">Signal Details</title>
686
718
<refsect2><title><anchor id="GimpSizeEntry-refval-changed"/>The &quot;refval-changed&quot; signal</title>
687
 
<indexterm><primary>GimpSizeEntry::refval-changed</primary></indexterm><programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gimpsizeentry,
688
 
                                            <link linkend="gpointer">gpointer</link>       user_data)          : Run first</programlisting>
 
719
<indexterm><primary>GimpSizeEntry::refval-changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gimpsizeentry,
 
720
                                                        <link linkend="gpointer">gpointer</link>       user_data)          : Run First</programlisting>
689
721
<para>
690
722
 
691
723
</para><variablelist role="params">
696
728
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
697
729
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
698
730
</variablelist></refsect2><refsect2><title><anchor id="GimpSizeEntry-unit-changed"/>The &quot;unit-changed&quot; signal</title>
699
 
<indexterm><primary>GimpSizeEntry::unit-changed</primary></indexterm><programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gimpsizeentry,
700
 
                                            <link linkend="gpointer">gpointer</link>       user_data)          : Run first</programlisting>
 
731
<indexterm><primary>GimpSizeEntry::unit-changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gimpsizeentry,
 
732
                                                        <link linkend="gpointer">gpointer</link>       user_data)          : Run First</programlisting>
701
733
<para>
702
734
 
703
735
</para><variablelist role="params">
708
740
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
709
741
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
710
742
</variablelist></refsect2><refsect2><title><anchor id="GimpSizeEntry-value-changed"/>The &quot;value-changed&quot; signal</title>
711
 
<indexterm><primary>GimpSizeEntry::value-changed</primary></indexterm><programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gimpsizeentry,
712
 
                                            <link linkend="gpointer">gpointer</link>       user_data)          : Run first</programlisting>
 
743
<indexterm><primary>GimpSizeEntry::value-changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GimpSizeEntry">GimpSizeEntry</link> *gimpsizeentry,
 
744
                                                        <link linkend="gpointer">gpointer</link>       user_data)          : Run First</programlisting>
713
745
<para>
714
746
 
715
747
</para><variablelist role="params">