← 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/gimpintcombobox.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/gimpintcombobox.xml
4
4
 
5
5
<refentry id="GimpIntComboBox">
6
6
<refmeta>
7
 
<refentrytitle id="top_of_page">GimpIntComboBox</refentrytitle>
 
7
<refentrytitle role="top_of_page">GimpIntComboBox</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="GimpIntComboBox-struct">GimpIntComboBox</link>;
26
 
<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,
27
 
                                             <link linkend="gint">gint</link> first_value,
28
 
                                             ...);
29
 
<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,
30
 
                                             <link linkend="gint">gint</link> first_value,
31
 
                                             <link linkend="va-list">va_list</link> values);
32
 
<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,
33
 
                                             const <link linkend="gchar">gchar</link> *labels[]);
34
 
<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,
35
 
                                             ...);
36
 
<link linkend="void">void</link>        <link linkend="gimp-int-combo-box-append">gimp_int_combo_box_append</link>       (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
37
 
                                             ...);
38
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-int-combo-box-set-active">gimp_int_combo_box_set_active</link>   (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
39
 
                                             <link linkend="gint">gint</link> value);
40
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-int-combo-box-get-active">gimp_int_combo_box_get_active</link>   (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
41
 
                                             <link linkend="gint">gint</link> *value);
42
 
<link linkend="gulong">gulong</link>      <link linkend="gimp-int-combo-box-connect">gimp_int_combo_box_connect</link>      (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
43
 
                                             <link linkend="gint">gint</link> value,
44
 
                                             <link linkend="GCallback">GCallback</link> callback,
45
 
                                             <link linkend="gpointer">gpointer</link> data);
 
25
                    <link linkend="GimpIntComboBox-struct">GimpIntComboBox</link>;
 
26
<link linkend="gboolean">gboolean</link>            (<link linkend="GimpIntSensitivityFunc">*GimpIntSensitivityFunc</link>)           (<link linkend="gint">gint</link> value,
 
27
                                                         <link linkend="gpointer">gpointer</link> data);
 
28
<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,
 
29
                                                         <link linkend="gint">gint</link> first_value,
 
30
                                                         ...);
 
31
<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,
 
32
                                                         <link linkend="gint">gint</link> first_value,
 
33
                                                         <link linkend="va-list">va_list</link> values);
 
34
<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,
 
35
                                                         const <link linkend="gchar">gchar</link> *labels[]);
 
36
<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,
 
37
                                                         ...);
 
38
<link linkend="void">void</link>                <link linkend="gimp-int-combo-box-append">gimp_int_combo_box_append</link>           (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
 
39
                                                         ...);
 
40
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-int-combo-box-set-active">gimp_int_combo_box_set_active</link>       (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
 
41
                                                         <link linkend="gint">gint</link> value);
 
42
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-int-combo-box-get-active">gimp_int_combo_box_get_active</link>       (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
 
43
                                                         <link linkend="gint">gint</link> *value);
 
44
<link linkend="gulong">gulong</link>              <link linkend="gimp-int-combo-box-connect">gimp_int_combo_box_connect</link>          (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
 
45
                                                         <link linkend="gint">gint</link> value,
 
46
                                                         <link linkend="GCallback">GCallback</link> callback,
 
47
                                                         <link linkend="gpointer">gpointer</link> data);
 
48
<link linkend="void">void</link>                <link linkend="gimp-int-combo-box-set-sensitivity">gimp_int_combo_box_set_sensitivity</link>  (<link linkend="GimpIntComboBox">GimpIntComboBox</link> *combo_box,
 
49
                                                         <link linkend="GimpIntSensitivityFunc">GimpIntSensitivityFunc</link> func,
 
50
                                                         <link linkend="gpointer">gpointer</link> data,
 
51
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);
46
52
 
47
53
</synopsis>
48
54
</refsynopsisdiv>
49
55
 
50
 
<refsect1 id="object_hierarchy">
51
 
<title id="object_hierarchy.title">Object Hierarchy</title>
 
56
<refsect1 role="object_hierarchy">
 
57
<title role="object_hierarchy.title">Object Hierarchy</title>
52
58
<synopsis>
53
59
 
54
60
  <link linkend="GObject">GObject</link>
59
65
                           +----<link linkend="GtkBin">GtkBin</link>
60
66
                                 +----<link linkend="GtkComboBox">GtkComboBox</link>
61
67
                                       +----GimpIntComboBox
 
68
                                             +----<link linkend="GimpEnumComboBox">GimpEnumComboBox</link>
62
69
</synopsis>
63
70
 
64
71
</refsect1>
65
72
 
66
73
 
67
74
 
68
 
