<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkImage">
<refmeta>
<refentrytitle role="top_of_page" id="GtkImage.top_of_page">GtkImage</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkImage</refname>
<refpurpose>A widget displaying an image</refpurpose>
</refnamediv>

<refsect1 id="GtkImage.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-image-new">gtk_image_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-image-new-from-file">gtk_image_new_from_file</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-image-new-from-resource">gtk_image_new_from_resource</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-image-new-from-pixbuf">gtk_image_new_from_pixbuf</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-image-new-from-paintable">gtk_image_new_from_paintable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-image-new-from-icon-name">gtk_image_new_from_icon_name</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-image-new-from-gicon">gtk_image_new_from_gicon</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-image-clear">gtk_image_clear</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-image-set-from-file">gtk_image_set_from_file</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-image-set-from-resource">gtk_image_set_from_resource</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-image-set-from-pixbuf">gtk_image_set_from_pixbuf</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-image-set-from-paintable">gtk_image_set_from_paintable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-image-set-from-icon-name">gtk_image_set_from_icon_name</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-image-set-from-gicon">gtk_image_set_from_gicon</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkImageType"><returnvalue>GtkImageType</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-image-get-storage-type">gtk_image_get_storage_type</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkPaintable"><returnvalue>GdkPaintable</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-image-get-paintable">gtk_image_get_paintable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-image-get-icon-name">gtk_image_get_icon_name</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GIcon"><returnvalue>GIcon</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-image-get-gicon">gtk_image_get_gicon</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-image-set-pixel-size">gtk_image_set_pixel_size</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-image-get-pixel-size">gtk_image_get_pixel_size</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-image-set-icon-size">gtk_image_set_icon_size</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkIconSize"><returnvalue>GtkIconSize</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-image-get-icon-size">gtk_image_get_icon_size</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkImage.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkImage--file">file</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GIcon"><type>GIcon</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkImage--gicon">gicon</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkImage--icon-name">icon-name</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkIconSize"><type>GtkIconSize</type></link></entry><entry role="property_name"><link linkend="GtkImage--icon-size">icon-size</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GdkPaintable"><type>GdkPaintable</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkImage--paintable">paintable</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkImage--pixel-size">pixel-size</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkImage--resource">resource</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkImageType"><type>GtkImageType</type></link></entry><entry role="property_name"><link linkend="GtkImage--storage-type">storage-type</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkImage--use-fallback">use-fallback</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkImage.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GtkImage-struct">GtkImage</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkImageType">GtkImageType</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkImage.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkWidget">GtkWidget</link>
            <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkImage
</screen>
</refsect1>
<refsect1 id="GtkImage.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkImage implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link> and  <link linkend="GtkConstraintTarget">GtkConstraintTarget</link>.</para>

</refsect1>

<refsect1 id="GtkImage.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkImage.description" role="desc">
<title role="desc.title">Description</title>
<para>The <link linkend="GtkImage"><type>GtkImage</type></link> widget displays an image. Various kinds of object
can be displayed as an image; most typically, you would load a
<link linkend="GdkTexture"><type>GdkTexture</type></link> from a file, and then display that.
There’s a convenience function to do this, <link linkend="gtk-image-new-from-file"><function>gtk_image_new_from_file()</function></link>,
used as follows:</para>
<informalexample><programlisting role="example"><![CDATA[
  GtkWidget *image;
  image = gtk_image_new_from_file ("myfile.png");
]]></programlisting></informalexample>
<para>
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
<link linkend="gdk-texture-new-from-file"><function>gdk_texture_new_from_file()</function></link>, then create the <link linkend="GtkImage"><type>GtkImage</type></link> with
<link linkend="gtk-image-new-from-paintable"><function>gtk_image_new_from_paintable()</function></link>.</para>
<para>Sometimes an application will want to avoid depending on external data
files, such as image files. See the documentation of <link linkend="GResource"><type>GResource</type></link> for details.
In this case, the <link linkend="GtkImage--resource"><type>“resource”</type></link>, <link linkend="gtk-image-new-from-resource"><function>gtk_image_new_from_resource()</function></link> and
<link linkend="gtk-image-set-from-resource"><function>gtk_image_set_from_resource()</function></link> should be used.</para>
<refsect2><title>CSS nodes</title><para>GtkImage has a single CSS node with the name image. The style classes
.normal-icons or .large-icons may appear, depending on the <link linkend="GtkImage--icon-size"><type>“icon-size”</type></link>
property.</para>
</refsect2>

