callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

New upstream version 3.22.28

Browse Source
This commit is contained in:
Jeremy Bicha
2018-02-15 04:41:25 -05:00
parent d4022898c0 463ee95136
commit 55d2e9a013
652 changed files with 498643 additions and 49781 deletions
Download Patch File Download Diff File Expand all files Collapse all files

270
docs/reference/gtk/html/GtkImage.html
View File

@ -8,7 +8,7 @@
<link rel="up" href="DisplayWidgets.html" title="Display Widgets">
<link rel="prev" href="GtkLabel.html" title="GtkLabel">
<link rel="next" href="GtkSpinner.html" title="GtkSpinner">
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -52,7 +52,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="returnvalue">GdkPixbuf</span></a> *
<span class="returnvalue">GdkPixbuf</span> *
</td>
<td class="function_name">
<a class="link" href="GtkImage.html#gtk-image-get-pixbuf" title="gtk_image_get_pixbuf ()">gtk_image_get_pixbuf</a> <span class="c_punctuation">()</span>
@ -68,7 +68,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="returnvalue">GdkPixbufAnimation</span></a> *
<span class="returnvalue">GdkPixbufAnimation</span> *
</td>
<td class="function_name">
<a class="link" href="GtkImage.html#gtk-image-get-animation" title="gtk_image_get_animation ()">gtk_image_get_animation</a> <span class="c_punctuation">()</span>
@ -268,7 +268,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkImage.html#gtk-image-get-pixel-size" title="gtk_image_get_pixel_size ()">gtk_image_get_pixel_size</a> <span class="c_punctuation">()</span>
@ -288,19 +288,19 @@
<tbody>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkImage.html#GtkImage--file" title="The “file” property">file</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../gio/GIcon.html#GIcon-struct"><span class="type">GIcon</span></a> *</td>
<span class="type">GIcon</span> *</td>
<td class="property_name"><a class="link" href="GtkImage.html#GtkImage--gicon" title="The “gicon” property">gicon</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkImage.html#GtkImage--icon-name" title="The “icon-name” property">icon-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -311,36 +311,36 @@
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_type"><span class="type">gint</span></td>
<td class="property_name"><a class="link" href="GtkImage.html#GtkImage--icon-size" title="The “icon-size” property">icon-size</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> *</td>
<span class="type">GdkPixbuf</span> *</td>
<td class="property_name"><a class="link" href="GtkImage.html#GtkImage--pixbuf" title="The “pixbuf” property">pixbuf</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="type">GdkPixbufAnimation</span></a> *</td>
<span class="type">GdkPixbufAnimation</span> *</td>
<td class="property_name"><a class="link" href="GtkImage.html#GtkImage--pixbuf-animation" title="The “pixbuf-animation” property">pixbuf-animation</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_type"><span class="type">gint</span></td>
<td class="property_name"><a class="link" href="GtkImage.html#GtkImage--pixel-size" title="The “pixel-size” property">pixel-size</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkImage.html#GtkImage--resource" title="The “resource” property">resource</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkImage.html#GtkImage--stock" title="The “stock” property">stock</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -356,7 +356,7 @@
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkImage.html#GtkImage--use-fallback" title="The “use-fallback” property">use-fallback</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -384,8 +384,8 @@
</div>
<div class="refsect1">
<a name="GtkImage.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GInitiallyUnowned
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
<span class="lineart">╰──</span> <a class="link" href="GtkMisc.html" title="GtkMisc">GtkMisc</a>
<span class="lineart">╰──</span> GtkImage
@ -406,7 +406,7 @@ GtkImage implements
<a name="GtkImage.description"></a><h2>Description</h2>
<p>The <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> widget displays an image. Various kinds of object
can be displayed as an image; most typically, you would load a
<a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> ("pixel buffer") from a file, and then display that.
<span class="type">GdkPixbuf</span> ("pixel buffer") from a file, and then display that.
There’s a convenience function to do this, <a class="link" href="GtkImage.html#gtk-image-new-from-file" title="gtk_image_new_from_file ()"><code class="function">gtk_image_new_from_file()</code></a>,
used as follows:</p>
<div class="informalexample">
@ -415,8 +415,8 @@ used as follows:</p>
<tr>
<td class="listing_lines" align="right"><pre>1
2</pre></td>
<td class="listing_code"><pre class="programlisting">GtkWidget <span class="gtkdoc opt">*</span>image<span class="gtkdoc opt">;</span>
image <span class="gtkdoc opt">=</span> <span class="function"><a href="GtkImage.html#gtk-image-new-from-file">gtk_image_new_from_file</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;myfile.png&quot;</span><span class="gtkdoc opt">);</span></pre></td>
<td class="listing_code"><pre class="programlisting"><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">image</span><span class="symbol">;</span>
<span class="normal">image </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkImage.html#gtk-image-new-from-file">gtk_image_new_from_file</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"myfile.png"</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
@ -427,14 +427,14 @@ If the file isn’t loaded successfully, the image will contain a
“broken image” icon similar to that used in many web browsers.
If you want to handle errors in loading the file yourself,
for example by displaying an error message, then load the image with
<a href="../gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file"><code class="function">gdk_pixbuf_new_from_file()</code></a>, then create the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> with
<code class="function">gdk_pixbuf_new_from_file()</code>, then create the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> with
<a class="link" href="GtkImage.html#gtk-image-new-from-pixbuf" title="gtk_image_new_from_pixbuf ()"><code class="function">gtk_image_new_from_pixbuf()</code></a>.</p>
<p>The image file may contain an animation, if so the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> will
display an animation (<a href="../gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="type">GdkPixbufAnimation</span></a>) instead of a static image.</p>
display an animation (<span class="type">GdkPixbufAnimation</span>) instead of a static image.</p>
<p><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> is a subclass of <a class="link" href="GtkMisc.html" title="GtkMisc"><span class="type">GtkMisc</span></a>, which implies that you can
align it (center, left, right) and add padding to it, using
<a class="link" href="GtkMisc.html" title="GtkMisc"><span class="type">GtkMisc</span></a> methods.</p>
<p><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> is a “no window” widget (has no <a href="../gdk4/gdk4-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> of its own),
<p><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> is a “no window” widget (has no <span class="type">GdkWindow</span> of its own),
so by default does not receive events. If you want to receive events
on the image, such as button clicks, place the image inside a
<a class="link" href="GtkEventBox.html" title="GtkEventBox"><span class="type">GtkEventBox</span></a>, then connect to the event signals on the event box.</p>
@ -477,39 +477,39 @@ on the image, such as button clicks, place the image inside a
31
32
33</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static</span> gboolean
<span class="function">button_press_callback</span> <span class="gtkdoc opt">(</span>GtkWidget <span class="gtkdoc opt">*</span>event_box<span class="gtkdoc opt">,</span>
GdkEventButton <span class="gtkdoc opt">*</span>event<span class="gtkdoc opt">,</span>
gpointer data<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
<span class="function"><a href="../glib/glib-Warnings-and-Assertions.html#g-print">g_print</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;Event box clicked at coordinates %f,%f</span><span class="gtkdoc esc">\n</span><span class="string">&quot;</span><span class="gtkdoc opt">,</span>
event<span class="gtkdoc opt">-&gt;</span>x<span class="gtkdoc opt">,</span> event<span class="gtkdoc opt">-&gt;</span>y<span class="gtkdoc opt">);</span>
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> gboolean</span>
<span class="function">button_press_callback</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event_box</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">GdkEventButton</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
<span class="cbracket">{</span>
<span class="normal"> </span><span class="function">g_print</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Event box clicked at coordinates %f,%f</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span>
<span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">x</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">y</span><span class="symbol">);</span>
<span class="gtkdoc slc">// Returning TRUE means we handled the event, so the signal</span>
<span class="gtkdoc slc">// emission should be stopped (don’t call any further callbacks</span>
<span class="gtkdoc slc">// that may be connected). Return FALSE to continue invoking callbacks.</span>
<span class="keyword">return</span> TRUE<span class="gtkdoc opt">;</span>
<span class="gtkdoc opt">}</span>
<span class="normal"> </span><span class="comment">// Returning TRUE means we handled the event, so the signal</span>
<span class="normal"> </span><span class="comment">// emission should be stopped (don’t call any further callbacks</span>
<span class="normal"> </span><span class="comment">// that may be connected). Return FALSE to continue invoking callbacks.</span>
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> TRUE</span><span class="symbol">;</span>
<span class="cbracket">}</span>
<span class="gtkdoc kwb">static</span> GtkWidget<span class="gtkdoc opt">*</span>
<span class="function">create_image</span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">void</span><span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
GtkWidget <span class="gtkdoc opt">*</span>image<span class="gtkdoc opt">;</span>
GtkWidget <span class="gtkdoc opt">*</span>event_box<span class="gtkdoc opt">;</span>
<span class="keyword">static</span><span class="normal"> <a href="GtkWidget.html#GtkWidget-struct">GtkWidget</a></span><span class="symbol">*</span>
<span class="function">create_image</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
<span class="cbracket">{</span>
<span class="normal"> </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">image</span><span class="symbol">;</span>
<span class="normal"> </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event_box</span><span class="symbol">;</span>
image <span class="gtkdoc opt">=</span> <span class="function"><a href="GtkImage.html#gtk-image-new-from-file">gtk_image_new_from_file</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;myfile.png&quot;</span><span class="gtkdoc opt">);</span>
<span class="normal"> image </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkImage.html#gtk-image-new-from-file">gtk_image_new_from_file</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"myfile.png"</span><span class="symbol">);</span>
event_box <span class="gtkdoc opt">=</span> <span class="function"><a href="GtkEventBox.html#gtk-event-box-new">gtk_event_box_new</a></span> <span class="gtkdoc opt">();</span>
<span class="normal"> event_box </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkEventBox.html#gtk-event-box-new">gtk_event_box_new</a></span><span class="normal"> </span><span class="symbol">();</span>
<span class="function"><a href="GtkContainer.html#gtk-container-add">gtk_container_add</a></span> <span class="gtkdoc opt">(</span><span class="function">GTK_CONTAINER</span> <span class="gtkdoc opt">(</span>event_box<span class="gtkdoc opt">),</span> image<span class="gtkdoc opt">);</span>
<span class="normal"> </span><span class="function"><a href="GtkContainer.html#gtk-container-add">gtk_container_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CONTAINER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event_box</span><span class="symbol">),</span><span class="normal"> image</span><span class="symbol">);</span>
<span class="function"><a href="../gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span> <span class="gtkdoc opt">(</span><span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a></span> <span class="gtkdoc opt">(</span>event_box<span class="gtkdoc opt">),</span>
<span class="string">&quot;button_press_event&quot;</span><span class="gtkdoc opt">,</span>
<span class="function"><a href="../gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span> <span class="gtkdoc opt">(</span>button_press_callback<span class="gtkdoc opt">),</span>
image<span class="gtkdoc opt">);</span>
<span class="normal"> </span><span class="function">g_signal_connect</span><span class="normal"> </span><span class="symbol">(</span><span class="function">G_OBJECT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event_box</span><span class="symbol">),</span>
<span class="normal"> </span><span class="string">"button_press_event"</span><span class="symbol">,</span>
<span class="normal"> </span><span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">button_press_callback</span><span class="symbol">),</span>
<span class="normal"> image</span><span class="symbol">);</span>
<span class="keyword">return</span> image<span class="gtkdoc opt">;</span>
<span class="gtkdoc opt">}</span></pre></td>
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> image</span><span class="symbol">;</span>
<span class="cbracket">}</span></pre></td>
</tr>
</tbody>
</table>
@ -526,8 +526,8 @@ the image will be the same as the origin of the event box.</p>
files, such as image files. GTK+ comes with a program to avoid this,
called “gdk-pixbuf-csource”. This library
allows you to convert an image into a C variable declaration, which
can then be loaded into a <a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> using
<a href="../gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-inline"><code class="function">gdk_pixbuf_new_from_inline()</code></a>.</p>
can then be loaded into a <span class="type">GdkPixbuf</span> using
<code class="function">gdk_pixbuf_new_from_inline()</code>.</p>
</div>
<div class="refsect2">
<a name="id-1.3.8.3.9.9"></a><h3>CSS nodes</h3>
@ -565,14 +565,14 @@ The storage type of the image must be <a class="link" href="GtkImage.html#GTK-IM
</tr>
<tr>
<td class="parameter_name"><p>icon_set</p></td>
<td class="parameter_description"><p> location to store a
<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>location to store a
<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p> location to store a stock
icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>), or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>location to store a stock
icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>), or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
@ -582,9 +582,9 @@ icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" t
<hr>
<div class="refsect2">
<a name="gtk-image-get-pixbuf"></a><h3>gtk_image_get_pixbuf ()</h3>
<pre class="programlisting"><a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="returnvalue">GdkPixbuf</span></a> *
<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *
gtk_image_get_pixbuf (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>);</pre>
<p>Gets the <a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
<p>Gets the <span class="type">GdkPixbuf</span> being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
The storage type of the image must be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
<a class="link" href="GtkImage.html#GTK-IMAGE-PIXBUF:CAPS"><code class="literal">GTK_IMAGE_PIXBUF</code></a> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
The caller of this function does not own a reference to the
@ -606,7 +606,7 @@ returned pixbuf.</p>
</div>
<div class="refsect3">
<a name="gtk-image-get-pixbuf.returns"></a><h4>Returns</h4>
<p> the displayed pixbuf, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
<p>the displayed pixbuf, or <code class="literal">NULL</code> if
the image is empty. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
@ -616,7 +616,7 @@ the image is empty. </p>
<a name="gtk-image-get-stock"></a><h3>gtk_image_get_stock ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_get_stock (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **stock_id</code></em>,
<em class="parameter"><code><span class="type">gchar</span> **stock_id</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> *size</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_image_get_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
@ -643,14 +643,14 @@ be freed.</p>
</tr>
<tr>
<td class="parameter_name"><p>stock_id</p></td>
<td class="parameter_description"><p> place to store a
stock icon name, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>place to store a
stock icon name, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p> place to store a stock icon
size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>), or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>place to store a stock icon
size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>), or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
@ -660,9 +660,9 @@ size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title=
<hr>
<div class="refsect2">
<a name="gtk-image-get-animation"></a><h3>gtk_image_get_animation ()</h3>
<pre class="programlisting"><a href="../gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="returnvalue">GdkPixbufAnimation</span></a> *
<pre class="programlisting"><span class="returnvalue">GdkPixbufAnimation</span> *
gtk_image_get_animation (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>);</pre>
<p>Gets the <a href="../gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="type">GdkPixbufAnimation</span></a> being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
<p>Gets the <span class="type">GdkPixbufAnimation</span> being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
The storage type of the image must be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
<a class="link" href="GtkImage.html#GTK-IMAGE-ANIMATION:CAPS"><code class="literal">GTK_IMAGE_ANIMATION</code></a> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
The caller of this function does not own a reference to the
@ -684,7 +684,7 @@ returned animation.</p>
</div>
<div class="refsect3">
<a name="gtk-image-get-animation.returns"></a><h4>Returns</h4>
<p> the displayed animation, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
<p>the displayed animation, or <code class="literal">NULL</code> if
the image is empty. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
@ -694,7 +694,7 @@ the image is empty. </p>
<a name="gtk-image-get-icon-name"></a><h3>gtk_image_get_icon_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_get_icon_name (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **icon_name</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> **icon_name</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> *size</code></em>);</pre>
<p>Gets the icon name and size being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
The storage type of the image must be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
@ -717,14 +717,14 @@ be freed.</p>
</tr>
<tr>
<td class="parameter_name"><p>icon_name</p></td>
<td class="parameter_description"><p> place to store an
icon name, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>place to store an
icon name, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p> place to store an icon size
(<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>), or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>place to store an icon size
(<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>), or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
@ -737,13 +737,13 @@ icon name, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class=
<a name="gtk-image-get-gicon"></a><h3>gtk_image_get_gicon ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_get_gicon (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
<em class="parameter"><code><a href="../gio/GIcon.html#GIcon-struct"><span class="type">GIcon</span></a> **gicon</code></em>,
<em class="parameter"><code><span class="type">GIcon</span> **gicon</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> *size</code></em>);</pre>
<p>Gets the <a href="../gio/GIcon.html#GIcon-struct"><span class="type">GIcon</span></a> and size being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
<p>Gets the <span class="type">GIcon</span> and size being displayed by the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>.
The storage type of the image must be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a> or
<a class="link" href="GtkImage.html#GTK-IMAGE-GICON:CAPS"><code class="literal">GTK_IMAGE_GICON</code></a> (see <a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>).
The caller of this function does not own a reference to the
returned <a href="../gio/GIcon.html#GIcon-struct"><span class="type">GIcon</span></a>.</p>
returned <span class="type">GIcon</span>.</p>
<div class="refsect3">
<a name="gtk-image-get-gicon.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -760,14 +760,14 @@ returned <a href="../gio/GIcon.html#GIcon-struct"><span class="type">GIcon</span
</tr>
<tr>
<td class="parameter_name"><p>gicon</p></td>
<td class="parameter_description"><p> place to store a
<a href="../gio/GIcon.html#GIcon-struct"><span class="type">GIcon</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>place to store a
<span class="type">GIcon</span>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p> place to store an icon size
(<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>), or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>place to store an icon size
(<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>), or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
@ -807,18 +807,18 @@ the return value will be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAP
<div class="refsect2">
<a name="gtk-image-new-from-file"></a><h3>gtk_image_new_from_file ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_image_new_from_file (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre>
gtk_image_new_from_file (<em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>);</pre>
<p>Creates a new <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> displaying the file <em class="parameter"><code>filename</code></em>
. If the file
isn’t found or can’t be loaded, the resulting <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> will
display a “broken image” icon. This function never returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
display a “broken image” icon. This function never returns <code class="literal">NULL</code>,
it always returns a valid <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> widget.</p>
<p>If the file contains an animation, the image will contain an
animation.</p>
<p>If you need to detect failures to load the file, use
<a href="../gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file"><code class="function">gdk_pixbuf_new_from_file()</code></a> to load the file yourself, then create
<code class="function">gdk_pixbuf_new_from_file()</code> to load the file yourself, then create
the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> from the pixbuf. (Or for animations, use
<a href="../gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-file"><code class="function">gdk_pixbuf_animation_new_from_file()</code></a>).</p>
<code class="function">gdk_pixbuf_animation_new_from_file()</code>).</p>
<p>The storage type (<a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>) of the returned
image is not defined, it will be whatever is appropriate for
displaying the file.</p>
@ -832,7 +832,7 @@ displaying the file.</p>
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>filename</p></td>
<td class="parameter_description"><p> a filename. </p></td>
<td class="parameter_description"><p>a filename. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
</tr></tbody>
</table></div>
@ -878,7 +878,7 @@ icon set; you still need to unref it if you own references.
</tr>
<tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p> a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_description"><p>a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
@ -893,7 +893,7 @@ icon set; you still need to unref it if you own references.
<div class="refsect2">
<a name="gtk-image-new-from-pixbuf"></a><h3>gtk_image_new_from_pixbuf ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_image_new_from_pixbuf (<em class="parameter"><code><a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
gtk_image_new_from_pixbuf (<em class="parameter"><code><span class="type">GdkPixbuf</span> *pixbuf</code></em>);</pre>
<p>Creates a new <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> displaying <em class="parameter"><code>pixbuf</code></em>
.
The <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> does not assume a reference to the
@ -912,7 +912,7 @@ you should use <a class="link" href="GtkImage.html#gtk-image-new-from-icon-name"
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>pixbuf</p></td>
<td class="parameter_description"><p> a <a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>a <span class="type">GdkPixbuf</span>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr></tbody>
</table></div>
@ -926,7 +926,7 @@ you should use <a class="link" href="GtkImage.html#gtk-image-new-from-icon-name"
<div class="refsect2">
<a name="gtk-image-new-from-stock"></a><h3>gtk_image_new_from_stock ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_image_new_from_stock (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>,
gtk_image_new_from_stock (<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_image_new_from_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
@ -954,7 +954,7 @@ You can register your own stock icon names, see
</tr>
<tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p> a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_description"><p>a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
@ -969,13 +969,13 @@ You can register your own stock icon names, see
<div class="refsect2">
<a name="gtk-image-new-from-animation"></a><h3>gtk_image_new_from_animation ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_image_new_from_animation (<em class="parameter"><code><a href="../gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>);</pre>
gtk_image_new_from_animation (<em class="parameter"><code><span class="type">GdkPixbufAnimation</span> *animation</code></em>);</pre>
<p>Creates a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> displaying the given animation.
The <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> does not assume a reference to the
animation; you still need to unref it if you own references.
<a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> will add its own reference rather than adopting yours.</p>
<p>Note that the animation frames are shown using a timeout with
<a href="../glib/glib-The-Main-Event-Loop.html#G-PRIORITY-DEFAULT:CAPS"><span class="type">G_PRIORITY_DEFAULT</span></a>. When using animations to indicate busyness,
<span class="type">G_PRIORITY_DEFAULT</span>. When using animations to indicate busyness,
keep in mind that the animation will only be shown if the main loop
is not busy with something that has a higher priority.</p>
<div class="refsect3">
@ -1002,7 +1002,7 @@ is not busy with something that has a higher priority.</p>
<div class="refsect2">
<a name="gtk-image-new-from-icon-name"></a><h3>gtk_image_new_from_icon_name ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_image_new_from_icon_name (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>,
gtk_image_new_from_icon_name (<em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
<p>Creates a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> displaying an icon from the current icon theme.
If the icon name isn’t known, a “broken image” icon will be
@ -1019,12 +1019,12 @@ will be updated appropriately.</p>
<tbody>
<tr>
<td class="parameter_name"><p>icon_name</p></td>
<td class="parameter_description"><p> an icon name or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>an icon name or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p> a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_description"><p>a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
@ -1040,7 +1040,7 @@ will be updated appropriately.</p>
<div class="refsect2">
<a name="gtk-image-new-from-gicon"></a><h3>gtk_image_new_from_gicon ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_image_new_from_gicon (<em class="parameter"><code><a href="../gio/GIcon.html#GIcon-struct"><span class="type">GIcon</span></a> *icon</code></em>,
gtk_image_new_from_gicon (<em class="parameter"><code><span class="type">GIcon</span> *icon</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
<p>Creates a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> displaying an icon from the current icon theme.
If the icon name isn’t known, a “broken image” icon will be
@ -1062,7 +1062,7 @@ will be updated appropriately.</p>
</tr>
<tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p> a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_description"><p>a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
@ -1078,18 +1078,18 @@ will be updated appropriately.</p>
<div class="refsect2">
<a name="gtk-image-new-from-resource"></a><h3>gtk_image_new_from_resource ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_image_new_from_resource (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *resource_path</code></em>);</pre>
gtk_image_new_from_resource (<em class="parameter"><code>const <span class="type">gchar</span> *resource_path</code></em>);</pre>
<p>Creates a new <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> displaying the resource file <em class="parameter"><code>resource_path</code></em>
. If the file
isn’t found or can’t be loaded, the resulting <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> will
display a “broken image” icon. This function never returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
display a “broken image” icon. This function never returns <code class="literal">NULL</code>,
it always returns a valid <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> widget.</p>
<p>If the file contains an animation, the image will contain an
animation.</p>
<p>If you need to detect failures to load the file, use
<a href="../gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file"><code class="function">gdk_pixbuf_new_from_file()</code></a> to load the file yourself, then create
<code class="function">gdk_pixbuf_new_from_file()</code> to load the file yourself, then create
the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> from the pixbuf. (Or for animations, use
<a href="../gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-file"><code class="function">gdk_pixbuf_animation_new_from_file()</code></a>).</p>
<code class="function">gdk_pixbuf_animation_new_from_file()</code>).</p>
<p>The storage type (<a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a>) of the returned
image is not defined, it will be whatever is appropriate for
displaying the file.</p>
@ -1134,7 +1134,7 @@ surface; you still need to unref it if you own references.
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>surface</p></td>
<td class="parameter_description"><p> a <span class="type">cairo_surface_t</span>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>a <span class="type">cairo_surface_t</span>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr></tbody>
</table></div>
@ -1150,7 +1150,7 @@ surface; you still need to unref it if you own references.
<a name="gtk-image-set-from-file"></a><h3>gtk_image_set_from_file ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_set_from_file (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>);</pre>
<p>See <a class="link" href="GtkImage.html#gtk-image-new-from-file" title="gtk_image_new_from_file ()"><code class="function">gtk_image_new_from_file()</code></a> for details.</p>
<div class="refsect3">
<a name="gtk-image-set-from-file.parameters"></a><h4>Parameters</h4>
@ -1168,7 +1168,7 @@ gtk_image_set_from_file (<em class="parameter"><code><a class="link" href="GtkIm
</tr>
<tr>
<td class="parameter_name"><p>filename</p></td>
<td class="parameter_description"><p> a filename or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>a filename or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -1208,7 +1208,7 @@ gtk_image_set_from_icon_set (<em class="parameter"><code><a class="link" href="G
</tr>
<tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p> a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_description"><p>a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
@ -1220,7 +1220,7 @@ gtk_image_set_from_icon_set (<em class="parameter"><code><a class="link" href="G
<a name="gtk-image-set-from-pixbuf"></a><h3>gtk_image_set_from_pixbuf ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_set_from_pixbuf (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
<em class="parameter"><code><a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
<em class="parameter"><code><span class="type">GdkPixbuf</span> *pixbuf</code></em>);</pre>
<p>See <a class="link" href="GtkImage.html#gtk-image-new-from-pixbuf" title="gtk_image_new_from_pixbuf ()"><code class="function">gtk_image_new_from_pixbuf()</code></a> for details.</p>
<div class="refsect3">
<a name="gtk-image-set-from-pixbuf.parameters"></a><h4>Parameters</h4>
@ -1238,7 +1238,7 @@ gtk_image_set_from_pixbuf (<em class="parameter"><code><a class="link" href="Gtk
</tr>
<tr>
<td class="parameter_name"><p>pixbuf</p></td>
<td class="parameter_description"><p> a <a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>a <span class="type">GdkPixbuf</span> or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -1250,7 +1250,7 @@ gtk_image_set_from_pixbuf (<em class="parameter"><code><a class="link" href="Gtk
<a name="gtk-image-set-from-stock"></a><h3>gtk_image_set_from_stock ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_set_from_stock (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_image_set_from_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
@ -1278,7 +1278,7 @@ gtk_image_set_from_stock (<em class="parameter"><code><a class="link" href="GtkI
</tr>
<tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p> a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_description"><p>a stock icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
@ -1290,9 +1290,9 @@ gtk_image_set_from_stock (<em class="parameter"><code><a class="link" href="GtkI
<a name="gtk-image-set-from-animation"></a><h3>gtk_image_set_from_animation ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_set_from_animation (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
<em class="parameter"><code><a href="../gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>);</pre>
<em class="parameter"><code><span class="type">GdkPixbufAnimation</span> *animation</code></em>);</pre>
<p>Causes the <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> to display the given animation (or display
nothing, if you set the animation to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</p>
nothing, if you set the animation to <code class="literal">NULL</code>).</p>
<div class="refsect3">
<a name="gtk-image-set-from-animation.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1309,7 +1309,7 @@ nothing, if you set the animation to <a href="../glib/glib-Standard-Macros.html#
</tr>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>the <a href="../gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="type">GdkPixbufAnimation</span></a></p></td>
<td class="parameter_description"><p>the <span class="type">GdkPixbufAnimation</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -1321,7 +1321,7 @@ nothing, if you set the animation to <a href="../glib/glib-Standard-Macros.html#
<a name="gtk-image-set-from-icon-name"></a><h3>gtk_image_set_from_icon_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_set_from_icon_name (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
<p>See <a class="link" href="GtkImage.html#gtk-image-new-from-icon-name" title="gtk_image_new_from_icon_name ()"><code class="function">gtk_image_new_from_icon_name()</code></a> for details.</p>
<div class="refsect3">
@ -1340,12 +1340,12 @@ gtk_image_set_from_icon_name (<em class="parameter"><code><a class="link" href="
</tr>
<tr>
<td class="parameter_name"><p>icon_name</p></td>
<td class="parameter_description"><p> an icon name or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>an icon name or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p> an icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_description"><p>an icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
@ -1358,7 +1358,7 @@ gtk_image_set_from_icon_name (<em class="parameter"><code><a class="link" href="
<a name="gtk-image-set-from-gicon"></a><h3>gtk_image_set_from_gicon ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_set_from_gicon (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
<em class="parameter"><code><a href="../gio/GIcon.html#GIcon-struct"><span class="type">GIcon</span></a> *icon</code></em>,
<em class="parameter"><code><span class="type">GIcon</span> *icon</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
<p>See <a class="link" href="GtkImage.html#gtk-image-new-from-gicon" title="gtk_image_new_from_gicon ()"><code class="function">gtk_image_new_from_gicon()</code></a> for details.</p>
<div class="refsect3">
@ -1382,7 +1382,7 @@ gtk_image_set_from_gicon (<em class="parameter"><code><a class="link" href="GtkI
</tr>
<tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p> an icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_description"><p>an icon size (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
@ -1395,7 +1395,7 @@ gtk_image_set_from_gicon (<em class="parameter"><code><a class="link" href="GtkI
<a name="gtk-image-set-from-resource"></a><h3>gtk_image_set_from_resource ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_set_from_resource (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *resource_path</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *resource_path</code></em>);</pre>
<p>See <a class="link" href="GtkImage.html#gtk-image-new-from-resource" title="gtk_image_new_from_resource ()"><code class="function">gtk_image_new_from_resource()</code></a> for details.</p>
<div class="refsect3">
<a name="gtk-image-set-from-resource.parameters"></a><h4>Parameters</h4>
@ -1413,7 +1413,7 @@ gtk_image_set_from_resource (<em class="parameter"><code><a class="link" href="G
</tr>
<tr>
<td class="parameter_name"><p>resource_path</p></td>
<td class="parameter_description"><p> a resource path or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>a resource path or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -1443,7 +1443,7 @@ gtk_image_set_from_surface (<em class="parameter"><code><a class="link" href="Gt
</tr>
<tr>
<td class="parameter_name"><p>surface</p></td>
<td class="parameter_description"><p> a cairo_surface_t or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>a cairo_surface_t or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
@ -1490,7 +1490,7 @@ gtk_image_new (<em class="parameter"><code><span class="type">void</span></code>
<a name="gtk-image-set-pixel-size"></a><h3>gtk_image_set_pixel_size ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_image_set_pixel_size (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> pixel_size</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> pixel_size</code></em>);</pre>
<p>Sets the pixel size to use for named icons. If the pixel size is set
to a value != -1, it is used instead of the icon size set by
<a class="link" href="GtkImage.html#gtk-image-set-from-icon-name" title="gtk_image_set_from_icon_name ()"><code class="function">gtk_image_set_from_icon_name()</code></a>.</p>
@ -1521,7 +1521,7 @@ to a value != -1, it is used instead of the icon size set by
<hr>
<div class="refsect2">
<a name="gtk-image-get-pixel-size"></a><h3>gtk_image_get_pixel_size ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_image_get_pixel_size (<em class="parameter"><code><a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> *image</code></em>);</pre>
<p>Gets the pixel size used for named icons.</p>
<div class="refsect3">
@ -1563,7 +1563,7 @@ currently-stored representation. e.g. if the
<a class="link" href="GtkImage.html#gtk-image-get-storage-type" title="gtk_image_get_storage_type ()"><code class="function">gtk_image_get_storage_type()</code></a> returns <a class="link" href="GtkImage.html#GTK-IMAGE-PIXBUF:CAPS"><span class="type">GTK_IMAGE_PIXBUF</span></a>, then you can
call <a class="link" href="GtkImage.html#gtk-image-get-pixbuf" title="gtk_image_get_pixbuf ()"><code class="function">gtk_image_get_pixbuf()</code></a> but not <a class="link" href="GtkImage.html#gtk-image-get-stock" title="gtk_image_get_stock ()"><code class="function">gtk_image_get_stock()</code></a>. For empty
images, you can request any storage type (call any of the "get"
functions), but they will all return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> values.</p>
functions), but they will all return <code class="literal">NULL</code> values.</p>
<div class="refsect3">
<a name="GtkImageType.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1583,7 +1583,7 @@ functions), but they will all return <a href="../glib/glib-Standard-Macros.html#
<tr>
<td class="enum_member_name"><p><a name="GTK-IMAGE-PIXBUF:CAPS"></a>GTK_IMAGE_PIXBUF</p></td>
<td class="enum_member_description">
<p>the widget contains a <a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a></p>
<p>the widget contains a <span class="type">GdkPixbuf</span></p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -1604,7 +1604,7 @@ functions), but they will all return <a href="../glib/glib-Standard-Macros.html#
<tr>
<td class="enum_member_name"><p><a name="GTK-IMAGE-ANIMATION:CAPS"></a>GTK_IMAGE_ANIMATION</p></td>
<td class="enum_member_description">
<p>the widget contains a <a href="../gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="type">GdkPixbufAnimation</span></a></p>
<p>the widget contains a <span class="type">GdkPixbufAnimation</span></p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -1619,7 +1619,7 @@ functions), but they will all return <a href="../glib/glib-Standard-Macros.html#
<tr>
<td class="enum_member_name"><p><a name="GTK-IMAGE-GICON:CAPS"></a>GTK_IMAGE_GICON</p></td>
<td class="enum_member_description">
<p>the widget contains a <a href="../gio/GIcon.html#GIcon-struct"><span class="type">GIcon</span></a>.
<p>the widget contains a <span class="type">GIcon</span>.
This image type was added in GTK+ 2.14</p>
</td>
<td class="enum_member_annotations"> </td>
@ -1641,7 +1641,7 @@ functions), but they will all return <a href="../glib/glib-Standard-Macros.html#
<a name="GtkImage.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkImage--file"></a><h3>The <code class="literal">“file”</code> property</h3>
<pre class="programlisting"> “file” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “file” <span class="type">gchar</span> *</pre>
<p>Filename to load and display.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@ -1649,7 +1649,7 @@ functions), but they will all return <a href="../glib/glib-Standard-Macros.html#
<hr>
<div class="refsect2">
<a name="GtkImage--gicon"></a><h3>The <code class="literal">“gicon”</code> property</h3>
<pre class="programlisting"> “gicon” <a href="../gio/GIcon.html#GIcon-struct"><span class="type">GIcon</span></a> *</pre>
<pre class="programlisting"> “gicon” <span class="type">GIcon</span> *</pre>
<p>The GIcon displayed in the GtkImage. For themed icons,
If the icon theme is changed, the image will be updated
automatically.</p>
@ -1659,7 +1659,7 @@ automatically.</p>
<hr>
<div class="refsect2">
<a name="GtkImage--icon-name"></a><h3>The <code class="literal">“icon-name”</code> property</h3>
<pre class="programlisting"> “icon-name” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “icon-name” <span class="type">gchar</span> *</pre>
<p>The name of the icon in the icon theme. If the icon theme is
changed, the image will be updated automatically.</p>
<p>Flags: Read / Write</p>
@ -1680,7 +1680,7 @@ changed, the image will be updated automatically.</p>
<hr>
<div class="refsect2">
<a name="GtkImage--icon-size"></a><h3>The <code class="literal">“icon-size”</code> property</h3>
<pre class="programlisting"> “icon-size” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<pre class="programlisting"> “icon-size” <span class="type">gint</span></pre>
<p>Symbolic size to use for stock icon, icon set or named icon.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= 0</p>
@ -1689,21 +1689,21 @@ changed, the image will be updated automatically.</p>
<hr>
<div class="refsect2">
<a name="GtkImage--pixbuf"></a><h3>The <code class="literal">“pixbuf”</code> property</h3>
<pre class="programlisting"> “pixbuf” <a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> *</pre>
<pre class="programlisting"> “pixbuf” <span class="type">GdkPixbuf</span> *</pre>
<p>A GdkPixbuf to display.</p>
<p>Flags: Read / Write</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkImage--pixbuf-animation"></a><h3>The <code class="literal">“pixbuf-animation”</code> property</h3>
<pre class="programlisting"> “pixbuf-animation” <a href="../gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"><span class="type">GdkPixbufAnimation</span></a> *</pre>
<pre class="programlisting"> “pixbuf-animation” <span class="type">GdkPixbufAnimation</span> *</pre>
<p>GdkPixbufAnimation to display.</p>
<p>Flags: Read / Write</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkImage--pixel-size"></a><h3>The <code class="literal">“pixel-size”</code> property</h3>
<pre class="programlisting"> “pixel-size” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<pre class="programlisting"> “pixel-size” <span class="type">gint</span></pre>
<p>The "pixel-size" property can be used to specify a fixed size
overriding the <a class="link" href="GtkImage.html#GtkImage--icon-size" title="The “icon-size” property"><span class="type">“icon-size”</span></a> property for images of type
<a class="link" href="GtkImage.html#GTK-IMAGE-ICON-NAME:CAPS"><code class="literal">GTK_IMAGE_ICON_NAME</code></a>.</p>
@ -1715,7 +1715,7 @@ overriding the <a class="link" href="GtkImage.html#GtkImage--icon-size" title="T
<hr>
<div class="refsect2">
<a name="GtkImage--resource"></a><h3>The <code class="literal">“resource”</code> property</h3>
<pre class="programlisting"> “resource” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “resource” <span class="type">gchar</span> *</pre>
<p>A path to a resource file to display.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@ -1724,7 +1724,7 @@ overriding the <a class="link" href="GtkImage.html#GtkImage--icon-size" title="T
<hr>
<div class="refsect2">
<a name="GtkImage--stock"></a><h3>The <code class="literal">“stock”</code> property</h3>
<pre class="programlisting"> “stock” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “stock” <span class="type">gchar</span> *</pre>
<p>Stock ID for a stock image to display.</p>
<div class="warning">
<p><code class="literal">GtkImage:stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
@ -1751,7 +1751,7 @@ overriding the <a class="link" href="GtkImage.html#GtkImage--icon-size" title="T
<hr>
<div class="refsect2">
<a name="GtkImage--use-fallback"></a><h3>The <code class="literal">“use-fallback”</code> property</h3>
<pre class="programlisting"> “use-fallback” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<pre class="programlisting"> “use-fallback” <span class="type">gboolean</span></pre>
<p>Whether the icon displayed in the GtkImage will use
standard icon names fallback. The value of this property
is only relevant for images of type <a class="link" href="GtkImage.html#GTK-IMAGE-ICON-NAME:CAPS"><code class="literal">GTK_IMAGE_ICON_NAME</code></a>
@ -1763,10 +1763,10 @@ and <a class="link" href="GtkImage.html#GTK-IMAGE-GICON:CAPS"><code class="liter
</div>
<div class="refsect1">
<a name="GtkImage.see-also"></a><h2>See Also</h2>
<p><a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a></p>
<p><span class="type">GdkPixbuf</span></p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25.1</div>
<hr>Generated by GTK-Doc V1.27</div>
</body>
</html>