<refsect1 id="impl_interfaces">
69
 
<title id="impl_interfaces.title">Implemented Interfaces</title>
 
75
<refsect1 role="impl_interfaces">
 
76
<title role="impl_interfaces.title">Implemented Interfaces</title>
70
77
<para>
71
78
GimpIntComboBox implements
72
79
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkCellEditable">GtkCellEditable</link> and  <link linkend="GtkCellLayout">GtkCellLayout</link>.</para>
74
81
</refsect1>
75
82
 
76
83
 
77
 
 
78
 
 
79
 
 
80
 
<refsect1 id="desc">
81
 
<title id="desc.title">Description</title>
 
84
<refsect1 role="properties">
 
85
<title role="properties.title">Properties</title>
 
86
<synopsis>
 
87
 
 
88
  &quot;<link linkend="GimpIntComboBox--ellipsize">ellipsize</link>&quot;                <link linkend="PangoEllipsizeMode">PangoEllipsizeMode</link>    : Read / Write
 
89
</synopsis>
 
90
</refsect1>
 
91
 
 
92
 
 
93
 
 
94
<refsect1 role="desc">
 
95
<title role="desc.title">Description</title>
82
96
<para>
83
97
A widget providing a popup menu of integer values (e.g. enums).
84
98
</para>
85
99
</refsect1>
86
100
 
87
 
<refsect1 id="details">
88
 
<title id="details.title">Details</title>
 
101
<refsect1 role="details">
 
102
<title role="details.title">Details</title>
89
103
<refsect2>
90
104
<title><anchor id="GimpIntComboBox-struct" role="struct"/>GimpIntComboBox</title>
91
105
<indexterm><primary>GimpIntComboBox</primary></indexterm><programlisting>typedef struct _GimpIntComboBox GimpIntComboBox;</programlisting>
93
107
 
94
108
</para></refsect2>
95
109
<refsect2>
 
110
<title><anchor id="GimpIntSensitivityFunc" role="function"/>GimpIntSensitivityFunc ()</title>
 
111
<indexterm><primary>GimpIntSensitivityFunc</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            (*GimpIntSensitivityFunc)           (<link linkend="gint">gint</link> value,
 
112
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
 
113
<para>
 
114
 
 
115
</para><variablelist role="params">
 
116
<varlistentry><term><parameter>value</parameter>&nbsp;:</term>
 
117
<listitem><simpara>
 
118
</simpara></listitem></varlistentry>
 
119
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
 
120
<listitem><simpara>
 
121
</simpara></listitem></varlistentry>
 
122
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>
 
123
 
 
124
 
 
125
</simpara></listitem></varlistentry>
 
126
</variablelist></refsect2>
 
127
<refsect2>
96
128
<title><anchor id="gimp-int-combo-box-new" role="function" condition="since:GIMP 2.2"/>gimp_int_combo_box_new ()</title>
97
 
<indexterm 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,
98
 
                                             <link linkend="gint">gint</link> first_value,
99
 
                                             ...);</programlisting>
 
129
<indexterm 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,
 
130
                                                         <link linkend="gint">gint</link> first_value,
 
131
                                                         ...);</programlisting>
100
132
<para>
101
133
Creates a GtkComboBox that has integer values associated with each
102
134
item. The items to fill the combo box with are specified as a <link linkend="NULL:CAPS"><literal>NULL</literal></link>
103
 
terminated list of label/value pairs.</para>
 
135
terminated list of label/value pairs.
 
136
</para>
 
137
<para>
 
138
If you need to construct an empty <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>, it's best to use
 
139
g_object_new (GIMP_TYPE_INT_COMBO_BOX, NULL).</para>
104
140
<para>
105
141
 
106
142
</para><variablelist role="params">
116
152
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a new <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>.
117
153
 
118
154
</simpara></listitem></varlistentry>
119
 
</variablelist><para>Since  GIMP 2.2
 
155
</variablelist><para role="since">Since  GIMP 2.2
120
156
</para></refsect2>
121
157
<refsect2>
122
158
<title><anchor id="gimp-int-combo-box-new-valist" role="function" condition="since:GIMP 2.2"/>gimp_int_combo_box_new_valist ()</title>
123
 
<indexterm 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,
124
 
                                             <link linkend="gint">gint</link> first_value,
125
 
                                             <link linkend="va-list">va_list</link> values);</programlisting>
 
159
<indexterm 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,
 
160
                                                         <link linkend="gint">gint</link> first_value,
 
161
                                                         <link linkend="va-list">va_list</link> values);</programlisting>
