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 *
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>
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>
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>
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>
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
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>
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>
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>
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">"gnome-dev-cdrom-audio"</span><span class="gtkdoc opt">,</span>
259
<span class="string">"gnome-dev-cdrom"</span><span class="gtkdoc opt">,</span>
260
<span class="string">"gnome-dev"</span><span class="gtkdoc opt">,</span>
261
<span class="string">"gnome"</span>
262
<span class="gtkdoc opt">};</span>
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">"gnome-dev-cdrom-audio"</span><span class="gtkdoc opt">);</span></pre></td>
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>
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>
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>
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
421
421
at '-' characters. If the "names" array has more than one element,
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">"gnome-dev-cdrom-audio"</span><span class="gtkdoc opt">,</span>
440
<span class="string">"gnome-dev-cdrom"</span><span class="gtkdoc opt">,</span>
441
<span class="string">"gnome-dev"</span><span class="gtkdoc opt">,</span>
442
<span class="string">"gnome"</span><span class="gtkdoc opt">,</span>
444
<span class="gtkdoc opt">};</span></pre></td>