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

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Pedro Fragoso
  • Date: 2008-08-22 11:50:05 UTC
  • mfrom: (0.1.1 upstream)
  • mto: This revision was merged to the branch mainline in revision 34.
  • Revision ID: james.westby@ubuntu.com-20080822115005-yxj5svf3v9x1mkr7
Tags: upstream-2.4.7
Import upstream version 2.4.7

Show diffs side-by-side

added added

removed removed

Lines of Context:
56
56
<a name="GimpColorProfileComboBox.synopsis"></a><h2>Synopsis</h2>
57
57
<pre class="synopsis">
58
58
                    <a class="link" href="GimpColorProfileComboBox.html#GimpColorProfileComboBox-struct" title="GimpColorProfileComboBox">GimpColorProfileComboBox</a>;
59
 
<a
60
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
61
 
>GtkWidget</a>*          <a class="link" href="GimpColorProfileComboBox.html#gimp-color-profile-combo-box-new" title="gimp_color_profile_combo_box_new ()">gimp_color_profile_combo_box_new</a>    (<a
62
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
63
 
>GtkWidget</a> *dialog,
64
 
                                                         const <a
65
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
66
 
>gchar</a> *history);
67
 
<a
68
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
69
 
>GtkWidget</a>*          <a class="link" href="GimpColorProfileComboBox.html#gimp-color-profile-combo-box-new-with-model" title="gimp_color_profile_combo_box_new_with_model ()">gimp_color_profile_combo_box_new_with_model</a>
70
 
                                                        (<a
71
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
72
 
>GtkWidget</a> *dialog,
73
 
                                                         <a
74
 
href="/usr/share/gtk-doc/html/gtk/GtkTreeModel.html"
75
 
>GtkTreeModel</a> *model);
 
59
GtkWidget*          <a class="link" href="GimpColorProfileComboBox.html#gimp-color-profile-combo-box-new" title="gimp_color_profile_combo_box_new ()">gimp_color_profile_combo_box_new</a>    (GtkWidget *dialog,
 
60
                                                         const gchar *history);
 
61
GtkWidget*          <a class="link" href="GimpColorProfileComboBox.html#gimp-color-profile-combo-box-new-with-model" title="gimp_color_profile_combo_box_new_with_model ()">gimp_color_profile_combo_box_new_with_model</a>
 
62
                                                        (GtkWidget *dialog,
 
63
                                                         GtkTreeModel *model);
76
64
void                <a class="link" href="GimpColorProfileComboBox.html#gimp-color-profile-combo-box-add" title="gimp_color_profile_combo_box_add ()">gimp_color_profile_combo_box_add</a>    (<a class="link" href="GimpColorProfileComboBox.html" title="GimpColorProfileComboBox">GimpColorProfileComboBox</a> *combo,
77
 
                                                         const <a
78
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
79
 
>gchar</a> *filename,
80
 
                                                         const <a
81
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
82
 
>gchar</a> *label);
 
65
                                                         const gchar *filename,
 
66
                                                         const gchar *label);
83
67
void                <a class="link" href="GimpColorProfileComboBox.html#gimp-color-profile-combo-box-set-active" title="gimp_color_profile_combo_box_set_active ()">gimp_color_profile_combo_box_set_active</a>
84
68
                                                        (<a class="link" href="GimpColorProfileComboBox.html" title="GimpColorProfileComboBox">GimpColorProfileComboBox</a> *combo,
85
 
                                                         const <a
86
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
87
 
>gchar</a> *filename,
88
 
                                                         const <a
89
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
90
 
>gchar</a> *label);
91
 
<a
92
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
93
 
>gchar</a>*              <a class="link" href="GimpColorProfileComboBox.html#gimp-color-profile-combo-box-get-active" title="gimp_color_profile_combo_box_get_active ()">gimp_color_profile_combo_box_get_active</a>
 
69
                                                         const gchar *filename,
 
70
                                                         const gchar *label);
 
71
gchar*              <a class="link" href="GimpColorProfileComboBox.html#gimp-color-profile-combo-box-get-active" title="gimp_color_profile_combo_box_get_active ()">gimp_color_profile_combo_box_get_active</a>
94
72
                                                        (<a class="link" href="GimpColorProfileComboBox.html" title="GimpColorProfileComboBox">GimpColorProfileComboBox</a> *combo);
