57
57
<a name="GimpStringComboBox.synopsis"></a><h2>Synopsis</h2>
58
58
<pre class="synopsis">
59
59
<a class="link" href="GimpStringComboBox.html#GimpStringComboBox-struct" title="GimpStringComboBox">GimpStringComboBox</a>;
60
GtkWidget* <a class="link" href="GimpStringComboBox.html#gimp-string-combo-box-new" title="gimp_string_combo_box_new ()">gimp_string_combo_box_new</a> (GtkTreeModel *model,
63
gboolean <a class="link" href="GimpStringComboBox.html#gimp-string-combo-box-set-active" title="gimp_string_combo_box_set_active ()">gimp_string_combo_box_set_active</a> (<a class="link" href="GimpStringComboBox.html" title="GimpStringComboBox">GimpStringComboBox</a> *combo_box,
65
gchar* <a class="link" href="GimpStringComboBox.html#gimp-string-combo-box-get-active" title="gimp_string_combo_box_get_active ()">gimp_string_combo_box_get_active</a> (<a class="link" href="GimpStringComboBox.html" title="GimpStringComboBox">GimpStringComboBox</a> *combo_box);
61
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
62
>GtkWidget</a>* <a class="link" href="GimpStringComboBox.html#gimp-string-combo-box-new" title="gimp_string_combo_box_new ()">gimp_string_combo_box_new</a> (<a
63
href="/usr/share/gtk-doc/html/gtk/GtkTreeModel.html"
64
>GtkTreeModel</a> *model,
66
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
69
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
70
>gint</a> label_column);
72
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
73
>gboolean</a> <a class="link" href="GimpStringComboBox.html#gimp-string-combo-box-set-active" title="gimp_string_combo_box_set_active ()">gimp_string_combo_box_set_active</a> (<a class="link" href="GimpStringComboBox.html" title="GimpStringComboBox">GimpStringComboBox</a> *combo_box,
75
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
78
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
79
>gchar</a>* <a class="link" href="GimpStringComboBox.html#gimp-string-combo-box-get-active" title="gimp_string_combo_box_get_active ()">gimp_string_combo_box_get_active</a> (<a class="link" href="GimpStringComboBox.html" title="GimpStringComboBox">GimpStringComboBox</a> *combo_box);
68
82
<div class="refsect1" lang="en">
69
83
<a name="GimpStringComboBox.object-hierarchy"></a><h2>Object Hierarchy</h2>
70
84
<pre class="synopsis">
72
+----GInitiallyUnowned
86
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
89
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
90
>GInitiallyUnowned</a>
92
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
95
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
98
href="/usr/share/gtk-doc/html/gtk/GtkContainer.html"
101
href="/usr/share/gtk-doc/html/gtk/GtkBin.html"
104
href="/usr/share/gtk-doc/html/gtk/GtkComboBox.html"
78
106
+----GimpStringComboBox
82
110
<a name="GimpStringComboBox.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
84
112
GimpStringComboBox implements
85
AtkImplementorIface, GtkBuildable, GtkCellEditable and GtkCellLayout.</p>
113
AtkImplementorIface, <a
114
href="/usr/share/gtk-doc/html/gtk/gtk-gtkbuildable.html#GtkBuildable"
115
>GtkBuildable</a>, <a
116
href="/usr/share/gtk-doc/html/gtk/GtkCellEditable.html"
117
>GtkCellEditable</a> and <a
118
href="/usr/share/gtk-doc/html/gtk/GtkCellLayout.html"
119
>GtkCellLayout</a>.</p>
87
121
<div class="refsect1" lang="en">
88
122
<a name="GimpStringComboBox.properties"></a><h2>Properties</h2>
89
123
<pre class="synopsis">
90
"<a class="link" href="GimpStringComboBox.html#GimpStringComboBox--ellipsize" title='The "ellipsize" property'>ellipsize</a>" PangoEllipsizeMode : Read / Write
91
"<a class="link" href="GimpStringComboBox.html#GimpStringComboBox--id-column" title='The "id-column" property'>id-column</a>" gint : Read / Write / Construct Only
92
"<a class="link" href="GimpStringComboBox.html#GimpStringComboBox--label-column" title='The "label-column" property'>label-column</a>" gint : Read / Write / Construct Only
124
"<a class="link" href="GimpStringComboBox.html#GimpStringComboBox--ellipsize" title='The "ellipsize" property'>ellipsize</a>" <a
125
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"
126
>PangoEllipsizeMode</a> : Read / Write
127
"<a class="link" href="GimpStringComboBox.html#GimpStringComboBox--id-column" title='The "id-column" property'>id-column</a>" <a
128
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
129
>gint</a> : Read / Write / Construct Only
130
"<a class="link" href="GimpStringComboBox.html#GimpStringComboBox--label-column" title='The "label-column" property'>label-column</a>" <a
131
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
132
>gint</a> : Read / Write / Construct Only
95
135
<div class="refsect1" lang="en">
111
151
<div class="refsect2" lang="en">
112
152
<a name="gimp-string-combo-box-new"></a><h3>gimp_string_combo_box_new ()</h3>
113
<pre class="programlisting">GtkWidget* gimp_string_combo_box_new (GtkTreeModel *model,
115
gint label_column);</pre>
153
<pre class="programlisting"><a
154
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
155
>GtkWidget</a>* gimp_string_combo_box_new (<a
156
href="/usr/share/gtk-doc/html/gtk/GtkTreeModel.html"
157
>GtkTreeModel</a> *model,
159
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
162
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
163
>gint</a> label_column);</pre>
151
199
<div class="refsect2" lang="en">
152
200
<a name="gimp-string-combo-box-set-active"></a><h3>gimp_string_combo_box_set_active ()</h3>
153
<pre class="programlisting">gboolean gimp_string_combo_box_set_active (<a class="link" href="GimpStringComboBox.html" title="GimpStringComboBox">GimpStringComboBox</a> *combo_box,
154
const gchar *id);</pre>
201
<pre class="programlisting"><a
202
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
203
>gboolean</a> gimp_string_combo_box_set_active (<a class="link" href="GimpStringComboBox.html" title="GimpStringComboBox">GimpStringComboBox</a> *combo_box,
205
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
206
>gchar</a> *id);</pre>
156
208
Looks up the item that belongs to the given <em class="parameter"><code>id</code></em> and makes it the
157
209
selected item in the <em class="parameter"><code>combo_box</code></em>.</p>
175
227
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
176
<td> <code class="literal">TRUE</code> on success or <code class="literal">FALSE</code> if there was no item for
229
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
230
><code class="literal">TRUE</code></a> on success or <a
231
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
232
><code class="literal">FALSE</code></a> if there was no item for
187
243
<div class="refsect2" lang="en">
188
244
<a name="gimp-string-combo-box-get-active"></a><h3>gimp_string_combo_box_get_active ()</h3>
189
<pre class="programlisting">gchar* gimp_string_combo_box_get_active (<a class="link" href="GimpStringComboBox.html" title="GimpStringComboBox">GimpStringComboBox</a> *combo_box);</pre>
245
<pre class="programlisting"><a
246
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
247
>gchar</a>* gimp_string_combo_box_get_active (<a class="link" href="GimpStringComboBox.html" title="GimpStringComboBox">GimpStringComboBox</a> *combo_box);</pre>
191
249
Retrieves the value of the selected (active) item in the <em class="parameter"><code>combo_box</code></em>.</p>
204
262
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
205
<td> newly allocated ID string or <code class="literal">NULL</code> if nothing was selected
263
<td> newly allocated ID string or <a
264
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
265
><code class="literal">NULL</code></a> if nothing was selected
216
276
<a name="GimpStringComboBox.property-details"></a><h2>Property Details</h2>
217
277
<div class="refsect2" lang="en">
218
278
<a name="GimpStringComboBox--ellipsize"></a><h3>The <code class="literal">"ellipsize"</code> property</h3>
219
<pre class="programlisting"> "ellipsize" PangoEllipsizeMode : Read / Write</pre>
279
<pre class="programlisting"> "ellipsize" <a
280
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"
281
>PangoEllipsizeMode</a> : Read / Write</pre>
221
283
Specifies the preferred place to ellipsize text in the combo-box,
222
284
if the cell renderer does not have enough room to display the
232
294
<div class="refsect2" lang="en">
233
295
<a name="GimpStringComboBox--id-column"></a><h3>The <code class="literal">"id-column"</code> property</h3>
234
<pre class="programlisting"> "id-column" gint : Read / Write / Construct Only</pre>
296
<pre class="programlisting"> "id-column" <a
297
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
298
>gint</a> : Read / Write / Construct Only</pre>
236
300
The column in the associated GtkTreeModel that holds strings to
237
301
be used as labels in the combo-box.</p>
247
311
<div class="refsect2" lang="en">
248
312
<a name="GimpStringComboBox--label-column"></a><h3>The <code class="literal">"label-column"</code> property</h3>
249
<pre class="programlisting"> "label-column" gint : Read / Write / Construct Only</pre>
313
<pre class="programlisting"> "label-column" <a
314
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
315
>gint</a> : Read / Write / Construct Only</pre>
251
317
<p>Allowed values: >= 0</p>
252
318
<p>Default value: 0</p>