126
162
<para>
127
163
A variant of <link linkend="gimp-int-combo-box-new"><function>gimp_int_combo_box_new()</function></link> that takes a va_list of
128
164
label/value pairs. Probably only useful for language bindings.</para>
141
177
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a new <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>.
142
178
 
143
179
</simpara></listitem></varlistentry>
144
 
</variablelist><para>Since  GIMP 2.2
 
180
</variablelist><para role="since">Since  GIMP 2.2
145
181
</para></refsect2>
146
182
<refsect2>
147
183
<title><anchor id="gimp-int-combo-box-new-array" role="function" condition="since:GIMP 2.2"/>gimp_int_combo_box_new_array ()</title>
148
 
<indexterm 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,
149
 
                                             const <link linkend="gchar">gchar</link> *labels[]);</programlisting>
 
184
<indexterm 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,
 
185
                                                         const <link linkend="gchar">gchar</link> *labels[]);</programlisting>
150
186
<para>
151
187
A variant of <link linkend="gimp-int-combo-box-new"><function>gimp_int_combo_box_new()</function></link> that takes an array of labels.
152
188
The array indices are used as values.</para>
162
198
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a new <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>.
163
199
 
164
200
</simpara></listitem></varlistentry>
165
 
</variablelist><para>Since  GIMP 2.2
 
201
</variablelist><para role="since">Since  GIMP 2.2
166
202
</para></refsect2>
167
203
<refsect2>
168
204
<title><anchor id="gimp-int-combo-box-prepend" role="function" condition="since:GIMP 2.2"/>gimp_int_combo_box_prepend ()</title>
169
 
<indexterm 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,
170
 
                                             ...);</programlisting>
 
205
<indexterm 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,
 
206
                                                         ...);</programlisting>
171
207
<para>
172
208
This function provides a convenient way to prepend items to a
173
209
<link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>. It prepends a row to the <parameter>combo_box</parameter>'s list store
184
220
<varlistentry><term><parameter>...</parameter>&nbsp;:</term>
185
221
<listitem><simpara>       pairs of column number and value, terminated with -1
186
222
</simpara></listitem></varlistentry>
187
 
</variablelist><para>Since  GIMP 2.2
 
223
</variablelist><para role="since">Since  GIMP 2.2
188
224
</para></refsect2>
189
225
<refsect2>
190
226
<title><anchor id="gimp-int-combo-box-append" role="function" condition="since:GIMP 2.2"/>gimp_int_combo_box_append ()</title>
191
 
<indexterm 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,
192
 
                                             ...);</programlisting>
 
227
<indexterm 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,
 
228
                                                         ...);</programlisting>
193
229
<para>
194
230
This function provides a convenient way to append items to a
195
231
<link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>. It appends a row to the <parameter>combo_box</parameter>'s list store
206
242
<varlistentry><term><parameter>...</parameter>&nbsp;:</term>
207
243
<listitem><simpara>       pairs of column number and value, terminated with -1
208
244
</simpara></listitem></varlistentry>
209
 
</variablelist><para>Since  GIMP 2.2
 
245
</variablelist><para role="since">Since  GIMP 2.2
210
246
</para></refsect2>
211
247
<refsect2>
212
248
<title><anchor id="gimp-int-combo-box-set-active" role="function" condition="since:GIMP 2.2"/>gimp_int_combo_box_set_active ()</title>
213
 
<indexterm 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,
214
 
                                             <link linkend="gint">gint</link> value);</programlisting>
 
249
<indexterm 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,
 
250
                                                         <link linkend="gint">gint</link> value);</programlisting>
215
251
<para>
216
252
Looks up the item that belongs to the given <parameter>value</parameter> and makes it the
217
253
selected item in the <parameter>combo_box</parameter>.</para>
228
264
              this value.
229
265
 
230
266
</simpara></listitem></varlistentry>
231
 
</variablelist><para>Since  GIMP 2.2
 
267
</variablelist><para role="since">Since  GIMP 2.2
232
268
</para></refsect2>
233
269
<refsect2>
234
270
<title><anchor id="gimp-int-combo-box-get-active" role="function" condition="since:GIMP 2.2"/>gimp_int_combo_box_get_active ()</title>
235
 
<indexterm 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,
236
 
                                             <link linkend="gint">gint</link> *value);</programlisting>
 
271
<indexterm 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,
 
272
                                                         <link linkend="gint">gint</link> *value);</programlisting>
237
273
<para>
238
274
Retrieves the value of the selected (active) item in the <parameter>combo_box</parameter>.</para>
239
275
<para>
249
285
              active.
250
286
 
251
287
</simpara></listitem></varlistentry>
252
 
</variablelist><para>Since  GIMP 2.2
 