95
73
</pre>
96
74
</div>
97
75
<div class="refsect1" lang="en">
98
76
<a name="GimpColorProfileComboBox.object-hierarchy"></a><h2>Object Hierarchy</h2>
99
77
<pre class="synopsis">
100
 
  <a
101
 
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
102
 
>GObject</a>
103
 
   +----<a
104
 
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
105
 
>GInitiallyUnowned</a>
106
 
         +----<a
107
 
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
108
 
>GtkObject</a>
109
 
               +----<a
110
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
111
 
>GtkWidget</a>
112
 
                     +----<a
113
 
href="/usr/share/gtk-doc/html/gtk/GtkContainer.html"
114
 
>GtkContainer</a>
115
 
                           +----<a
116
 
href="/usr/share/gtk-doc/html/gtk/GtkBin.html"
117
 
>GtkBin</a>
118
 
                                 +----<a
119
 
href="/usr/share/gtk-doc/html/gtk/GtkComboBox.html"
120
 
>GtkComboBox</a>
 
78
  GObject
 
79
   +----GInitiallyUnowned
 
80
         +----GtkObject
 
81
               +----GtkWidget
 
82
                     +----GtkContainer
 
83
                           +----GtkBin
 
84
                                 +----GtkComboBox
121
85
                                       +----GimpColorProfileComboBox
122
86
</pre>
123
87
</div>
125
89
<a name="GimpColorProfileComboBox.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
126
90
<p>
127
91
GimpColorProfileComboBox implements
128
 
 AtkImplementorIface,  GtkBuildable,  <a
129
 
href="/usr/share/gtk-doc/html/gtk/GtkCellEditable.html"
130
 
>GtkCellEditable</a> and  <a
131
 
href="/usr/share/gtk-doc/html/gtk/GtkCellLayout.html"
132
 
>GtkCellLayout</a>.</p>
 
92
 AtkImplementorIface,  GtkBuildable,  GtkCellEditable and  GtkCellLayout.</p>
133
93
</div>
134
94
<div class="refsect1" lang="en">
135
95
<a name="GimpColorProfileComboBox.properties"></a><h2>Properties</h2>
136
96
<pre class="synopsis">
137
 
  "<a class="link" href="GimpColorProfileComboBox.html#GimpColorProfileComboBox--dialog" title='The "dialog" property'>dialog</a>"                   <a
138
 
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html"
139
 
>GtkDialog</a>*            : Read / Write / Construct Only
 
97
  "<a class="link" href="GimpColorProfileComboBox.html#GimpColorProfileComboBox--dialog" title='The "dialog" property'>dialog</a>"                   GtkDialog*            : Read / Write / Construct Only
140
98
  "<a class="link" href="GimpColorProfileComboBox.html#GimpColorProfileComboBox--model" title='The "model" property'>model</a>"                    <a class="link" href="GimpColorProfileStore.html" title="GimpColorProfileStore">GimpColorProfileStore</a>*  : Read / Write
141
99
</pre>
142
100
</div>
158
116
<hr>
159
117
<div class="refsect2" lang="en">
160
118
<a name="gimp-color-profile-combo-box-new"></a><h3>gimp_color_profile_combo_box_new ()</h3>
161
 
<pre class="programlisting"><a
162
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
163
 
>GtkWidget</a>*          gimp_color_profile_combo_box_new    (<a
164
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
165
 
>GtkWidget</a> *dialog,
166
 
                                                         const <a
167
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
168
 
>gchar</a> *history);</pre>
 
119
<pre class="programlisting">GtkWidget*          gimp_color_profile_combo_box_new    (GtkWidget *dialog,
 
120
                                                         const gchar *history);</pre>
169
121
<p>
170
122
Create a combo-box widget for selecting color profiles. The combo-box
171
123
is populated from the file specified as <em class="parameter"><code>history</code></em>. This filename is
182
134
<tbody>
183
135
<tr>
184
136
<td><p><span class="term"><em class="parameter"><code>dialog</code></em> :</span></p></td>
185
 
<td>  a <a
186
 
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html"
187
 
