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

« back to all changes in this revision

Viewing changes to devel-docs/libgimpwidgets/html/GimpStringComboBox.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2008-10-10 00:13:42 UTC
  • mfrom: (1.1.16 upstream)
  • Revision ID: james.westby@ubuntu.com-20081010001342-uja9qine9uybggd9
Tags: 2.6.1-1ubuntu1
* Sync new bugfix version on debian (lp: #280345, #280848)
* debian/patches/02_help-message.patch,
  debian/patches/03_gimp.desktop.in.in.patch:
  - updated some strings for ubuntu
* debian/rules:
  - updated translation templates

Show diffs side-by-side

added added

removed removed

Lines of Context:
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,
61
 
                                                         gint id_column,
62
 
                                                         gint label_column);
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,
64
 
                                                         const gchar *id);
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);
 
60
<a
 
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,
 
65
                                                         <a
 
66
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
 
67
>gint</a> id_column,
 
68
                                                         <a
 
69
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
 
70
>gint</a> label_column);
 
71
<a
 
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,
 
74
                                                         const <a
 
75
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
 
76
>gchar</a> *id);
 
77
<a
 
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);
66
80
</pre>
67
81
</div>
68
82
<div class="refsect1" lang="en">
69
83
<a name="GimpStringComboBox.object-hierarchy"></a><h2>Object Hierarchy</h2>
70
84
<pre class="synopsis">
71
 
  GObject
72
 
   +----GInitiallyUnowned
73
 
         +----GtkObject
74
 
               +----GtkWidget
75
 
                     +----GtkContainer
76
 
                           +----GtkBin
77
 
                                 +----GtkComboBox
 
85
  <a
 
86
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
 
87
>GObject</a>
 
88
   +----<a
 
89
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
 
90
>GInitiallyUnowned</a>
 
91
         +----<a
 
92
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
 
93
>GtkObject</a>
 
94
               +----<a
 
95
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
 
96
>GtkWidget</a>
 
97
                     +----<a
 
98
href="/usr/share/gtk-doc/html/gtk/GtkContainer.html"
 
99
>GtkContainer</a>
 
100
                           +----<a
 
101
href="/usr/share/gtk-doc/html/gtk/GtkBin.html"
 
102
>GtkBin</a>
 
103
                                 +----<a
 
104
href="/usr/share/gtk-doc/html/gtk/GtkComboBox.html"
 
105
>GtkComboBox</a>
78
106
                                       +----GimpStringComboBox
79
107
</pre>
80
108
</div>
82
110
<a name="GimpStringComboBox.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
83
111
<p>
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>
86
120
</div>
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
93
133
</pre>
94
134
</div>
95
135
<div class="refsect1" lang="en">
110
150
<hr>
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,
114
 
                                                         gint id_column,
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,
 
158
                                                         <a
 
159
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
 
160
>gint</a> id_column,
 
161
                                                         <a
 
162
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
 
163
>gint</a> label_column);</pre>
116
164
<p>
117
165
</p>
118
166
<p>
150
198
<hr>
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,
 
204
                                                         const <a
 
205
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
 
206
>gchar</a> *id);</pre>
155
207
<p>
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>
173
225
</tr>
174
226
<tr>
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
 
228
<td> <a
 
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
177
233
              this value.
178
234
 
179
235
</td>
186
242
<hr>
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>
190
248
<p>
191
249
Retrieves the value of the selected (active) item in the <em class="parameter"><code>combo_box</code></em>.</p>
192
250
<p>
202
260
</tr>
203
261
<tr>
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
206
266
 
207
267
</td>
208
268
</tr>
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>
220
282
<p>
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
231
293
<hr>
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>
235
299
<p>
236
300
The column in the associated GtkTreeModel that holds strings to
237
301
be used as labels in the combo-box.</p>
246
310
<hr>
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>
250
316
<p></p>
251
317
<p>Allowed values: &gt;= 0</p>
252
318
<p>Default value: 0</p>