</refsect1>
<refsect1 id="GtkImage.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-image-new" role="function">
<title>gtk_image_new&#160;()</title>
<indexterm zone="gtk-image-new"><primary>gtk_image_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_image_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a new empty <link linkend="GtkImage"><type>GtkImage</type></link> widget.</para>
<refsect3 id="gtk-image-new.returns" role="returns">
<title>Returns</title>
<para> a newly created <link linkend="GtkImage"><type>GtkImage</type></link> widget. </para>
</refsect3></refsect2>
<refsect2 id="gtk-image-new-from-file" role="function">
<title>gtk_image_new_from_file&#160;()</title>
<indexterm zone="gtk-image-new-from-file"><primary>gtk_image_new_from_file</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_image_new_from_file (<parameter>const <link linkend="gchar"><type>gchar</type></link> *filename</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkImage"><type>GtkImage</type></link> displaying the file <parameter>filename</parameter>
. If the file
isn’t found or can’t be loaded, the resulting <link linkend="GtkImage"><type>GtkImage</type></link> will
display a “broken image” icon. This function never returns <link linkend="NULL:CAPS"><literal>NULL</literal></link>,
it always returns a valid <link linkend="GtkImage"><type>GtkImage</type></link> widget.</para>
<para>If you need to detect failures to load the file, use
<link linkend="gdk-texture-new-from-file"><function>gdk_texture_new_from_file()</function></link> to load the file yourself, then create
the <link linkend="GtkImage"><type>GtkImage</type></link> from the texture.</para>
<para>The storage type (<link linkend="gtk-image-get-storage-type"><function>gtk_image_get_storage_type()</function></link>) of the returned
image is not defined, it will be whatever is appropriate for
displaying the file.</para>
<refsect3 id="gtk-image-new-from-file.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>filename</para></entry>
<entry role="parameter_description"><para>a filename. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>type</acronym> filename]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-image-new-from-file.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkImage"><type>GtkImage</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-image-new-from-resource" role="function">
<title>gtk_image_new_from_resource&#160;()</title>
<indexterm zone="gtk-image-new-from-resource"><primary>gtk_image_new_from_resource</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_image_new_from_resource (<parameter>const <link linkend="gchar"><type>gchar</type></link> *resource_path</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkImage"><type>GtkImage</type></link> displaying the resource file <parameter>resource_path</parameter>
. If the file
isn’t found or can’t be loaded, the resulting <link linkend="GtkImage"><type>GtkImage</type></link> will
display a “broken image” icon. This function never returns <link linkend="NULL:CAPS"><literal>NULL</literal></link>,
it always returns a valid <link linkend="GtkImage"><type>GtkImage</type></link> widget.</para>
<para>If you need to detect failures to load the file, use
<link linkend="gdk-pixbuf-new-from-file"><function>gdk_pixbuf_new_from_file()</function></link> to load the file yourself, then create
the <link linkend="GtkImage"><type>GtkImage</type></link> from the pixbuf.</para>
<para>The storage type (<link linkend="gtk-image-get-storage-type"><function>gtk_image_get_storage_type()</function></link>) of the returned
image is not defined, it will be whatever is appropriate for
displaying the file.</para>
<refsect3 id="gtk-image-new-from-resource.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>resource_path</para></entry>
<entry role="parameter_description"><para>a resource path</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-image-new-from-resource.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkImage"><type>GtkImage</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-image-new-from-pixbuf" role="function">
<title>gtk_image_new_from_pixbuf&#160;()</title>
<indexterm zone="gtk-image-new-from-pixbuf"><primary>gtk_image_new_from_pixbuf</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_image_new_from_pixbuf (<parameter><link linkend="GdkPixbuf"><type>GdkPixbuf</type></link> *pixbuf</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkImage"><type>GtkImage</type></link> displaying <parameter>pixbuf</parameter>
.
The <link linkend="GtkImage"><type>GtkImage</type></link> does not assume a reference to the
pixbuf; you still need to unref it if you own references.
<link linkend="GtkImage"><type>GtkImage</type></link> will add its own reference rather than adopting yours.</para>
<para>This is a helper for <link linkend="gtk-image-new-from-paintable"><function>gtk_image_new_from_paintable()</function></link>, and you can't
get back the exact pixbuf once this is called, only a texture.</para>
<para>Note that this function just creates an <link linkend="GtkImage"><type>GtkImage</type></link> from the pixbuf. The
<link linkend="GtkImage"><type>GtkImage</type></link> created will not react to state changes. Should you want that, 
you should use <link linkend="gtk-image-new-from-icon-name"><function>gtk_image_new_from_icon_name()</function></link>.</para>
<refsect3 id="gtk-image-new-from-pixbuf.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pixbuf</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkPixbuf"><type>GdkPixbuf</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-image-new-from-pixbuf.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkImage"><type>GtkImage</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-image-new-from-paintable" role="function">
<title>gtk_image_new_from_paintable&#160;()</title>
<indexterm zone="gtk-image-new-from-paintable"><primary>gtk_image_new_from_paintable</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_image_new_from_paintable (<parameter><link linkend="GdkPaintable"><type>GdkPaintable</type></link> *paintable</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkImage"><type>GtkImage</type></link> displaying <parameter>paintable</parameter>
.
The <link linkend="GtkImage"><type>GtkImage</type></link> does not assume a reference to the
paintable; you still need to unref it if you own references.
<link linkend="GtkImage"><type>GtkImage</type></link> will add its own reference rather than adopting yours.</para>
<para>The <link linkend="GtkImage"><type>GtkImage</type></link> will track changes to the <parameter>paintable</parameter>
 and update
its size and contents in response to it.</para>
<refsect3 id="gtk-image-new-from-paintable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>paintable</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkPaintable"><type>GdkPaintable</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-image-new-from-paintable.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkImage"><type>GtkImage</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-image-new-from-icon-name" role="function">
<title>gtk_image_new_from_icon_name&#160;()</title>
<indexterm zone="gtk-image-new-from-icon-name"><primary>gtk_image_new_from_icon_name</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_image_new_from_icon_name (<parameter>const <link linkend="gchar"><type>gchar</type></link> *icon_name</parameter>);</programlisting>
<para>Creates a <link linkend="GtkImage"><type>GtkImage</type></link> displaying an icon from the current icon theme.
If the icon name isn’t known, a “broken image” icon will be
displayed instead.  If the current icon theme is changed, the icon
will be updated appropriately.</para>
<para>Note: Before 3.94, this function was taking an extra icon size
argument. See <link linkend="gtk-image-set-icon-size"><function>gtk_image_set_icon_size()</function></link> for another way to set
the icon size.</para>
<refsect3 id="gtk-image-new-from-icon-name.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_name</para></entry>
<entry role="parameter_description"><para>an icon name or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-image-new-from-icon-name.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkImage"><type>GtkImage</type></link> displaying the themed icon</para>
</refsect3></refsect2>
<refsect2 id="gtk-image-new-from-gicon" role="function">
<title>gtk_image_new_from_gicon&#160;()</title>
<indexterm zone="gtk-image-new-from-gicon"><primary>gtk_image_new_from_gicon</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_image_new_from_gicon (<parameter><link linkend="GIcon"><type>GIcon</type></link> *icon</parameter>);</programlisting>
<para>Creates a <link linkend="GtkImage"><type>GtkImage</type></link> displaying an icon from the current icon theme.
If the icon name isn’t known, a “broken image” icon will be
displayed instead.  If the current icon theme is changed, the icon
will be updated appropriately.</para>
<para>Note: Before 3.94, this function was taking an extra icon size
argument. See <link linkend="gtk-image-set-icon-size"><function>gtk_image_set_icon_size()</function></link> for another way to set
the icon size.</para>
<refsect3 id="gtk-image-new-from-gicon.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon</para></entry>
<entry role="parameter_description"><para>an icon</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-image-new-from-gicon.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkImage"><type>GtkImage</type></link> displaying the themed icon</para>
</refsect3></refsect2>
<refsect2 id="gtk-image-clear" role="function">
<title>gtk_image_clear&#160;()</title>
<indexterm zone="gtk-image-clear"><primary>gtk_image_clear</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_image_clear (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>);</programlisting>
<para>Resets the image to be empty.</para>
<refsect3 id="gtk-image-clear.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-image-set-from-file" role="function">
<title>gtk_image_set_from_file&#160;()</title>
<indexterm zone="gtk-image-set-from-file"><primary>gtk_image_set_from_file</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_image_set_from_file (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>,
                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *filename</parameter>);</programlisting>
<para>See <link linkend="gtk-image-new-from-file"><function>gtk_image_new_from_file()</function></link> for details.</para>
<refsect3 id="gtk-image-set-from-file.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>filename</para></entry>
<entry role="parameter_description"><para>a filename or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>type</acronym> filename][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-image-set-from-resource" role="function">
<title>gtk_image_set_from_resource&#160;()</title>
<indexterm zone="gtk-image-set-from-resource"><primary>gtk_image_set_from_resource</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_image_set_from_resource (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>,
                             <parameter>const <link linkend="gchar"><type>gchar</type></link> *resource_path</parameter>);</programlisting>
<para>See <link linkend="gtk-image-new-from-resource"><function>gtk_image_new_from_resource()</function></link> for details.</para>
<refsect3 id="gtk-image-set-from-resource.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>resource_path</para></entry>
<entry role="parameter_description"><para>a resource path or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-image-set-from-pixbuf" role="function">
<title>gtk_image_set_from_pixbuf&#160;()</title>
<indexterm zone="gtk-image-set-from-pixbuf"><primary>gtk_image_set_from_pixbuf</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_image_set_from_pixbuf (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>,
                           <parameter><link linkend="GdkPixbuf"><type>GdkPixbuf</type></link> *pixbuf</parameter>);</programlisting>
<para>See <link linkend="gtk-image-new-from-pixbuf"><function>gtk_image_new_from_pixbuf()</function></link> for details.</para>
<para>Note: This is a helper for <link linkend="gtk-image-set-from-paintable"><function>gtk_image_set_from_paintable()</function></link>, and you can't
get back the exact pixbuf once this is called, only a paintable.</para>
<refsect3 id="gtk-image-set-from-pixbuf.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>pixbuf</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkPixbuf"><type>GdkPixbuf</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-image-set-from-paintable" role="function">
<title>gtk_image_set_from_paintable&#160;()</title>
<indexterm zone="gtk-image-set-from-paintable"><primary>gtk_image_set_from_paintable</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_image_set_from_paintable (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>,
                              <parameter><link linkend="GdkPaintable"><type>GdkPaintable</type></link> *paintable</parameter>);</programlisting>
<para>See <link linkend="gtk-image-new-from-paintable"><function>gtk_image_new_from_paintable()</function></link> for details.</para>
<refsect3 id="gtk-image-set-from-paintable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>paintable</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkPaintable"><type>GdkPaintable</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-image-set-from-icon-name" role="function">
<title>gtk_image_set_from_icon_name&#160;()</title>
<indexterm zone="gtk-image-set-from-icon-name"><primary>gtk_image_set_from_icon_name</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_image_set_from_icon_name (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *icon_name</parameter>);</programlisting>
<para>See <link linkend="gtk-image-new-from-icon-name"><function>gtk_image_new_from_icon_name()</function></link> for details.</para>
<para>Note: Before 3.94, this function was taking an extra icon size
argument. See <link linkend="gtk-image-set-icon-size"><function>gtk_image_set_icon_size()</function></link> for another way to set
the icon size.</para>
<refsect3 id="gtk-image-set-from-icon-name.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_name</para></entry>
<entry role="parameter_description"><para>an icon name or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-image-set-from-gicon" role="function">
<title>gtk_image_set_from_gicon&#160;()</title>
<indexterm zone="gtk-image-set-from-gicon"><primary>gtk_image_set_from_gicon</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_image_set_from_gicon (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>,
                          <parameter><link linkend="GIcon"><type>GIcon</type></link> *icon</parameter>);</programlisting>
<para>See <link linkend="gtk-image-new-from-gicon"><function>gtk_image_new_from_gicon()</function></link> for details.</para>
<para>Note: Before 3.94, this function was taking an extra icon size
argument. See <link linkend="gtk-image-set-icon-size"><function>gtk_image_set_icon_size()</function></link> for another way to set
the icon size.</para>
<refsect3 id="gtk-image-set-from-gicon.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon</para></entry>
<entry role="parameter_description"><para>an icon</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-image-get-storage-type" role="function">
<title>gtk_image_get_storage_type&#160;()</title>
<indexterm zone="gtk-image-get-storage-type"><primary>gtk_image_get_storage_type</primary></indexterm>
<programlisting language="C"><link linkend="GtkImageType"><returnvalue>GtkImageType</returnvalue></link>
gtk_image_get_storage_type (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>);</programlisting>
<para>Gets the type of representation being used by the <link linkend="GtkImage"><type>GtkImage</type></link>
to store image data. If the <link linkend="GtkImage"><type>GtkImage</type></link> has no image data,
the return value will be <link linkend="GTK-IMAGE-EMPTY:CAPS"><literal>GTK_IMAGE_EMPTY</literal></link>.</para>
<refsect3 id="gtk-image-get-storage-type.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-image-get-storage-type.returns" role="returns">
<title>Returns</title>
<para> image representation being used</para>
</refsect3></refsect2>
<refsect2 id="gtk-image-get-paintable" role="function">
<title>gtk_image_get_paintable&#160;()</title>
<indexterm zone="gtk-image-get-paintable"><primary>gtk_image_get_paintable</primary></indexterm>
<programlisting language="C"><link linkend="GdkPaintable"><returnvalue>GdkPaintable</returnvalue></link>&#160;*
gtk_image_get_paintable (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>);</programlisting>
<para>Gets the image <link linkend="GdkPaintable"><type>GdkPaintable</type></link> being displayed by the <link linkend="GtkImage"><type>GtkImage</type></link>.
The storage type of the image must be <link linkend="GTK-IMAGE-EMPTY:CAPS"><literal>GTK_IMAGE_EMPTY</literal></link> or
<link linkend="GTK-IMAGE-PAINTABLE:CAPS"><literal>GTK_IMAGE_PAINTABLE</literal></link> (see <link linkend="gtk-image-get-storage-type"><function>gtk_image_get_storage_type()</function></link>).
The caller of this function does not own a reference to the
returned paintable.</para>
<refsect3 id="gtk-image-get-paintable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-image-get-paintable.returns" role="returns">
<title>Returns</title>
<para>the displayed paintable, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if
the image is empty. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-image-get-icon-name" role="function">
<title>gtk_image_get_icon_name&#160;()</title>
<indexterm zone="gtk-image-get-icon-name"><primary>gtk_image_get_icon_name</primary></indexterm>
<programlisting language="C">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
gtk_image_get_icon_name (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>);</programlisting>
<para>Gets the icon name and size being displayed by the <link linkend="GtkImage"><type>GtkImage</type></link>.
The storage type of the image must be <link linkend="GTK-IMAGE-EMPTY:CAPS"><literal>GTK_IMAGE_EMPTY</literal></link> or
<link linkend="GTK-IMAGE-ICON-NAME:CAPS"><literal>GTK_IMAGE_ICON_NAME</literal></link> (see <link linkend="gtk-image-get-storage-type"><function>gtk_image_get_storage_type()</function></link>).
The returned string is owned by the <link linkend="GtkImage"><type>GtkImage</type></link> and should not
be freed.</para>
<para>Note: This function was changed in 3.94 not to use out parameters
anymore, but return the icon name directly. See <link linkend="gtk-image-get-icon-size"><function>gtk_image_get_icon_size()</function></link>
for a way to get the icon size.</para>
<refsect3 id="gtk-image-get-icon-name.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-image-get-icon-name.returns" role="returns">
<title>Returns</title>
<para>the icon name, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>allow-none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-image-get-gicon" role="function">
<title>gtk_image_get_gicon&#160;()</title>
<indexterm zone="gtk-image-get-gicon"><primary>gtk_image_get_gicon</primary></indexterm>
<programlisting language="C"><link linkend="GIcon"><returnvalue>GIcon</returnvalue></link>&#160;*
gtk_image_get_gicon (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>);</programlisting>
<para>Gets the <link linkend="GIcon"><type>GIcon</type></link> and size being displayed by the <link linkend="GtkImage"><type>GtkImage</type></link>.
The storage type of the image must be <link linkend="GTK-IMAGE-EMPTY:CAPS"><literal>GTK_IMAGE_EMPTY</literal></link> or
<link linkend="GTK-IMAGE-GICON:CAPS"><literal>GTK_IMAGE_GICON</literal></link> (see <link linkend="gtk-image-get-storage-type"><function>gtk_image_get_storage_type()</function></link>).
The caller of this function does not own a reference to the
returned <link linkend="GIcon"><type>GIcon</type></link>.</para>
<para>Note: This function was changed in 3.94 not to use out parameters
anymore, but return the GIcon directly. See <link linkend="gtk-image-get-icon-size"><function>gtk_image_get_icon_size()</function></link>
for a way to get the icon size.</para>
<refsect3 id="gtk-image-get-gicon.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-image-get-gicon.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GIcon"><type>GIcon</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>allow-none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-image-set-pixel-size" role="function">
<title>gtk_image_set_pixel_size&#160;()</title>
<indexterm zone="gtk-image-set-pixel-size"><primary>gtk_image_set_pixel_size</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_image_set_pixel_size (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>,
                          <parameter><link linkend="gint"><type>gint</type></link> pixel_size</parameter>);</programlisting>
<para>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
<link linkend="gtk-image-set-from-icon-name"><function>gtk_image_set_from_icon_name()</function></link>.</para>
<refsect3 id="gtk-image-set-pixel-size.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>pixel_size</para></entry>
<entry role="parameter_description"><para>the new pixel size</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-image-get-pixel-size" role="function">
<title>gtk_image_get_pixel_size&#160;()</title>
<indexterm zone="gtk-image-get-pixel-size"><primary>gtk_image_get_pixel_size</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_image_get_pixel_size (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>);</programlisting>
<para>Gets the pixel size used for named icons.</para>
<refsect3 id="gtk-image-get-pixel-size.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-image-get-pixel-size.returns" role="returns">
<title>Returns</title>
<para> the pixel size used for named icons.</para>
</refsect3></refsect2>
<refsect2 id="gtk-image-set-icon-size" role="function">
<title>gtk_image_set_icon_size&#160;()</title>
<indexterm zone="gtk-image-set-icon-size"><primary>gtk_image_set_icon_size</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_image_set_icon_size (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>,
                         <parameter><link linkend="GtkIconSize"><type>GtkIconSize</type></link> icon_size</parameter>);</programlisting>
<para>Suggests an icon size to the theme for named icons.</para>
<refsect3 id="gtk-image-set-icon-size.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_size</para></entry>
<entry role="parameter_description"><para>the new icon size</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-image-get-icon-size" role="function">
<title>gtk_image_get_icon_size&#160;()</title>
<indexterm zone="gtk-image-get-icon-size"><primary>gtk_image_get_icon_size</primary></indexterm>
<programlisting language="C"><link linkend="GtkIconSize"><returnvalue>GtkIconSize</returnvalue></link>
gtk_image_get_icon_size (<parameter><link linkend="GtkImage"><type>GtkImage</type></link> *image</parameter>);</programlisting>
<para>Gets the icon size used by the <parameter>image</parameter>
 when rendering icons.</para>
<refsect3 id="gtk-image-get-icon-size.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>image</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkImage"><type>GtkImage</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-image-get-icon-size.returns" role="returns">
<title>Returns</title>
<para> the image size used by icons</para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkImage.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkImage-struct" role="struct">
<title>GtkImage</title>
<indexterm zone="GtkImage-struct"><primary>GtkImage</primary></indexterm>
<programlisting language="C">typedef struct _GtkImage GtkImage;</programlisting>
</refsect2>
<refsect2 id="GtkImageType" role="enum">
<title>enum GtkImageType</title>
<indexterm zone="GtkImageType"><primary>GtkImageType</primary></indexterm>
<para>Describes the image data representation used by a <link linkend="GtkImage"><type>GtkImage</type></link>. If you
want to get the image from the widget, you can only get the
currently-stored representation. e.g.  if the
<link linkend="gtk-image-get-storage-type"><function>gtk_image_get_storage_type()</function></link> returns <link linkend="GTK-IMAGE-PAINTABLE:CAPS"><type>GTK_IMAGE_PAINTABLE</type></link>, then you can
call <link linkend="gtk-image-get-paintable"><function>gtk_image_get_paintable()</function></link>.  For empty images, you can request any
storage type (call any of the "get" functions), but they will all
return <link linkend="NULL:CAPS"><literal>NULL</literal></link> values.</para>
<refsect3 id="GtkImageType.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GTK-IMAGE-EMPTY:CAPS">GTK_IMAGE_EMPTY</para></entry>
<entry role="enum_member_description"><para>there is no image displayed by the widget</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-IMAGE-ICON-NAME:CAPS">GTK_IMAGE_ICON_NAME</para></entry>
<entry role="enum_member_description"><para>the widget contains a named icon.
This image type was added in GTK+ 2.6</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-IMAGE-GICON:CAPS">GTK_IMAGE_GICON</para></entry>
<entry role="enum_member_description"><para>the widget contains a <link linkend="GIcon"><type>GIcon</type></link>.
This image type was added in GTK+ 2.14</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-IMAGE-PAINTABLE:CAPS">GTK_IMAGE_PAINTABLE</para></entry>
<entry role="enum_member_description"><para>the widget contains a <link linkend="GdkPaintable"><type>GdkPaintable</type></link>.
This image type was added in GTK+ 3.96</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkImage.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkImage--file" role="property"><title>The <literal>“file”</literal> property</title>
<indexterm zone="GtkImage--file"><primary>GtkImage:file</primary></indexterm>
<programlisting>  “file”                     <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Filename to load and display.</para><para>Owner: GtkImage</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkImage--gicon" role="property"><title>The <literal>“gicon”</literal> property</title>
<indexterm zone="GtkImage--gicon"><primary>GtkImage:gicon</primary></indexterm>
<programlisting>  “gicon”                    <link linkend="GIcon"><type>GIcon</type></link>&#160;*</programlisting>
<para>The GIcon displayed in the GtkImage. For themed icons,
If the icon theme is changed, the image will be updated
automatically.</para>
<para>Owner: GtkImage</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkImage--icon-name" role="property"><title>The <literal>“icon-name”</literal> property</title>
<indexterm zone="GtkImage--icon-name"><primary>GtkImage:icon-name</primary></indexterm>
<programlisting>  “icon-name”                <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The name of the icon in the icon theme. If the icon theme is
changed, the image will be updated automatically.</para>
<para>Owner: GtkImage</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkImage--icon-size" role="property"><title>The <literal>“icon-size”</literal> property</title>
<indexterm zone="GtkImage--icon-size"><primary>GtkImage:icon-size</primary></indexterm>
<programlisting>  “icon-size”                <link linkend="GtkIconSize"><type>GtkIconSize</type></link></programlisting>
<para>Symbolic size to use for icon set or named icon.</para><para>Owner: GtkImage</para>
<para>Flags: Read / Write</para>
<para>Default value: GTK_ICON_SIZE_INHERIT</para>
</refsect2>
<refsect2 id="GtkImage--paintable" role="property"><title>The <literal>“paintable”</literal> property</title>
<indexterm zone="GtkImage--paintable"><primary>GtkImage:paintable</primary></indexterm>
<programlisting>  “paintable”                <link linkend="GdkPaintable"><type>GdkPaintable</type></link>&#160;*</programlisting>
<para>A GdkPaintable to display.</para><para>Owner: GtkImage</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkImage--pixel-size" role="property"><title>The <literal>“pixel-size”</literal> property</title>
<indexterm zone="GtkImage--pixel-size"><primary>GtkImage:pixel-size</primary></indexterm>
<programlisting>  “pixel-size”               <link linkend="gint"><type>gint</type></link></programlisting>
<para>The "pixel-size" property can be used to specify a fixed size
overriding the <link linkend="GtkImage--icon-size"><type>“icon-size”</type></link> property for images of type
<link linkend="GTK-IMAGE-ICON-NAME:CAPS"><literal>GTK_IMAGE_ICON_NAME</literal></link>.</para>
<para>Owner: GtkImage</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -1</para>
<para>Default value: -1</para>
</refsect2>
<refsect2 id="GtkImage--resource" role="property"><title>The <literal>“resource”</literal> property</title>
<indexterm zone="GtkImage--resource"><primary>GtkImage:resource</primary></indexterm>
<programlisting>  “resource”                 <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>A path to a resource file to display.</para>
<para>Owner: GtkImage</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkImage--storage-type" role="property"><title>The <literal>“storage-type”</literal> property</title>
<indexterm zone="GtkImage--storage-type"><primary>GtkImage:storage-type</primary></indexterm>
<programlisting>  “storage-type”             <link linkend="GtkImageType"><type>GtkImageType</type></link></programlisting>
<para>The representation being used for image data.</para><para>Owner: GtkImage</para>
<para>Flags: Read</para>
<para>Default value: GTK_IMAGE_EMPTY</para>
</refsect2>
<refsect2 id="GtkImage--use-fallback" role="property"><title>The <literal>“use-fallback”</literal> property</title>
<indexterm zone="GtkImage--use-fallback"><primary>GtkImage:use-fallback</primary></indexterm>
<programlisting>  “use-fallback”             <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>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 <link linkend="GTK-IMAGE-ICON-NAME:CAPS"><literal>GTK_IMAGE_ICON_NAME</literal></link>
and <link linkend="GTK-IMAGE-GICON:CAPS"><literal>GTK_IMAGE_GICON</literal></link>.</para>
<para>Owner: GtkImage</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>

</refsect1>

</refentry>