><span class="type">GtkDialog</span></a> to present when the user selects the
 
137
<td>  a <span class="type">GtkDialog</span> to present when the user selects the
188
138
          "Select color profile from disk..." item
189
139
</td>
190
140
</tr>
191
141
<tr>
192
142
<td><p><span class="term"><em class="parameter"><code>history</code></em> :</span></p></td>
193
 
<td> filename of the profilerc (or <a
194
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
195
 
><code class="literal">NULL</code></a> for no history)
 
143
<td> filename of the profilerc (or <code class="literal">NULL</code> for no history)
196
144
</td>
197
145
</tr>
198
146
<tr>
209
157
<hr>
210
158
<div class="refsect2" lang="en">
211
159
<a name="gimp-color-profile-combo-box-new-with-model"></a><h3>gimp_color_profile_combo_box_new_with_model ()</h3>
212
 
<pre class="programlisting"><a
213
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
214
 
>GtkWidget</a>*          gimp_color_profile_combo_box_new_with_model
215
 
                                                        (<a
216
 
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
217
 
>GtkWidget</a> *dialog,
218
 
                                                         <a
219
 
href="/usr/share/gtk-doc/html/gtk/GtkTreeModel.html"
220
 
>GtkTreeModel</a> *model);</pre>
 
160
<pre class="programlisting">GtkWidget*          gimp_color_profile_combo_box_new_with_model
 
161
                                                        (GtkWidget *dialog,
 
162
                                                         GtkTreeModel *model);</pre>
221
163
<p>
222
164
This constructor is useful when you want to create several
223
165
combo-boxes for profile selection that all share the same
234
176
<tbody>
235
177
<tr>
236
178
<td><p><span class="term"><em class="parameter"><code>dialog</code></em> :</span></p></td>
237
 
<td> a <a
238
 
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html"
239
 
><span class="type">GtkDialog</span></a> to present when the user selects the
 
179
<td> a <span class="type">GtkDialog</span> to present when the user selects the
240
180
         "Select color profile from disk..." item
241
181
</td>
242
182
</tr>
260
200
<div class="refsect2" lang="en">
261
201
<a name="gimp-color-profile-combo-box-add"></a><h3>gimp_color_profile_combo_box_add ()</h3>
262
202
<pre class="programlisting">void                gimp_color_profile_combo_box_add    (<a class="link" href="GimpColorProfileComboBox.html" title="GimpColorProfileComboBox">GimpColorProfileComboBox</a> *combo,
263
 
                                                         const <a
264
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
265
 
>gchar</a> *filename,
266
 
                                                         const <a
267
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
268
 
>gchar</a> *label);</pre>
 
203
                                                         const gchar *filename,
 
204
                                                         const gchar *label);</pre>
269
205
<p>
270
206
This function delegates to the underlying
271
207
<a class="link" href="GimpColorProfileStore.html" title="GimpColorProfileStore"><span class="type">GimpColorProfileStore</span></a>. Please refer to the documentation of
283
219
</tr>
284
220
<tr>
285
221
<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
286
 
<td> filename of the profile to add (or <a
287
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
288
 
><code class="literal">NULL</code></a>)
 
222
<td> filename of the profile to add (or <code class="literal">NULL</code>)
289
223
</td>
290
224
</tr>
291
225
<tr>
292
226
<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
293
227
<td>    label to use for the profile
294
 
           (may only be <a
295
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
296
 
><code class="literal">NULL</code></a> if <em class="parameter"><code>filename</code></em> is <a
297
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
298
 
><code class="literal">NULL</code></a>)
 
228
           (may only be <code class="literal">NULL</code> if <em class="parameter"><code>filename</code></em> is <code class="literal">NULL</code>)
299
229
</td>
300
230
</tr>
301
231
</tbody>
308
238
<a name="gimp-color-profile-combo-box-set-active"></a><h3>gimp_color_profile_combo_box_set_active ()</h3>
309
239
<pre class="programlisting">void                gimp_color_profile_combo_box_set_active
310
240
                                                        (<a class="link" href="GimpColorProfileComboBox.html" title="GimpColorProfileComboBox">GimpColorProfileComboBox</a> *combo,
311
 
                                                         const <a
312
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
313
 
>gchar</a> *filename,
314
 
                                                         const <a
315
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
316
 
>gchar</a> *label);</pre>
 
