← Back to branch summary

~ubuntu-branches/ubuntu/trusty/gimp/trusty

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Ari Pollak
  • Date: 2009-08-14 09:57:17 UTC
  • mto: (1.1.21 upstream) (0.1.5 squeeze)
  • mto: This revision was merged to the branch mainline in revision 48.
  • Revision ID: james.westby@ubuntu.com-20090814095717-37dh2xqy5t0rurpk
Import upstream version 2.6.7

Show diffs side-by-side

added added

removed removed

Lines of Context:
devel-docs/libgimpwidgets/xml/gimpintcombobox.xml
12
12
<refnamediv>
13
13
<refname>GimpIntComboBox</refname>
14
14
<refpurpose>A widget providing a popup menu of integer values (e.g. enums).</refpurpose>
15
 
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
16
15
</refnamediv>
17
16
 
18
17
<refsynopsisdiv id="GimpIntComboBox.synopsis" role="synopsis">
22
21
                    <link linkend="GimpIntComboBox-struct">GimpIntComboBox</link>;
23
22
<link linkend="gboolean">gboolean</link>            (<link linkend="GimpIntSensitivityFunc">*GimpIntSensitivityFunc</link>)           (<link linkend="gint">gint</link> value,
24
23
                                                         <link linkend="gpointer">gpointer</link> data);
25
 
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-int-combo-box-new">gimp_int_combo_box_new</link>              (const <link linkend="gchar">gchar</link> *first_label,
 
24
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gimp-int-combo-box-new">gimp_int_combo_box_new</link>              (const <link linkend="gchar">gchar</link> *first_label,
26
25
                                                         <link linkend="gint">gint</link> first_value,
27
26
                                                         ...);
28
 
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-int-combo-box-new-valist">gimp_int_combo_box_new_valist</link>       (const <link linkend="gchar">gchar</link> *first_label,
 
27
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gimp-int-combo-box-new-valist">gimp_int_combo_box_new_valist</link>       (const <link linkend="gchar">gchar</link> *first_label,
29
28
                                                         <link linkend="gint">gint</link> first_value,
30
29
                                                         <link linkend="va-list">va_list</link> values);
31
 
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gimp-int-combo-box-new-array">gimp_int_combo_box_new_array</link>        (<link linkend="gint">gint</link> n_values,
 
30
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gimp-int-combo-box-new-array">gimp_int_combo_box_new_array</link>        (<link linkend="gint">gint</link> n_values,
32
31
                                                         const <link linkend="gchar">gchar</link> *labels[]);
33
32
<link linkend="void">void</link>                <link linkend="gimp-int-combo-box-prepend">gimp_int_combo_box_prepend</link>          (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
34
33
                                                         ...);
62
61
                                       +----GimpIntComboBox
63
62
                                             +----<link linkend="GimpEnumComboBox">GimpEnumComboBox</link>
64
63
</synopsis>
65
 
 
66
64
</refsect1>
67
65
 
68
66
 
71
69
<title role="impl_interfaces.title">Implemented Interfaces</title>
72
70
<para>
73
71
GimpIntComboBox implements
74
 
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link>,  <link linkend="GtkCellEditable">GtkCellEditable</link> and  <link linkend="GtkCellLayout">GtkCellLayout</link>.</para>
75
 
 
 
72
 <link linkend="GtkBuildable">GtkBuildable</link>,  <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkCellEditable">GtkCellEditable</link> and  <link linkend="GtkCellLayout">GtkCellLayout</link>.</para>
76
73
</refsect1>
77
74
 
78
75
 
96
93
<title role="details.title">Details</title>
97
94
<refsect2 id="GimpIntComboBox-struct" role="struct">
98
95
<title>GimpIntComboBox</title>
99
 
<indexterm zone="GimpIntComboBox-struct"><primary>GimpIntComboBox</primary></indexterm><programlisting>typedef struct _GimpIntComboBox GimpIntComboBox;</programlisting>
 
96
<indexterm zone="GimpIntComboBox-struct"><primary sortas="GimpIntComboBox">GimpIntComboBox</primary></indexterm><programlisting>typedef struct _GimpIntComboBox GimpIntComboBox;</programlisting>
100
97
<para>
101
 
 
102
98
</para></refsect2>
103
99
<refsect2 id="GimpIntSensitivityFunc" role="function">
104
100
<title>GimpIntSensitivityFunc ()</title>
105
 
