4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>StIcon</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
7
<link rel="home" href="index.html" title="St Reference Manual">
8
8
<link rel="up" href="widgets.html" title="Widgets">
9
9
<link rel="prev" href="StEntry.html" title="StEntry">
10
10
<link rel="next" href="StLabel.html" title="StLabel">
11
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
45
45
<a name="StIcon.synopsis"></a><h2>Synopsis</h2>
46
46
<pre class="synopsis"> <a class="link" href="StIcon.html#StIcon-struct" title="StIcon">StIcon</a>;
47
47
<a class="link" href="StIcon.html#StIconClass" title="StIconClass">StIconClass</a>;
48
<a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="returnvalue">GIcon</span></a> * <a class="link" href="StIcon.html#st-icon-get-gicon" title="st_icon_get_gicon ()">st_icon_get_gicon</a> (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>);
49
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="StIcon.html#st-icon-get-icon-name" title="st_icon_get_icon_name ()">st_icon_get_icon_name</a> (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>);
50
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="StIcon.html#st-icon-get-icon-size" title="st_icon_get_icon_size ()">st_icon_get_icon_size</a> (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>);
51
<a href="/usr/share/gtk-doc/html/clutter/ClutterActor.html"><span class="returnvalue">ClutterActor</span></a> * <a class="link" href="StIcon.html#st-icon-new" title="st_icon_new ()">st_icon_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
52
<span class="returnvalue">void</span> <a class="link" href="StIcon.html#st-icon-set-gicon" title="st_icon_set_gicon ()">st_icon_set_gicon</a> (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>,
53
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> *gicon</code></em>);
48
<span class="returnvalue">ClutterActor</span> * <a class="link" href="StIcon.html#st-icon-new" title="st_icon_new ()">st_icon_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
49
const <span class="returnvalue">gchar</span> * <a class="link" href="StIcon.html#st-icon-get-icon-name" title="st_icon_get_icon_name ()">st_icon_get_icon_name</a> (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>);
54
50
<span class="returnvalue">void</span> <a class="link" href="StIcon.html#st-icon-set-icon-name" title="st_icon_set_icon_name ()">st_icon_set_icon_name</a> (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>,
55
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);
51
<em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>);
52
<span class="returnvalue">gint</span> <a class="link" href="StIcon.html#st-icon-get-icon-size" title="st_icon_get_icon_size ()">st_icon_get_icon_size</a> (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>);
56
53
<span class="returnvalue">void</span> <a class="link" href="StIcon.html#st-icon-set-icon-size" title="st_icon_set_icon_size ()">st_icon_set_icon_size</a> (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>,
57
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>);
54
<em class="parameter"><code><span class="type">gint</span> size</code></em>);
55
<span class="returnvalue">void</span> <a class="link" href="StIcon.html#st-icon-set-gicon" title="st_icon_set_gicon ()">st_icon_set_gicon</a> (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>,
56
<em class="parameter"><code><span class="type">GIcon</span> *gicon</code></em>);
57
<span class="returnvalue">GIcon</span> * <a class="link" href="StIcon.html#st-icon-get-gicon" title="st_icon_get_gicon ()">st_icon_get_gicon</a> (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>);
60
60
<div class="refsect1">
61
61
<a name="StIcon.object-hierarchy"></a><h2>Object Hierarchy</h2>
62
62
<pre class="synopsis">
63
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
64
+----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
65
+----<a href="/usr/share/gtk-doc/html/clutter/ClutterActor.html">ClutterActor</a>
64
+----GInitiallyUnowned
66
66
+----<a class="link" href="StWidget.html" title="StWidget">StWidget</a>
71
71
<a name="StIcon.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
74
<a href="/usr/share/gtk-doc/html/clutter/ClutterContainer.html">ClutterContainer</a>, <a href="/usr/share/gtk-doc/html/clutter/ClutterScriptable.html">ClutterScriptable</a>, <a href="/usr/share/gtk-doc/html/clutter/ClutterAnimatable.html">ClutterAnimatable</a> and AtkImplementorIface.</p>
74
ClutterContainer, ClutterScriptable, ClutterAnimatable and AtkImplementorIface.</p>
76
76
<div class="refsect1">
77
77
<a name="StIcon.properties"></a><h2>Properties</h2>
78
78
<pre class="synopsis">
79
"<a class="link" href="StIcon.html#StIcon--gicon" title='The "gicon" property'>gicon</a>" <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a>* : Read / Write
80
"<a class="link" href="StIcon.html#StIcon--icon-name" title='The "icon-name" property'>icon-name</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write
81
"<a class="link" href="StIcon.html#StIcon--icon-size" title='The "icon-size" property'>icon-size</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write
79
"<a class="link" href="StIcon.html#StIcon--gicon" title='The "gicon" property'>gicon</a>" <span class="type">GIcon</span>* : Read / Write
80
"<a class="link" href="StIcon.html#StIcon--icon-name" title='The "icon-name" property'>icon-name</a>" <span class="type">gchar</span>* : Read / Write
81
"<a class="link" href="StIcon.html#StIcon--icon-size" title='The "icon-size" property'>icon-size</a>" <span class="type">gint</span> : Read / Write
84
84
<div class="refsect1">
117
117
<div class="refsect2">
118
<a name="st-icon-get-gicon"></a><h3>st_icon_get_gicon ()</h3>
119
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="returnvalue">GIcon</span></a> * st_icon_get_gicon (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>);</pre>
120
<div class="variablelist"><table border="0" class="variablelist">
122
<col align="left" valign="top">
127
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
131
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
132
<td>the override GIcon, if set, or NULL. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
139
<div class="refsect2">
140
<a name="st-icon-get-icon-name"></a><h3>st_icon_get_icon_name ()</h3>
141
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * st_icon_get_icon_name (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>);</pre>
144
<div class="refsect2">
145
<a name="st-icon-get-icon-size"></a><h3>st_icon_get_icon_size ()</h3>
146
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> st_icon_get_icon_size (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>);</pre>
148
Gets the size explicit size on the icon. This is not necesariily
149
the size that the icon will actually be displayed at.
151
<div class="variablelist"><table border="0" class="variablelist">
153
<col align="left" valign="top">
158
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
162
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
163
<td>the size explicitly set, or -1 if no size has been set</td>
169
<div class="refsect2">
170
118
<a name="st-icon-new"></a><h3>st_icon_new ()</h3>
171
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/clutter/ClutterActor.html"><span class="returnvalue">ClutterActor</span></a> * st_icon_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
119
<pre class="programlisting"><span class="returnvalue">ClutterActor</span> * st_icon_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
173
121
Create a newly allocated <a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a>
188
136
<div class="refsect2">
189
<a name="st-icon-set-gicon"></a><h3>st_icon_set_gicon ()</h3>
190
<pre class="programlisting"><span class="returnvalue">void</span> st_icon_set_gicon (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>,
191
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> *gicon</code></em>);</pre>
192
<div class="variablelist"><table border="0" class="variablelist">
194
<col align="left" valign="top">
199
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
203
<td><p><span class="term"><em class="parameter"><code>gicon</code></em> :</span></p></td>
204
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> to override :icon-name. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
137
<a name="st-icon-get-icon-name"></a><h3>st_icon_get_icon_name ()</h3>
138
<pre class="programlisting">const <span class="returnvalue">gchar</span> * st_icon_get_icon_name (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>);</pre>
211
141
<div class="refsect2">
212
142
<a name="st-icon-set-icon-name"></a><h3>st_icon_set_icon_name ()</h3>
213
143
<pre class="programlisting"><span class="returnvalue">void</span> st_icon_set_icon_name (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>,
214
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre>
144
<em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>);</pre>
147
<div class="refsect2">
148
<a name="st-icon-get-icon-size"></a><h3>st_icon_get_icon_size ()</h3>
149
<pre class="programlisting"><span class="returnvalue">gint</span> st_icon_get_icon_size (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>);</pre>
151
Gets the size explicit size on the icon. This is not necesariily
152
the size that the icon will actually be displayed at.
154
<div class="variablelist"><table border="0" class="variablelist">
156
<col align="left" valign="top">
161
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
165
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
166
<td>the size explicitly set, or -1 if no size has been set</td>
217
172
<div class="refsect2">
218
173
<a name="st-icon-set-icon-size"></a><h3>st_icon_set_icon_size ()</h3>
219
174
<pre class="programlisting"><span class="returnvalue">void</span> st_icon_set_icon_size (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>,
220
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>);</pre>
175
<em class="parameter"><code><span class="type">gint</span> size</code></em>);</pre>
222
177
Sets an explicit size for the icon.
198
<div class="refsect2">
199
<a name="st-icon-set-gicon"></a><h3>st_icon_set_gicon ()</h3>
200
<pre class="programlisting"><span class="returnvalue">void</span> st_icon_set_gicon (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>,
201
<em class="parameter"><code><span class="type">GIcon</span> *gicon</code></em>);</pre>
202
<div class="variablelist"><table border="0" class="variablelist">
204
<col align="left" valign="top">
209
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
213
<td><p><span class="term"><em class="parameter"><code>gicon</code></em> :</span></p></td>
214
<td>a <span class="type">GIcon</span> to override :icon-name. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
221
<div class="refsect2">
222
<a name="st-icon-get-gicon"></a><h3>st_icon_get_gicon ()</h3>
223
<pre class="programlisting"><span class="returnvalue">GIcon</span> * st_icon_get_gicon (<em class="parameter"><code><a class="link" href="StIcon.html" title="StIcon"><span class="type">StIcon</span></a> *icon</code></em>);</pre>
224
<div class="variablelist"><table border="0" class="variablelist">
226
<col align="left" valign="top">
231
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
235
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
236
<td>the override GIcon, if set, or NULL. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
243
243
<div class="refsect1">
244
244
<a name="StIcon.property-details"></a><h2>Property Details</h2>
245
245
<div class="refsect2">
246
246
<a name="StIcon--gicon"></a><h3>The <code class="literal">"gicon"</code> property</h3>
247
<pre class="programlisting"> "gicon" <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a>* : Read / Write</pre>
247
<pre class="programlisting"> "gicon" <span class="type">GIcon</span>* : Read / Write</pre>
248
248
<p>The GIcon shown by this icon actor.</p>
251
251
<div class="refsect2">
252
252
<a name="StIcon--icon-name"></a><h3>The <code class="literal">"icon-name"</code> property</h3>
253
<pre class="programlisting"> "icon-name" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre>
253
<pre class="programlisting"> "icon-name" <span class="type">gchar</span>* : Read / Write</pre>
254
254
<p>An icon name.</p>
255
255
<p>Default value: NULL</p>
258
258
<div class="refsect2">
259
259
<a name="StIcon--icon-size"></a><h3>The <code class="literal">"icon-size"</code> property</h3>
260
<pre class="programlisting"> "icon-size" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write</pre>
260
<pre class="programlisting"> "icon-size" <span class="type">gint</span> : Read / Write</pre>
261
261
<p>The size if the icon, if positive. Otherwise the size will be derived from the current style.</p>
262
262
<p>Allowed values: >= G_MAXULONG</p>
263
263
<p>Default value: -1</p>