~ubuntu-branches/debian/jessie/glib2.0/jessie

« back to all changes in this revision

Viewing changes to docs/reference/gio/html/GThemedIcon.html

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2014-09-23 10:12:15 UTC
  • mfrom: (1.66.20)
  • Revision ID: package-import@ubuntu.com-20140923101215-3vlqvooralbmzq8t
Tags: 2.42.0-1
New upstream release

Show diffs side-by-side

added added

removed removed

Lines of Context:
83
83
</td>
84
84
</tr>
85
85
<tr>
86
 
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
 
86
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
87
87
</td>
88
88
<td class="function_name">
89
89
<a class="link" href="GThemedIcon.html#g-themed-icon-get-names" title="g_themed_icon_get_names ()">g_themed_icon_get_names</a> <span class="c_punctuation">()</span>
103
103
<tbody>
104
104
<tr>
105
105
<td class="property_type">
106
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
 
106
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
107
107
<td class="property_name"><a class="link" href="GThemedIcon.html#GThemedIcon--name" title="The “name” property">name</a></td>
108
108
<td class="property_flags">Write / Construct Only</td>
109
109
</tr>
110
110
<tr>
111
 
<td class="property_type"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a></td>
 
111
<td class="property_type"><a href="../gobject/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a></td>
112
112
<td class="property_name"><a class="link" href="GThemedIcon.html#GThemedIcon--names" title="The “names” property">names</a></td>
113
113
<td class="property_flags">Read / Write / Construct Only</td>
114
114
</tr>
115
115
<tr>
116
 
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
 
116
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
117
117
<td class="property_name"><a class="link" href="GThemedIcon.html#GThemedIcon--use-default-fallbacks" title="The “use-default-fallbacks” property">use-default-fallbacks</a></td>
118
118
<td class="property_flags">Read / Write / Construct Only</td>
119
119
</tr>
135
135
</div>
136
136
<div class="refsect1">
137
137
<a name="GThemedIcon.object-hierarchy"></a><h2>Object Hierarchy</h2>
138
 
<pre class="screen">    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
138
<pre class="screen">    <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
139
139
    <span class="lineart">╰──</span> GThemedIcon
140
140
</pre>
141
141
</div>
156
156
<a class="link" href="GThemedIcon.html" title="GThemedIcon"><span class="type">GThemedIcon</span></a> contains a list of all of the icons present in an icon
157
157
theme, so that icons can be looked up quickly. <a class="link" href="GThemedIcon.html" title="GThemedIcon"><span class="type">GThemedIcon</span></a> does
158
158
not provide actual pixmaps for icons, just the icon names.
159
 
Ideally something like <a href="http://developer.gnome.org/gtk2/GtkIconTheme.html#gtk-icon-theme-choose-icon"><code class="function">gtk_icon_theme_choose_icon()</code></a> should be used to
 
159
Ideally something like <code class="function">gtk_icon_theme_choose_icon()</code> should be used to
160
160
resolve the list of names so that fallback icons work nicely with
161
161
themes that inherit other themes.</p>
162
162
</div>
216
216
<td class="parameter_description"><p>the length of the <em class="parameter"><code>iconnames</code></em>
217
217
array, or -1 if <em class="parameter"><code>iconnames</code></em>
218
218
is
219
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated</p></td>
 
219
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated</p></td>
220
220
<td class="parameter_annotations"> </td>
221
221
</tr>
222
222
</tbody>
254
254
7
255
255
8
256
256
9</pre></td>
257
 
        <td class="listing_code"><pre class="programlisting"><span class="keyword">const</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">names</span><span class="symbol">[]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span>
258
 
<span class="normal">  </span><span class="string">"gnome-dev-cdrom-audio"</span><span class="symbol">,</span>
259
 
<span class="normal">  </span><span class="string">"gnome-dev-cdrom"</span><span class="symbol">,</span>
260
 
<span class="normal">  </span><span class="string">"gnome-dev"</span><span class="symbol">,</span>
261
 
<span class="normal">  </span><span class="string">"gnome"</span>
262
 
<span class="cbracket">}</span><span class="symbol">;</span>
 
257
        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">const char</span> <span class="gtkdoc opt">*</span>names<span class="gtkdoc opt">[] = {</span> 
 
258
  <span class="string">&quot;gnome-dev-cdrom-audio&quot;</span><span class="gtkdoc opt">,</span>
 
259
  <span class="string">&quot;gnome-dev-cdrom&quot;</span><span class="gtkdoc opt">,</span>
 
260
  <span class="string">&quot;gnome-dev&quot;</span><span class="gtkdoc opt">,</span>
 
261
  <span class="string">&quot;gnome&quot;</span>
 
262
<span class="gtkdoc opt">};</span>
263
263
 