<indexterm zone="GimpIntSensitivityFunc"><primary>GimpIntSensitivityFunc</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            (*GimpIntSensitivityFunc)           (<link linkend="gint">gint</link> value,
 
101
<indexterm zone="GimpIntSensitivityFunc"><primary sortas="GimpIntSensitivityFunc">GimpIntSensitivityFunc</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            (*GimpIntSensitivityFunc)           (<link linkend="gint">gint</link> value,
106
102
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
107
103
<para>
108
 
 
109
104
</para><variablelist role="params">
110
 
<varlistentry><term><parameter>value</parameter>&nbsp;:</term>
111
 
<listitem><simpara>
112
 
</simpara></listitem></varlistentry>
113
 
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
114
 
<listitem><simpara>
115
 
</simpara></listitem></varlistentry>
116
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
117
 
 
118
 
 
 
105
<varlistentry><term><parameter>value</parameter>&#160;:</term>
 
106
<listitem><simpara>
 
107
</simpara></listitem></varlistentry>
 
108
<varlistentry><term><parameter>data</parameter>&#160;:</term>
 
109
<listitem><simpara>
 
110
</simpara></listitem></varlistentry>
 
111
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
119
112
</simpara></listitem></varlistentry>
120
113
</variablelist></refsect2>
121
114
<refsect2 id="gimp-int-combo-box-new" role="function" condition="since:GIMP 2.2">
122
115
<title>gimp_int_combo_box_new ()</title>
123
 
<indexterm zone="gimp-int-combo-box-new" role="GIMP 2.2"><primary>gimp_int_combo_box_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_int_combo_box_new              (const <link linkend="gchar">gchar</link> *first_label,
 
116
<indexterm zone="gimp-int-combo-box-new" role="GIMP 2.2"><primary sortas="gimp_int_combo_box_new">gimp_int_combo_box_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gimp_int_combo_box_new              (const <link linkend="gchar">gchar</link> *first_label,
124
117
                                                         <link linkend="gint">gint</link> first_value,
125
118
                                                         ...);</programlisting>
126
119
<para>
127
120
Creates a GtkComboBox that has integer values associated with each
128
 
item. The items to fill the combo box with are specified as a <link linkend="NULL:CAPS"><literal>NULL</literal></link>
 
121
item. The items to fill the combo box with are specified as a <link linkend="NULL--CAPS"><literal>NULL</literal></link>
129
122
terminated list of label/value pairs.
130
123
</para>
131
124
<para>
132
125
If you need to construct an empty <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>, it's best to use
133
126
g_object_new (GIMP_TYPE_INT_COMBO_BOX, NULL).</para>
134
127
<para>
135
 
 
136
128
</para><variablelist role="params">
137
 
<varlistentry><term><parameter>first_label</parameter>&nbsp;:</term>
 
129
<varlistentry><term><parameter>first_label</parameter>&#160;:</term>
138
130
<listitem><simpara> the label of the first item
139
131
</simpara></listitem></varlistentry>
140
 
<varlistentry><term><parameter>first_value</parameter>&nbsp;:</term>
 
132
<varlistentry><term><parameter>first_value</parameter>&#160;:</term>
141
133
<listitem><simpara> the value of the first item
142
134
</simpara></listitem></varlistentry>
143
 
<varlistentry><term><parameter>...</parameter>&nbsp;:</term>
144
 
<listitem><simpara> a <link linkend="NULL:CAPS"><literal>NULL</literal></link> terminated list of more label, value pairs
 
135
<varlistentry><term><parameter>...</parameter>&#160;:</term>
 
136
<listitem><simpara> a <link linkend="NULL--CAPS"><literal>NULL</literal></link> terminated list of more label, value pairs
145
137
</simpara></listitem></varlistentry>
146
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a new <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>.
 
138
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>.
147
139
 
148
140
</simpara></listitem></varlistentry>
149
 
</variablelist><para role="since">Since  GIMP 2.2
150
 
</para></refsect2>
 
141
</variablelist><para role="since">Since GIMP 2.2</para></refsect2>
151
142
<refsect2 id="gimp-int-combo-box-new-valist" role="function" condition="since:GIMP 2.2">
152
143
<title>gimp_int_combo_box_new_valist ()</title>
153
 
<indexterm zone="gimp-int-combo-box-new-valist" role="GIMP 2.2"><primary>gimp_int_combo_box_new_valist</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_int_combo_box_new_valist       (const <link linkend="gchar">gchar</link> *first_label,
 
144
<indexterm zone="gimp-int-combo-box-new-valist" role="GIMP 2.2"><primary sortas="gimp_int_combo_box_new_valist">gimp_int_combo_box_new_valist</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gimp_int_combo_box_new_valist       (const <link linkend="gchar">gchar</link> *first_label,
154
145
                                                         <link linkend="gint">gint</link> first_value,
155
146
                                                         <link linkend="va-list">va_list</link> values);</programlisting>
156
147
<para>
157
148
A variant of <link linkend="gimp-int-combo-box-new"><function>gimp_int_combo_box_new()</function></link> that takes a va_list of
158
149
label/value pairs. Probably only useful for language bindings.</para>
159
150
<para>
160
 
 
161
151
</para><variablelist role="params">
162
 
<varlistentry><term><parameter>first_label</parameter>&nbsp;:</term>
 
152
<varlistentry><term><parameter>first_label</parameter>&#160;:</term>
163
153
<listitem><simpara> the label of the first item
164
154
</simpara></listitem></varlistentry>
165
 
<varlistentry><term><parameter>first_value</parameter>&nbsp;:</term>
 
155
<varlistentry><term><parameter>first_value</parameter>&#160;:</term>
166
156
<listitem><simpara> the value of the first item
167
157
</simpara></listitem></varlistentry>
168
 
<varlistentry><term><parameter>values</parameter>&nbsp;:</term>
 
158
<varlistentry><term><parameter>values</parameter>&#160;:</term>
169
159
<listitem><simpara> a va_list with more values
170
160
</simpara></listitem></varlistentry>
171
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a new <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>.
 
161
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>.
172
162
 
173
163
</simpara></listitem></varlistentry>
174
 
</variablelist><para role="since">Since  GIMP 2.2
175
 
</para></refsect2>
 
164
</variablelist><para role="since">Since GIMP 2.2</para></refsect2>
176
165
<refsect2 id="gimp-int-combo-box-new-array" role="function" condition="since:GIMP 2.2">
177
166
<title>gimp_int_combo_box_new_array ()</title>
178
 
<indexterm zone="gimp-int-combo-box-new-array" role="GIMP 2.2"><primary>gimp_int_combo_box_new_array</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gimp_int_combo_box_new_array        (<link linkend="gint">gint</link> n_values,
 
167
<indexterm zone="gimp-int-combo-box-new-array" role="GIMP 2.2"><primary sortas="gimp_int_combo_box_new_array">gimp_int_combo_box_new_array</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gimp_int_combo_box_new_array        (<link linkend="gint">gint</link> n_values,
179
168
                                                         const <link linkend="gchar">gchar</link> *labels[]);</programlisting>
180
169
<para>
181
170
A variant of <link linkend="gimp-int-combo-box-new"><function>gimp_int_combo_box_new()</function></link> that takes an array of labels.
182
171
The array indices are used as values.</para>
183
172
<para>
184
 
 
185
173
</para><variablelist role="params">
186
 
<varlistentry><term><parameter>n_values</parameter>&nbsp;:</term>
 
174
<varlistentry><term><parameter>n_values</parameter>&#160;:</term>
187
175
<listitem><simpara> the number of values
188
176
</simpara></listitem></varlistentry>
189
 
<varlistentry><term><parameter>labels</parameter>&nbsp;:</term>
 
177
<varlistentry><term><parameter>labels</parameter>&#160;:</term>
190
178
<listitem><simpara>   an array of labels (array length must be <parameter>n_values</parameter>)
191
179
</simpara></listitem></varlistentry>
192
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a new <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>.
 
180
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>.
193
181
 
194
182
</simpara></listitem></varlistentry>
195
 
</variablelist><para role="since">Since  GIMP 2.2
196
 
</para></refsect2>
 
183
</variablelist><para role="since">Since GIMP 2.2</para></refsect2>
197
184
<refsect2 id="gimp-int-combo-box-prepend" role="function" condition="since:GIMP 2.2">
198
185
<title>gimp_int_combo_box_prepend ()</title>
199
 
<indexterm zone="gimp-int-combo-box-prepend" role="GIMP 2.2"><primary>gimp_int_combo_box_prepend</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_int_combo_box_prepend          (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
 
186
<indexterm zone="gimp-int-combo-box-prepend" role="GIMP 2.2"><primary sortas="gimp_int_combo_box_prepend">gimp_int_combo_box_prepend</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_int_combo_box_prepend          (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
200
187
                                                         ...);</programlisting>
201
188
<para>
202
189
This function provides a convenient way to prepend items to a
206
193
<para>
207
194
The column number must be taken from the enum <link linkend="GimpIntStoreColumns"><type>GimpIntStoreColumns</type></link>.</para>
208
195
<para>
209
 
 
210
196
</para><variablelist role="params">
211
 
<varlistentry><term><parameter>combo_box</parameter>&nbsp;:</term>
 
197
<varlistentry><term><parameter>combo_box</parameter>&#160;:</term>
212
198
<listitem><simpara> a <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>
213
199
</simpara></listitem></varlistentry>
214
 
<varlistentry><term><parameter>...</parameter>&nbsp;:</term>
 
200
<varlistentry><term><parameter>...</parameter>&#160;:</term>
215
201
<listitem><simpara>       pairs of column number and value, terminated with -1
216
202
</simpara></listitem></varlistentry>
217
 
</variablelist><para role="since">Since  GIMP 2.2
218
 
</para></refsect2>
 
203
</variablelist><para role="since">Since GIMP 2.2</para></refsect2>
219
204
<refsect2 id="gimp-int-combo-box-append" role="function" condition="since:GIMP 2.2">
220
205
<title>gimp_int_combo_box_append ()</title>
221
 
<indexterm zone="gimp-int-combo-box-append" role="GIMP 2.2"><primary>gimp_int_combo_box_append</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_int_combo_box_append           (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
 
206
<indexterm zone="gimp-int-combo-box-append" role="GIMP 2.2"><primary sortas="gimp_int_combo_box_append">gimp_int_combo_box_append</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_int_combo_box_append           (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
222
207
                                                         ...);</programlisting>
223
208
<para>
224
209
This function provides a convenient way to append items to a
228
213
<para>
229
214
The column number must be taken from the enum <link linkend="GimpIntStoreColumns"><type>GimpIntStoreColumns</type></link>.</para>
230
215
<para>
231
 
 
232
216
</para><variablelist role="params">
233
 
<varlistentry><term><parameter>combo_box</parameter>&nbsp;:</term>
 
217
<varlistentry><term><parameter>combo_box</parameter>&#160;:</term>
234
218
<listitem><simpara> a <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>
235
219
</simpara></listitem></varlistentry>
236
 
<varlistentry><term><parameter>...</parameter>&nbsp;:</term>
 
220
<varlistentry><term><parameter>...</parameter>&#160;:</term>
237
221
<listitem><simpara>       pairs of column number and value, terminated with -1
238
222
</simpara></listitem></varlistentry>
239
 
</variablelist><para role="since">Since  GIMP 2.2
240
 
</para></refsect2>
 
223
</variablelist><para role="since">Since GIMP 2.2</para></refsect2>
241
224
<refsect2 id="gimp-int-combo-box-set-active" role="function" condition="since:GIMP 2.2">
242
225
<title>gimp_int_combo_box_set_active ()</title>
243
 
<indexterm zone="gimp-int-combo-box-set-active" role="GIMP 2.2"><primary>gimp_int_combo_box_set_active</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_int_combo_box_set_active       (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
 
226
<indexterm zone="gimp-int-combo-box-set-active" role="GIMP 2.2"><primary sortas="gimp_int_combo_box_set_active">gimp_int_combo_box_set_active</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_int_combo_box_set_active       (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
244
227
                                                         <link linkend="gint">gint</link> value);</programlisting>
245
228
<para>
246
229
Looks up the item that belongs to the given <parameter>value</parameter> and makes it the
247
230
selected item in the <parameter>combo_box</parameter>.</para>
248
231
<para>
249
 
 
250
232
</para><variablelist role="params">
251
 
<varlistentry><term><parameter>combo_box</parameter>&nbsp;:</term>
 
233
<varlistentry><term><parameter>combo_box</parameter>&#160;:</term>
252
234
<listitem><simpara> a <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>
253
235
</simpara></listitem></varlistentry>
254
 
<varlistentry><term><parameter>value</parameter>&nbsp;:</term>
 
236
<varlistentry><term><parameter>value</parameter>&#160;:</term>
255
237
<listitem><simpara>     an integer value
256
238
</simpara></listitem></varlistentry>
257
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if there was no item for
 
239
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> on success or <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> if there was no item for
258
240
              this value.
259
241
 
260
242
</simpara></listitem></varlistentry>
261
 
</variablelist><para role="since">Since  GIMP 2.2
262
 
</para></refsect2>
 
243
</variablelist><para role="since">Since GIMP 2.2</para></refsect2>
263
244
<refsect2 id="gimp-int-combo-box-get-active" role="function" condition="since:GIMP 2.2">
264
245
<title>gimp_int_combo_box_get_active ()</title>
265
 
<indexterm zone="gimp-int-combo-box-get-active" role="GIMP 2.2"><primary>gimp_int_combo_box_get_active</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_int_combo_box_get_active       (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
 
246
<indexterm zone="gimp-int-combo-box-get-active" role="GIMP 2.2"><primary sortas="gimp_int_combo_box_get_active">gimp_int_combo_box_get_active</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_int_combo_box_get_active       (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
266
247
                                                         <link linkend="gint">gint</link> *value);</programlisting>
267
248
<para>
268
249
Retrieves the value of the selected (active) item in the <parameter>combo_box</parameter>.</para>
269
250
<para>
270
 
 
271
251
</para><variablelist role="params">
272
 
<varlistentry><term><parameter>combo_box</parameter>&nbsp;:</term>
 
252
<varlistentry><term><parameter>combo_box</parameter>&#160;:</term>
273
253
<listitem><simpara> a <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>
274
254
</simpara></listitem></varlistentry>
275
 
<varlistentry><term><parameter>value</parameter>&nbsp;:</term>
 
255
<varlistentry><term><parameter>value</parameter>&#160;:</term>
276
256
<listitem><simpara>     return location for the integer value
277
257
</simpara></listitem></varlistentry>
278
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>value</parameter> has been set or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if no item was
 
258
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if <parameter>value</parameter> has been set or <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> if no item was
279
259
              active.
280
260
 
281
261
</simpara></listitem></varlistentry>
282
 
</variablelist><para role="since">Since  GIMP 2.2
283
 
</para></refsect2>
 
262
</variablelist><para role="since">Since GIMP 2.2</para></refsect2>
284
263
<refsect2 id="gimp-int-combo-box-connect" role="function" condition="since:GIMP 2.2">
285
264
<title>gimp_int_combo_box_connect ()</title>
286
 
<indexterm zone="gimp-int-combo-box-connect" role="GIMP 2.2"><primary>gimp_int_combo_box_connect</primary></indexterm><programlisting><link linkend="gulong">gulong</link>              gimp_int_combo_box_connect          (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
 
265
<indexterm zone="gimp-int-combo-box-connect" role="GIMP 2.2"><primary sortas="gimp_int_combo_box_connect">gimp_int_combo_box_connect</primary></indexterm><programlisting><link linkend="gulong">gulong</link>              gimp_int_combo_box_connect          (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
287
266
                                                         <link linkend="gint">gint</link> value,
288
267
                                                         <link linkend="GCallback">GCallback</link> callback,
289
268
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
299
278
<link linkend="gimp-drawable-combo-box-new"><function>gimp_drawable_combo_box_new()</function></link>. If you pass an invalid initial
300
279
<parameter>value</parameter>, the <parameter>callback</parameter> will be called with the default item active.</para>
301
280
<para>
302
 
 
303
281
</para><variablelist role="params">
304
 
<varlistentry><term><parameter>combo_box</parameter>&nbsp;:</term>
 
282
<varlistentry><term><parameter>combo_box</parameter>&#160;:</term>
305
283
<listitem><simpara> a <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>
306
284
</simpara></listitem></varlistentry>
307
 
<varlistentry><term><parameter>value</parameter>&nbsp;:</term>
 
285
<varlistentry><term><parameter>value</parameter>&#160;:</term>
308
286
<listitem><simpara>     the value to set
309
287
</simpara></listitem></varlistentry>
310
 
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
 
288
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
311
289
<listitem><simpara>  a callback to connect to the <parameter>combo_box</parameter>'s "changed" signal
312
290
</simpara></listitem></varlistentry>
313
 
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
 
291
<varlistentry><term><parameter>data</parameter>&#160;:</term>
314
292
<listitem><simpara>      a pointer passed as data to <link linkend="g-signal-connect"><function>g_signal_connect()</function></link>
315
293
</simpara></listitem></varlistentry>
316
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the signal handler ID as returned by <link linkend="g-signal-connect"><function>g_signal_connect()</function></link>
 
294
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the signal handler ID as returned by <link linkend="g-signal-connect"><function>g_signal_connect()</function></link>
317
295
 
318
296
</simpara></listitem></varlistentry>
319
 
</variablelist><para role="since">Since  GIMP 2.2
320
 
</para></refsect2>
 
297
</variablelist><para role="since">Since GIMP 2.2</para></refsect2>
321
298
<refsect2 id="gimp-int-combo-box-set-sensitivity" role="function" condition="since:GIMP 2.4">
322
299
<title>gimp_int_combo_box_set_sensitivity ()</title>
323
 
<indexterm zone="gimp-int-combo-box-set-sensitivity" role="GIMP 2.4"><primary>gimp_int_combo_box_set_sensitivity</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_int_combo_box_set_sensitivity  (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
 
300
<indexterm zone="gimp-int-combo-box-set-sensitivity" role="GIMP 2.4"><primary sortas="gimp_int_combo_box_set_sensitivity">gimp_int_combo_box_set_sensitivity</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_int_combo_box_set_sensitivity  (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
324
301
                                                         <link linkend="GimpIntSensitivityFunc">GimpIntSensitivityFunc</link> func,
325
302
                                                         <link linkend="gpointer">gpointer</link> data,
326
303
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);</programlisting>
333
310
Calling <link linkend="gtk-widget-queue-draw"><function>gtk_widget_queue_draw()</function></link> on the <parameter>combo_box</parameter> will cause the
334
311
sensitivity to be updated.</para>
335
312
<para>
336
 
 
337
313
</para><variablelist role="params">
338
 
<varlistentry><term><parameter>combo_box</parameter>&nbsp;:</term>
 
314
<varlistentry><term><parameter>combo_box</parameter>&#160;:</term>
339
315
<listitem><simpara> a <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>
340
316
</simpara></listitem></varlistentry>
341
 
<varlistentry><term><parameter>func</parameter>&nbsp;:</term>
342
 
<listitem><simpara> a function that returns a boolean value, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to unset
 
317
<varlistentry><term><parameter>func</parameter>&#160;:</term>
 
318
<listitem><simpara> a function that returns a boolean value, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> to unset
343
319
</simpara></listitem></varlistentry>
344
 
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
 
320
<varlistentry><term><parameter>data</parameter>&#160;:</term>
345
321
<listitem><simpara> data to pass to <parameter>func</parameter>
346
322
</simpara></listitem></varlistentry>
347
 
<varlistentry><term><parameter>destroy</parameter>&nbsp;:</term>
 
323
<varlistentry><term><parameter>destroy</parameter>&#160;:</term>
348
324
<listitem><simpara> destroy notification for <parameter>data</parameter>
349
325
</simpara></listitem></varlistentry>
350
 
</variablelist><para role="since">Since  GIMP 2.4
351
 
</para></refsect2>
 
326
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
352
327
 
353
328
</refsect1>
354
329
<refsect1 id="GimpIntComboBox.property-details" role="property_details">
355
330
<title role="property_details.title">Property Details</title>
356
 
<refsect2 id="GimpIntComboBox--ellipsize"><title>The <literal>&quot;ellipsize&quot;</literal> property</title>
357
 
<indexterm zone="GimpIntComboBox--ellipsize" role="GIMP 2.4"><primary>GimpIntComboBox:ellipsize</primary></indexterm><programlisting>  &quot;ellipsize&quot;                <link linkend="PangoEllipsizeMode">PangoEllipsizeMode</link>    : Read / Write</programlisting>
 
331
<refsect2 id="GimpIntComboBox--ellipsize" role="property"><title>The <literal>&quot;ellipsize&quot;</literal> property</title>
 
332
<indexterm zone="GimpIntComboBox--ellipsize" role="GIMP 2.4"><primary sortas="GimpIntComboBox:ellipsize">GimpIntComboBox:ellipsize</primary></indexterm><programlisting>  &quot;ellipsize&quot;                <link linkend="PangoEllipsizeMode">PangoEllipsizeMode</link>    : Read / Write</programlisting>
358
333
<para>
359
334
Specifies the preferred place to ellipsize text in the combo-box,
360
335
if the cell renderer does not have enough room to display the
361
336
entire string.</para>
362
337
<para>
363
 
 
364
338
</para><para>Default value: PANGO_ELLIPSIZE_NONE</para>
365
 
<para>Since  GIMP 2.4
366
 
</para>
 
339
<para>Since GIMP 2.4</para>
367
340
</refsect2>
368
 
 
369
341
</refsect1>
370
342
 
371
343