288
</variablelist><para role="since">Since  GIMP 2.2
253
289
</para></refsect2>
254
290
<refsect2>
255
291
<title><anchor id="gimp-int-combo-box-connect" role="function" condition="since:GIMP 2.2"/>gimp_int_combo_box_connect ()</title>
256
 
<indexterm 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,
257
 
                                             <link linkend="gint">gint</link> value,
258
 
                                             <link linkend="GCallback">GCallback</link> callback,
259
 
                                             <link linkend="gpointer">gpointer</link> data);</programlisting>
 
292
<indexterm 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,
 
293
                                                         <link linkend="gint">gint</link> value,
 
294
                                                         <link linkend="GCallback">GCallback</link> callback,
 
295
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
260
296
<para>
261
297
A convenience function that sets the inital <parameter>value</parameter> of a
262
298
<link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link> and connects <parameter>callback</parameter> to the "changed"
265
301
<para>
266
302
This function also calls the <parameter>callback</parameter> once after setting the
267
303
initial <parameter>value</parameter>. This is often convenient when working with combo
268
 
boxes that select a default active item (like for example
269
 
gimp_drawable_combo_box_new). If you pass an invalid initial
 
304
boxes that select a default active item, like for example
 
305
<link linkend="gimp-drawable-combo-box-new"><function>gimp_drawable_combo_box_new()</function></link>. If you pass an invalid initial
270
306
<parameter>value</parameter>, the <parameter>callback</parameter> will be called with the default item active.</para>
271
307
<para>
272
308
 
286
322
<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>
287
323
 
288
324
</simpara></listitem></varlistentry>
289
 
</variablelist><para>Since  GIMP 2.2
290
 
</para></refsect2>
 
325
</variablelist><para role="since">Since  GIMP 2.2
 
326
</para></refsect2>
 
327
<refsect2>
 
328
<title><anchor id="gimp-int-combo-box-set-sensitivity" role="function" condition="since:GIMP 2.4"/>gimp_int_combo_box_set_sensitivity ()</title>
 
329
<indexterm 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,
 
330
                                                         <link linkend="GimpIntSensitivityFunc">GimpIntSensitivityFunc</link> func,
 
331
                                                         <link linkend="gpointer">gpointer</link> data,
 
332
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);</programlisting>
 
333
<para>
 
334
Sets a function that is used to decide about the sensitivity of
 
335
rows in the <parameter>combo_box</parameter>. Use this if you want to set certain rows
 
336
insensitive.
 
337
</para>
 
338
<para>
 
339
Calling <link linkend="gtk-widget-queue-draw"><function>gtk_widget_queue_draw()</function></link> on the <parameter>combo_box</parameter> will cause the
 
340
sensitivity to be updated.</para>
 
341
<para>
 
342
 
 
343
</para><variablelist role="params">
 
344
<varlistentry><term><parameter>combo_box</parameter>&nbsp;:</term>
 
345
<listitem><simpara> a <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link>
 
346
</simpara></listitem></varlistentry>
 
347
<varlistentry><term><parameter>func</parameter>&nbsp;:</term>
 
348
<listitem><simpara> a function that returns a boolean value, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to unset
 
349
</simpara></listitem></varlistentry>
 
350
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
 
351
<listitem><simpara> data to pass to <parameter>func</parameter>
 
352
</simpara></listitem></varlistentry>
 
353
<varlistentry><term><parameter>destroy</parameter>&nbsp;:</term>
 
354
<listitem><simpara> destroy notification for <parameter>data</parameter>
 
355
</simpara></listitem></varlistentry>
 
356
</variablelist><para role="since">Since  GIMP 2.4
 
357
</para></refsect2>
 
358
 
 
359
</refsect1>
 
360
<refsect1 role="property_details">
 
361
<title role="property_details.title">Property Details</title>
 
362
<refsect2><title><anchor id="GimpIntComboBox--ellipsize"/>The &quot;<literal>ellipsize</literal>&quot; property</title>
 
363
<indexterm role="GIMP 2.4"><primary>GimpIntComboBox:ellipsize</primary></indexterm><programlisting>  &quot;ellipsize&quot;                <link linkend="PangoEllipsizeMode">PangoEllipsizeMode</link>    : Read / Write</programlisting>
 
364
<para>
 
365
Specifies the preferred place to ellipsize text in the combo-box,
 
366
if the cell renderer does not have enough room to display the
 
367
entire string.</para>
 
368
<para>
 
369
 
 
370
</para><para>Default value: PANGO_ELLIPSIZE_NONE</para>
 
371
<para>Since  GIMP 2.4
 
372
</para>
 
373
</refsect2>
291
374
 
292
375
</refsect1>
293
376