264
 
<span class="normal">icon1 </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GThemedIcon.html#g-themed-icon-new-from-names">g_themed_icon_new_from_names</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">names</span><span class="symbol">,</span><span class="normal"> </span><span class="number">4</span><span class="symbol">);</span>
265
 
<span class="normal">icon2 </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GThemedIcon.html#g-themed-icon-new-with-default-fallbacks">g_themed_icon_new_with_default_fallbacks</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"gnome-dev-cdrom-audio"</span><span class="symbol">);</span></pre></td>
 
264
icon1 <span class="gtkdoc opt">=</span> <span class="function"><a href="GThemedIcon.html#g-themed-icon-new-from-names">g_themed_icon_new_from_names</a></span> <span class="gtkdoc opt">(</span>names<span class="gtkdoc opt">,</span> <span class="number">4</span><span class="gtkdoc opt">);</span>
 
265
icon2 <span class="gtkdoc opt">=</span> <span class="function"><a href="GThemedIcon.html#g-themed-icon-new-with-default-fallbacks">g_themed_icon_new_with_default_fallbacks</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;gnome-dev-cdrom-audio&quot;</span><span class="gtkdoc opt">);</span></pre></td>
266
266
      </tr>
267
267
    </tbody>
268
268
  </table>
362
362
<hr>
363
363
<div class="refsect2">
364
364
<a name="g-themed-icon-get-names"></a><h3>g_themed_icon_get_names ()</h3>
365
 
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
 
365
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
366
366
g_themed_icon_get_names (<em class="parameter"><code><a class="link" href="GThemedIcon.html" title="GThemedIcon"><span class="type">GThemedIcon</span></a> *icon</code></em>);</pre>
367
367
<p>Gets the names of icons from within <em class="parameter"><code>icon</code></em>
368
368
.</p>
400
400
<a name="GThemedIcon.property-details"></a><h2>Property Details</h2>
401
401
<div class="refsect2">
402
402
<a name="GThemedIcon--name"></a><h3>The <code class="literal">“name”</code> property</h3>
403
 
<pre class="programlisting">  “name”                     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
 
403
<pre class="programlisting">  “name”                     <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
404
404
<p>The icon name.</p>
405
405
<p>Flags: Write / Construct Only</p>
406
406
<p>Default value: NULL</p>
408
408
<hr>
409
409
<div class="refsect2">
410
410
<a name="GThemedIcon--names"></a><h3>The <code class="literal">“names”</code> property</h3>
411
 
<pre class="programlisting">  “names”                    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a></pre>
412
 
<p>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of icon names.</p>
 
411
<pre class="programlisting">  “names”                    <a href="../gobject/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a></pre>
 
412
<p>A <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of icon names.</p>
413
413
<p>Flags: Read / Write / Construct Only</p>
414
414
</div>
415
415
<hr>
416
416
<div class="refsect2">
417
417
<a name="GThemedIcon--use-default-fallbacks"></a><h3>The <code class="literal">“use-default-fallbacks”</code> property</h3>
418
 
<pre class="programlisting">  “use-default-fallbacks”    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
 
418
<pre class="programlisting">  “use-default-fallbacks”    <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
419
419
<p>Whether to use the default fallbacks found by shortening the icon name
420
420
 
421
421
at '-' characters. If the "names" array has more than one element,
435
435
5
436
436
6
437
437
7</pre></td>
438
 
        <td class="listing_code"><pre class="programlisting"><span class="cbracket">{</span>
439
 
<span class="normal">  </span><span class="string">"gnome-dev-cdrom-audio"</span><span class="symbol">,</span>
440
 
<span class="normal">  </span><span class="string">"gnome-dev-cdrom"</span><span class="symbol">,</span>
441
 
<span class="normal">  </span><span class="string">"gnome-dev"</span><span class="symbol">,</span>
442
 
<span class="normal">  </span><span class="string">"gnome"</span><span class="symbol">,</span>
443
 
<span class="normal">  <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span>
444
 
<span class="cbracket">}</span><span class="symbol">;</span></pre></td>
 
438
        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc opt">{</span>
 
439
  <span class="string">&quot;gnome-dev-cdrom-audio&quot;</span><span class="gtkdoc opt">,</span>
 
440
  <span class="string">&quot;gnome-dev-cdrom&quot;</span><span class="gtkdoc opt">,</span>
 
441
  <span class="string">&quot;gnome-dev&quot;</span><span class="gtkdoc opt">,</span>
 
442
  <span class="string">&quot;gnome&quot;</span><span class="gtkdoc opt">,</span>
 
443
  NULL
 
444
<span class="gtkdoc opt">};</span></pre></td>
445
445
      </tr>
446
446
    </tbody>
447
447
  </table>