41
33
<h2><span class="refentrytitle"><a name="XfcePanelImage.top_of_page"></a>XfcePanelImage</span></h2>
42
34
<p>XfcePanelImage — Scalable image suitable for panel plugins</p>
44
<td valign="top" align="right"></td>
36
<td class="gallery_image" valign="top" align="right"></td>
45
37
</tr></table></div>
46
<div class="refsynopsisdiv">
47
<a name="XfcePanelImage.synopsis"></a><h2>Synopsis</h2>
48
<pre class="synopsis">
49
#include <libxfce4panel/libxfce4panel.h>
51
<a class="link" href="XfcePanelImage.html#XfcePanelImage-struct" title="XfcePanelImage">XfcePanelImage</a>;
52
<a href="http://developer.gnome.org/gtk2/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="XfcePanelImage.html#xfce-panel-image-new" title="xfce_panel_image_new ()">xfce_panel_image_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
53
<a href="http://developer.gnome.org/gtk2/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="XfcePanelImage.html#xfce-panel-image-new-from-pixbuf" title="xfce_panel_image_new_from_pixbuf ()">xfce_panel_image_new_from_pixbuf</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);
54
<a href="http://developer.gnome.org/gtk2/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="XfcePanelImage.html#xfce-panel-image-new-from-source" title="xfce_panel_image_new_from_source ()">xfce_panel_image_new_from_source</a> (<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> *source</code></em>);
55
<span class="returnvalue">void</span> <a class="link" href="XfcePanelImage.html#xfce-panel-image-set-from-pixbuf" title="xfce_panel_image_set_from_pixbuf ()">xfce_panel_image_set_from_pixbuf</a> (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>,
56
<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);
57
<span class="returnvalue">void</span> <a class="link" href="XfcePanelImage.html#xfce-panel-image-set-from-source" title="xfce_panel_image_set_from_source ()">xfce_panel_image_set_from_source</a> (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>,
58
<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> *source</code></em>);
59
<span class="returnvalue">void</span> <a class="link" href="XfcePanelImage.html#xfce-panel-image-set-size" title="xfce_panel_image_set_size ()">xfce_panel_image_set_size</a> (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>,
60
<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>);
61
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="XfcePanelImage.html#xfce-panel-image-get-size" title="xfce_panel_image_get_size ()">xfce_panel_image_get_size</a> (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>);
62
<span class="returnvalue">void</span> <a class="link" href="XfcePanelImage.html#xfce-panel-image-clear" title="xfce_panel_image_clear ()">xfce_panel_image_clear</a> (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>);
38
<div class="refsect1">
39
<a name="XfcePanelImage.functions"></a><h2>Functions</h2>
40
<div class="informaltable"><table width="100%" border="0">
42
<col width="150px" class="functions_return">
43
<col class="functions_name">
47
<td class="function_type">
48
<a href="http://library.gnome.org/devel/gtk3/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> *
50
<td class="function_name">
51
<a class="link" href="XfcePanelImage.html#xfce-panel-image-new" title="xfce_panel_image_new ()">xfce_panel_image_new</a> <span class="c_punctuation">()</span>
55
<td class="function_type">
56
<a href="http://library.gnome.org/devel/gtk3/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> *
58
<td class="function_name">
59
<a class="link" href="XfcePanelImage.html#xfce-panel-image-new-from-pixbuf" title="xfce_panel_image_new_from_pixbuf ()">xfce_panel_image_new_from_pixbuf</a> <span class="c_punctuation">()</span>
63
<td class="function_type">
64
<a href="http://library.gnome.org/devel/gtk3/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> *
66
<td class="function_name">
67
<a class="link" href="XfcePanelImage.html#xfce-panel-image-new-from-source" title="xfce_panel_image_new_from_source ()">xfce_panel_image_new_from_source</a> <span class="c_punctuation">()</span>
71
<td class="function_type">
72
<span class="returnvalue">void</span>
74
<td class="function_name">
75
<a class="link" href="XfcePanelImage.html#xfce-panel-image-set-from-pixbuf" title="xfce_panel_image_set_from_pixbuf ()">xfce_panel_image_set_from_pixbuf</a> <span class="c_punctuation">()</span>
79
<td class="function_type">
80
<span class="returnvalue">void</span>
82
<td class="function_name">
83
<a class="link" href="XfcePanelImage.html#xfce-panel-image-set-from-source" title="xfce_panel_image_set_from_source ()">xfce_panel_image_set_from_source</a> <span class="c_punctuation">()</span>
87
<td class="function_type">
88
<span class="returnvalue">void</span>
90
<td class="function_name">
91
<a class="link" href="XfcePanelImage.html#xfce-panel-image-set-size" title="xfce_panel_image_set_size ()">xfce_panel_image_set_size</a> <span class="c_punctuation">()</span>
95
<td class="function_type">
96
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
98
<td class="function_name">
99
<a class="link" href="XfcePanelImage.html#xfce-panel-image-get-size" title="xfce_panel_image_get_size ()">xfce_panel_image_get_size</a> <span class="c_punctuation">()</span>
103
<td class="function_type">
104
<span class="returnvalue">void</span>
106
<td class="function_name">
107
<a class="link" href="XfcePanelImage.html#xfce-panel-image-clear" title="xfce_panel_image_clear ()">xfce_panel_image_clear</a> <span class="c_punctuation">()</span>
113
<div class="refsect1">
114
<a name="XfcePanelImage.properties"></a><h2>Properties</h2>
115
<div class="informaltable"><table border="0">
117
<col width="150px" class="properties_type">
118
<col width="300px" class="properties_name">
119
<col width="200px" class="properties_flags">
123
<td class="property_type">
124
<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *</td>
125
<td class="property_name"><a class="link" href="XfcePanelImage.html#XfcePanelImage--pixbuf" title="The “pixbuf” property">pixbuf</a></td>
126
<td class="property_flags">Read / Write</td>
129
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
130
<td class="property_name"><a class="link" href="XfcePanelImage.html#XfcePanelImage--size" title="The “size” property">size</a></td>
131
<td class="property_flags">Read / Write</td>
134
<td class="property_type">
135
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
136
<td class="property_name"><a class="link" href="XfcePanelImage.html#XfcePanelImage--source" title="The “source” property">source</a></td>
137
<td class="property_flags">Read / Write</td>
142
<div class="refsect1">
143
<a name="XfcePanelImage.style-properties"></a><h2>Style Properties</h2>
144
<div class="informaltable"><table border="0">
146
<col width="150px" class="style_properties_type">
147
<col width="300px" class="style_properties_name">
148
<col width="200px" class="style_properties_flags">
151
<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>
152
<td class="property_name"><a class="link" href="XfcePanelImage.html#XfcePanelImage--s-force-gtk-icon-sizes" title="The “force-gtk-icon-sizes” style property">force-gtk-icon-sizes</a></td>
153
<td class="property_flags">Read / Write</td>
157
<div class="refsect1">
158
<a name="XfcePanelImage.other"></a><h2>Types and Values</h2>
159
<div class="informaltable"><table width="100%" border="0">
161
<col width="150px" class="name">
162
<col class="description">
165
<td class="datatype_keyword">struct</td>
166
<td class="function_name"><a class="link" href="XfcePanelImage.html#XfcePanelImage-struct" title="struct XfcePanelImage">XfcePanelImage</a></td>
65
170
<div class="refsect1">
66
171
<a name="XfcePanelImage.object-hierarchy"></a><h2>Object Hierarchy</h2>
67
<pre class="synopsis">
68
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
69
+----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
70
+----<a href="../gtk2/GtkObject.html">GtkObject</a>
71
+----<a href="http://developer.gnome.org/gtk2/GtkWidget.html">GtkWidget</a>
172
<pre class="screen"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
173
<span class="lineart">╰──</span> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
174
<span class="lineart">╰──</span> <a href="http://library.gnome.org/devel/gtk3/GtkObject.html">GtkObject</a>
175
<span class="lineart">╰──</span> <a href="http://library.gnome.org/devel/gtk3/GtkWidget.html">GtkWidget</a>
176
<span class="lineart">╰──</span> XfcePanelImage
75
179
<div class="refsect1">
76
180
<a name="XfcePanelImage.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
78
182
XfcePanelImage implements
79
AtkImplementorIface and <a href="http://developer.gnome.org/gtk2/GtkBuildable.html">GtkBuildable</a>.</p>
81
<div class="refsect1">
82
<a name="XfcePanelImage.properties"></a><h2>Properties</h2>
83
<pre class="synopsis">
84
"<a class="link" href="XfcePanelImage.html#XfcePanelImage--pixbuf" title='The "pixbuf" property'>pixbuf</a>" <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>* : Read / Write
85
"<a class="link" href="XfcePanelImage.html#XfcePanelImage--size" title='The "size" property'>size</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write
86
"<a class="link" href="XfcePanelImage.html#XfcePanelImage--source" title='The "source" property'>source</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write
89
<div class="refsect1">
90
<a name="XfcePanelImage.style-properties"></a><h2>Style Properties</h2>
91
<pre class="synopsis">
92
"<a class="link" href="XfcePanelImage.html#XfcePanelImage--s-force-gtk-icon-sizes" title='The "force-gtk-icon-sizes" style property'>force-gtk-icon-sizes</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write
183
AtkImplementorIface and <a href="http://library.gnome.org/devel/gtk3/GtkBuildable.html">GtkBuildable</a>.</p>
185
<div class="refsect1">
186
<a name="XfcePanelImage.includes"></a><h2>Includes</h2>
187
<pre class="synopsis">#include <libxfce4panel/libxfce4panel.h>
95
190
<div class="refsect1">
96
191
<a name="XfcePanelImage.description"></a><h2>Description</h2>
98
The <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> is a widgets suitable for for example panel
192
<p>The <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> is a widgets suitable for for example panel
99
193
buttons where the developer does not exacly know the size of the
100
image (due to theming and user setting).
103
The <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> widget automatically scales to the allocated
194
image (due to theming and user setting).</p>
195
<p>The <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> widget automatically scales to the allocated
104
196
size of the widget. Because of that nature it never requests a size,
105
197
so this will only work if you pack the image in another widget
106
198
that will expand it.
107
If you want to force an image size you can use <a class="link" href="XfcePanelImage.html#xfce-panel-image-set-size" title="xfce_panel_image_set_size ()"><code class="function">xfce_panel_image_set_size()</code></a>
199
If you want to force an image size you can use <a class="link" href="XfcePanelImage.html#xfce-panel-image-set-size" title="xfce_panel_image_set_size ()"><code class="function">xfce_panel_image_set_size()</code></a>
108
200
to set a pixel size, in that case the widget will request an fixed size
109
which makes it usefull for usage in dialogs.
201
which makes it usefull for usage in dialogs.</p>
112
203
<div class="refsect1">
113
<a name="XfcePanelImage.details"></a><h2>Details</h2>
204
<a name="XfcePanelImage.functions_details"></a><h2>Functions</h2>
114
205
<div class="refsect2">
115
<a name="XfcePanelImage-struct"></a><h3>XfcePanelImage</h3>
116
<pre class="programlisting">typedef struct _XfcePanelImage XfcePanelImage;</pre>
118
This struct contain private data only and should be accessed by
206
<a name="xfce-panel-image-new"></a><h3>xfce_panel_image_new ()</h3>
207
<pre class="programlisting"><a href="http://library.gnome.org/devel/gtk3/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> *
208
xfce_panel_image_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
209
<p>Creates a new empty <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> widget.</p>
210
<div class="refsect3">
211
<a name="id-1.4.5.11.2.5"></a><h4>Returns</h4>
212
<p> a newly created XfcePanelImage widget.</p>
123
<div class="refsect2">
124
<a name="xfce-panel-image-new"></a><h3>xfce_panel_image_new ()</h3>
125
<pre class="programlisting"><a href="http://developer.gnome.org/gtk2/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * xfce_panel_image_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
127
Creates a new empty <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> widget.
129
<div class="variablelist"><table border="0" class="variablelist">
131
<col align="left" valign="top">
135
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
136
<td>a newly created XfcePanelImage widget.</td>
139
215
<p class="since">Since 4.8</p>
142
218
<div class="refsect2">
143
<a name="xfce-panel-image-new-from-pixbuf"></a><h3>xfce_panel_image_new_from_pixbuf ()</h3>
144
<pre class="programlisting"><a href="http://developer.gnome.org/gtk2/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * xfce_panel_image_new_from_pixbuf (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
146
Creates a new <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> displaying <em class="parameter"><code>pixbuf</code></em>. <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>
219
<a name="xfce-panel-image-new-from-pixbuf"></a><h3>xfce_panel_image_new_from_pixbuf ()</h3>
220
<pre class="programlisting"><a href="http://library.gnome.org/devel/gtk3/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> *
221
xfce_panel_image_new_from_pixbuf (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
222
<p>Creates a new <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> displaying <em class="parameter"><code>pixbuf</code></em>
223
. <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>
147
224
will add its own reference rather than adopting yours. You don't
148
225
need to scale the pixbuf to the correct size, the <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>
149
226
will take care of that based on the allocation of the widget or
150
the size set with <a class="link" href="XfcePanelImage.html#xfce-panel-image-set-size" title="xfce_panel_image_set_size ()"><code class="function">xfce_panel_image_set_size()</code></a>.
152
<div class="variablelist"><table border="0" class="variablelist">
227
the size set with <a class="link" href="XfcePanelImage.html#xfce-panel-image-set-size" title="xfce_panel_image_set_size ()"><code class="function">xfce_panel_image_set_size()</code></a>.</p>
228
<div class="refsect3">
229
<a name="id-1.4.5.11.3.5"></a><h4>Parameters</h4>
230
<div class="informaltable"><table width="100%" border="0">
154
<col align="left" valign="top">
232
<col width="150px" class="parameters_name">
233
<col class="parameters_description">
234
<col width="200px" class="parameters_annotations">
159
<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
160
<td>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
163
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
164
<td>a newly created XfcePanelImage widget.</td>
237
<td class="parameter_name"><p>pixbuf</p></td>
238
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
239
<td class="parameter_annotations"> </td>
243
<div class="refsect3">
244
<a name="id-1.4.5.11.3.6"></a><h4>Returns</h4>
245
<p> a newly created XfcePanelImage widget.</p>
168
248
<p class="since">Since 4.8</p>
171
251
<div class="refsect2">
172
<a name="xfce-panel-image-new-from-source"></a><h3>xfce_panel_image_new_from_source ()</h3>
173
<pre class="programlisting"><a href="http://developer.gnome.org/gtk2/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * xfce_panel_image_new_from_source (<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> *source</code></em>);</pre>
175
Creates a new <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> displaying <em class="parameter"><code>source</code></em>. <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>
176
will detect if <em class="parameter"><code>source</code></em> points to an absolute file or it and icon-name.
252
<a name="xfce-panel-image-new-from-source"></a><h3>xfce_panel_image_new_from_source ()</h3>
253
<pre class="programlisting"><a href="http://library.gnome.org/devel/gtk3/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> *
254
xfce_panel_image_new_from_source (<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> *source</code></em>);</pre>
255
<p>Creates a new <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> displaying <em class="parameter"><code>source</code></em>
256
. <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>
257
will detect if <em class="parameter"><code>source</code></em>
258
points to an absolute file or it and icon-name.
177
259
For icon-names it will also look for files in the pixbuf folder or
178
260
strip the extensions, which makes it suitable for usage with icon
179
keys in .desktop files.
181
<div class="variablelist"><table border="0" class="variablelist">
183
<col align="left" valign="top">
188
<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
189
<td>source of the image. This can be an absolute path or
190
an icon-name or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
193
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
194
<td>a newly created XfcePanelImage widget.</td>
198
<p class="since">Since 4.8</p>
201
<div class="refsect2">
202
<a name="xfce-panel-image-set-from-pixbuf"></a><h3>xfce_panel_image_set_from_pixbuf ()</h3>
203
<pre class="programlisting"><span class="returnvalue">void</span> xfce_panel_image_set_from_pixbuf (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>,
204
<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
206
See <a class="link" href="XfcePanelImage.html#xfce-panel-image-new-from-pixbuf" title="xfce_panel_image_new_from_pixbuf ()"><code class="function">xfce_panel_image_new_from_pixbuf()</code></a> for details.
208
<div class="variablelist"><table border="0" class="variablelist">
210
<col align="left" valign="top">
215
<td><p><span class="term"><em class="parameter"><code>image</code></em> :</span></p></td>
216
<td>an <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>.</td>
219
<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
220
<td>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
224
<p class="since">Since 4.8</p>
227
<div class="refsect2">
228
<a name="xfce-panel-image-set-from-source"></a><h3>xfce_panel_image_set_from_source ()</h3>
229
<pre class="programlisting"><span class="returnvalue">void</span> xfce_panel_image_set_from_source (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>,
230
<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> *source</code></em>);</pre>
232
See <a class="link" href="XfcePanelImage.html#xfce-panel-image-new-from-source" title="xfce_panel_image_new_from_source ()"><code class="function">xfce_panel_image_new_from_source()</code></a> for details.
234
<div class="variablelist"><table border="0" class="variablelist">
236
<col align="left" valign="top">
241
<td><p><span class="term"><em class="parameter"><code>image</code></em> :</span></p></td>
242
<td>an <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>.</td>
245
<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
246
<td>source of the image. This can be an absolute path or
247
an icon-name or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
251
<p class="since">Since 4.8</p>
254
<div class="refsect2">
255
<a name="xfce-panel-image-set-size"></a><h3>xfce_panel_image_set_size ()</h3>
256
<pre class="programlisting"><span class="returnvalue">void</span> xfce_panel_image_set_size (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>,
257
<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>
259
This will force an image size, instead of looking at the allocation
260
size, see introduction for more details. You can set a <em class="parameter"><code>size</code></em> of
263
<div class="variablelist"><table border="0" class="variablelist">
265
<col align="left" valign="top">
270
<td><p><span class="term"><em class="parameter"><code>image</code></em> :</span></p></td>
271
<td>an <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>.</td>
274
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
275
<td>a new size in pixels.</td>
279
<p class="since">Since 4.8</p>
282
<div class="refsect2">
283
<a name="xfce-panel-image-get-size"></a><h3>xfce_panel_image_get_size ()</h3>
284
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> xfce_panel_image_get_size (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>);</pre>
286
The size of the image, set by <a class="link" href="XfcePanelImage.html#xfce-panel-image-set-size" title="xfce_panel_image_set_size ()"><code class="function">xfce_panel_image_set_size()</code></a> or -1
287
if no size is forced and the image is scaled to the allocation size.
289
<div class="variablelist"><table border="0" class="variablelist">
291
<col align="left" valign="top">
296
<td><p><span class="term"><em class="parameter"><code>image</code></em> :</span></p></td>
297
<td>an <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>.</td>
300
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
301
<td>icon size in pixels of the image or -1.</td>
305
<p class="since">Since 4.8</p>
308
<div class="refsect2">
309
<a name="xfce-panel-image-clear"></a><h3>xfce_panel_image_clear ()</h3>
310
<pre class="programlisting"><span class="returnvalue">void</span> xfce_panel_image_clear (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>);</pre>
312
Resets the image to be empty.
314
<div class="variablelist"><table border="0" class="variablelist">
316
<col align="left" valign="top">
320
<td><p><span class="term"><em class="parameter"><code>image</code></em> :</span></p></td>
321
<td>an <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>.</td>
324
<p class="since">Since 4.8</p>
261
keys in .desktop files.</p>
262
<div class="refsect3">
263
<a name="id-1.4.5.11.4.5"></a><h4>Parameters</h4>
264
<div class="informaltable"><table width="100%" border="0">
266
<col width="150px" class="parameters_name">
267
<col class="parameters_description">
268
<col width="200px" class="parameters_annotations">
271
<td class="parameter_name"><p>source</p></td>
272
<td class="parameter_description"><p>source of the image. This can be an absolute path or
273
an icon-name or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
274
<td class="parameter_annotations"> </td>
278
<div class="refsect3">
279
<a name="id-1.4.5.11.4.6"></a><h4>Returns</h4>
280
<p> a newly created XfcePanelImage widget.</p>
283
<p class="since">Since 4.8</p>
286
<div class="refsect2">
287
<a name="xfce-panel-image-set-from-pixbuf"></a><h3>xfce_panel_image_set_from_pixbuf ()</h3>
288
<pre class="programlisting"><span class="returnvalue">void</span>
289
xfce_panel_image_set_from_pixbuf (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>,
290
<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
291
<p>See <a class="link" href="XfcePanelImage.html#xfce-panel-image-new-from-pixbuf" title="xfce_panel_image_new_from_pixbuf ()"><code class="function">xfce_panel_image_new_from_pixbuf()</code></a> for details.</p>
292
<div class="refsect3">
293
<a name="id-1.4.5.11.5.5"></a><h4>Parameters</h4>
294
<div class="informaltable"><table width="100%" border="0">
296
<col width="150px" class="parameters_name">
297
<col class="parameters_description">
298
<col width="200px" class="parameters_annotations">
302
<td class="parameter_name"><p>image</p></td>
303
<td class="parameter_description"><p>an <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>.</p></td>
304
<td class="parameter_annotations"> </td>
307
<td class="parameter_name"><p>pixbuf</p></td>
308
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
309
<td class="parameter_annotations"> </td>
314
<p class="since">Since 4.8</p>
317
<div class="refsect2">
318
<a name="xfce-panel-image-set-from-source"></a><h3>xfce_panel_image_set_from_source ()</h3>
319
<pre class="programlisting"><span class="returnvalue">void</span>
320
xfce_panel_image_set_from_source (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>,
321
<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> *source</code></em>);</pre>
322
<p>See <a class="link" href="XfcePanelImage.html#xfce-panel-image-new-from-source" title="xfce_panel_image_new_from_source ()"><code class="function">xfce_panel_image_new_from_source()</code></a> for details.</p>
323
<div class="refsect3">
324
<a name="id-1.4.5.11.6.5"></a><h4>Parameters</h4>
325
<div class="informaltable"><table width="100%" border="0">
327
<col width="150px" class="parameters_name">
328
<col class="parameters_description">
329
<col width="200px" class="parameters_annotations">
333
<td class="parameter_name"><p>image</p></td>
334
<td class="parameter_description"><p>an <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>.</p></td>
335
<td class="parameter_annotations"> </td>
338
<td class="parameter_name"><p>source</p></td>
339
<td class="parameter_description"><p>source of the image. This can be an absolute path or
340
an icon-name or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
341
<td class="parameter_annotations"> </td>
346
<p class="since">Since 4.8</p>
349
<div class="refsect2">
350
<a name="xfce-panel-image-set-size"></a><h3>xfce_panel_image_set_size ()</h3>
351
<pre class="programlisting"><span class="returnvalue">void</span>
352
xfce_panel_image_set_size (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>,
353
<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>
354
<p>This will force an image size, instead of looking at the allocation
355
size, see introduction for more details. You can set a <em class="parameter"><code>size</code></em>
357
-1 to turn this off.</p>
358
<div class="refsect3">
359
<a name="id-1.4.5.11.7.5"></a><h4>Parameters</h4>
360
<div class="informaltable"><table width="100%" border="0">
362
<col width="150px" class="parameters_name">
363
<col class="parameters_description">
364
<col width="200px" class="parameters_annotations">
368
<td class="parameter_name"><p>image</p></td>
369
<td class="parameter_description"><p>an <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>.</p></td>
370
<td class="parameter_annotations"> </td>
373
<td class="parameter_name"><p>size</p></td>
374
<td class="parameter_description"><p>a new size in pixels.</p></td>
375
<td class="parameter_annotations"> </td>
380
<p class="since">Since 4.8</p>
383
<div class="refsect2">
384
<a name="xfce-panel-image-get-size"></a><h3>xfce_panel_image_get_size ()</h3>
385
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
386
xfce_panel_image_get_size (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>);</pre>
387
<p>The size of the image, set by <a class="link" href="XfcePanelImage.html#xfce-panel-image-set-size" title="xfce_panel_image_set_size ()"><code class="function">xfce_panel_image_set_size()</code></a> or -1
388
if no size is forced and the image is scaled to the allocation size.</p>
389
<div class="refsect3">
390
<a name="id-1.4.5.11.8.5"></a><h4>Parameters</h4>
391
<div class="informaltable"><table width="100%" border="0">
393
<col width="150px" class="parameters_name">
394
<col class="parameters_description">
395
<col width="200px" class="parameters_annotations">
398
<td class="parameter_name"><p>image</p></td>
399
<td class="parameter_description"><p>an <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>.</p></td>
400
<td class="parameter_annotations"> </td>
404
<div class="refsect3">
405
<a name="id-1.4.5.11.8.6"></a><h4>Returns</h4>
406
<p> icon size in pixels of the image or -1.</p>
409
<p class="since">Since 4.8</p>
412
<div class="refsect2">
413
<a name="xfce-panel-image-clear"></a><h3>xfce_panel_image_clear ()</h3>
414
<pre class="programlisting"><span class="returnvalue">void</span>
415
xfce_panel_image_clear (<em class="parameter"><code><a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a> *image</code></em>);</pre>
416
<p>Resets the image to be empty.</p>
417
<div class="refsect3">
418
<a name="id-1.4.5.11.9.5"></a><h4>Parameters</h4>
419
<div class="informaltable"><table width="100%" border="0">
421
<col width="150px" class="parameters_name">
422
<col class="parameters_description">
423
<col width="200px" class="parameters_annotations">
426
<td class="parameter_name"><p>image</p></td>
427
<td class="parameter_description"><p>an <a class="link" href="XfcePanelImage.html" title="XfcePanelImage"><span class="type">XfcePanelImage</span></a>.</p></td>
428
<td class="parameter_annotations"> </td>
432
<p class="since">Since 4.8</p>
435
<div class="refsect1">
436
<a name="XfcePanelImage.other_details"></a><h2>Types and Values</h2>
437
<div class="refsect2">
438
<a name="XfcePanelImage-struct"></a><h3>struct XfcePanelImage</h3>
439
<pre class="programlisting">struct XfcePanelImage;</pre>
440
<p>This struct contain private data only and should be accessed by
441
the functions below.</p>
327
444
<div class="refsect1">
328
445
<a name="XfcePanelImage.property-details"></a><h2>Property Details</h2>
329
446
<div class="refsect2">
330
<a name="XfcePanelImage--pixbuf"></a><h3>The <code class="literal">"pixbuf"</code> property</h3>
331
<pre class="programlisting"> "pixbuf" <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>* : Read / Write</pre>
447
<a name="XfcePanelImage--pixbuf"></a><h3>The <code class="literal">“pixbuf”</code> property</h3>
448
<pre class="programlisting"> “pixbuf” <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *</pre>
332
449
<p>Pixbuf image.</p>
450
<p>Flags: Read / Write</p>
335
453
<div class="refsect2">
336
<a name="XfcePanelImage--size"></a><h3>The <code class="literal">"size"</code> property</h3>
337
<pre class="programlisting"> "size" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write</pre>
454
<a name="XfcePanelImage--size"></a><h3>The <code class="literal">“size”</code> property</h3>
455
<pre class="programlisting"> “size” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
338
456
<p>Pixel size of the image.</p>
457
<p>Flags: Read / Write</p>
339
458
<p>Allowed values: [-1,128]</p>
340
459
<p>Default value: -1</p>
343
462
<div class="refsect2">
344
<a name="XfcePanelImage--source"></a><h3>The <code class="literal">"source"</code> property</h3>
345
<pre class="programlisting"> "source" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre>
463
<a name="XfcePanelImage--source"></a><h3>The <code class="literal">“source”</code> property</h3>
464
<pre class="programlisting"> “source” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
346
465
<p>Icon or filename.</p>
466
<p>Flags: Read / Write</p>
347
467
<p>Default value: NULL</p>
350
470
<div class="refsect1">
351
471
<a name="XfcePanelImage.style-property-details"></a><h2>Style Property Details</h2>
352
472
<div class="refsect2">
353
<a name="XfcePanelImage--s-force-gtk-icon-sizes"></a><h3>The <code class="literal">"force-gtk-icon-sizes"</code> style property</h3>
354
<pre class="programlisting"> "force-gtk-icon-sizes" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
473
<a name="XfcePanelImage--s-force-gtk-icon-sizes"></a><h3>The <code class="literal">“force-gtk-icon-sizes”</code> style property</h3>
474
<pre class="programlisting"> “force-gtk-icon-sizes” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
355
475
<p>Force the image to fix to GtkIconSizes.</p>
476
<p>Flags: Read / Write</p>
356
477
<p>Default value: FALSE</p>
360
481
<div class="footer">
362
Generated by GTK-Doc V1.19</div>
483
Generated by GTK-Doc V1.20</div>
b'\\ No newline at end of file'