241
                                                         const gchar *filename,
 
242
                                                         const gchar *label);</pre>
317
243
<p>
318
244
Selects a color profile from the <em class="parameter"><code>combo</code></em> and makes it the active
319
245
item.  If the profile is not listed in the <em class="parameter"><code>combo</code></em>, then it is added
320
 
with the given <em class="parameter"><code>label</code></em> (or <em class="parameter"><code>filename</code></em> in case that <em class="parameter"><code>label</code></em> is <a
321
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
322
 
><code class="literal">NULL</code></a>).</p>
 
246
with the given <em class="parameter"><code>label</code></em> (or <em class="parameter"><code>filename</code></em> in case that <em class="parameter"><code>label</code></em> is <code class="literal">NULL</code>).</p>
323
247
<p>
324
248
 
325
249
</p>
338
262
</tr>
339
263
<tr>
340
264
<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
341
 
<td>    label to use when adding a new entry (can be <a
342
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
343
 
><code class="literal">NULL</code></a>)
 
265
<td>    label to use when adding a new entry (can be <code class="literal">NULL</code>)
344
266
</td>
345
267
</tr>
346
268
</tbody>
351
273
<hr>
352
274
<div class="refsect2" lang="en">
353
275
<a name="gimp-color-profile-combo-box-get-active"></a><h3>gimp_color_profile_combo_box_get_active ()</h3>
354
 
<pre class="programlisting"><a
355
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
356
 
>gchar</a>*              gimp_color_profile_combo_box_get_active
 
276
<pre class="programlisting">gchar*              gimp_color_profile_combo_box_get_active
357
277
                                                        (<a class="link" href="GimpColorProfileComboBox.html" title="GimpColorProfileComboBox">GimpColorProfileComboBox</a> *combo);</pre>
358
278
<p>
359
279
</p>
372
292
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
373
293
<td> The filename of the currently selected color profile.
374
294
              This is a newly allocated string and should be released
375
 
              using <a
376
 
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
377
 
><code class="function">g_free()</code></a> when it is not any longer needed.
 
295
              using <code class="function">g_free()</code> when it is not any longer needed.
378
296
 
379
297
</td>
380
298
</tr>
388
306
<a name="GimpColorProfileComboBox.property-details"></a><h2>Property Details</h2>
389
307
<div class="refsect2" lang="en">
390
308
<a name="GimpColorProfileComboBox--dialog"></a><h3>The <code class="literal">"dialog"</code> property</h3>
391
 
<pre class="programlisting">  "dialog"                   <a
392
 
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html"
393
 
>GtkDialog</a>*            : Read / Write / Construct Only</pre>
 
309
<pre class="programlisting">  "dialog"                   GtkDialog*            : Read / Write / Construct Only</pre>
394
310
<p>
395
 
<a
396
 
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html"
397
 
><span class="type">GtkDialog</span></a> to present when the user selects the
 
311
<span class="type">GtkDialog</span> to present when the user selects the
398
312
"Select color profile from disk..." item.</p>
399
313
<p>
400
314
 
407
321
<a name="GimpColorProfileComboBox--model"></a><h3>The <code class="literal">"model"</code> property</h3>
408
322
<pre class="programlisting">  "model"                    <a class="link" href="GimpColorProfileStore.html" title="GimpColorProfileStore">GimpColorProfileStore</a>*  : Read / Write</pre>
409
323
<p>
410
 
Overrides the "model" property of the <a
411
 
href="/usr/share/gtk-doc/html/gtk/GtkComboBox.html"
412
 
><span class="type">GtkComboBox</span></a> class.
 
324
Overrides the "model" property of the <span class="type">GtkComboBox</span> class.
413
325
<a class="link" href="GimpColorProfileComboBox.html" title="GimpColorProfileComboBox"><span class="type">GimpColorProfileComboBox</span></a> requires the model to be a
414
326
<a class="link" href="GimpColorProfileStore.html" title="GimpColorProfileStore"><span class="type">GimpColorProfileStore</span></a>.</p>
415
327
<p>