<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="GFileIcon">
<refmeta>
<refentrytitle role="top_of_page">GFileIcon</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GIO Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GFileIcon</refname>
<refpurpose>Icons pointing to an image file</refpurpose>
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
</refnamediv>

<refsynopsisdiv role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;gio/gio.h&gt;


                    <link linkend="GFileIcon-struct">GFileIcon</link>;
<link linkend="GIcon">GIcon</link>*              <link linkend="g-file-icon-new">g_file_icon_new</link>                     (<link linkend="GFile">GFile</link> *file);
<link linkend="GFile">GFile</link>*              <link linkend="g-file-icon-get-file">g_file_icon_get_file</link>                (<link linkend="GFileIcon">GFileIcon</link> *icon);


</synopsis>
</refsynopsisdiv>

<refsect1 role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>

  <link linkend="GObject">GObject</link>
   +----GFileIcon
</synopsis>

</refsect1>



<refsect1 role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GFileIcon implements
 <link linkend="GIcon">GIcon</link> and  <link linkend="GLoadableIcon">GLoadableIcon</link>.</para>

</refsect1>





<refsect1 role="desc">
<title role="desc.title">Description</title>
<para>
<link linkend="GFileIcon"><type>GFileIcon</type></link> specifies an icon by pointing to an image file
to be used as icon.</para>
<para>

</para>
</refsect1>

<refsect1 role="details">
<title role="details.title">Details</title>
<refsect2>
<title><anchor id="GFileIcon-struct" role="struct"/>GFileIcon</title>
<indexterm><primary>GFileIcon</primary></indexterm><programlisting>typedef struct _GFileIcon GFileIcon;</programlisting>
<para>
Gets an icon for a <link linkend="GFile"><type>GFile</type></link>. Implements <link linkend="GLoadableIcon"><type>GLoadableIcon</type></link>.</para>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="g-file-icon-new" role="function"/>g_file_icon_new ()</title>
<indexterm><primary>g_file_icon_new</primary></indexterm><programlisting><link linkend="GIcon">GIcon</link>*              g_file_icon_new                     (<link linkend="GFile">GFile</link> *file);</programlisting>
<para>
Creates a new icon for a file.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>file</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GFile"><type>GFile</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GIcon"><type>GIcon</type></link> for the given <parameter>file</parameter>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> on error.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="g-file-icon-get-file" role="function"/>g_file_icon_get_file ()</title>
<indexterm><primary>g_file_icon_get_file</primary></indexterm><programlisting><link linkend="GFile">GFile</link>*              g_file_icon_get_file                (<link linkend="GFileIcon">GFileIcon</link> *icon);</programlisting>
<para>
Gets the <link linkend="GFile"><type>GFile</type></link> associated with the given <parameter>icon</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>icon</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GIcon"><type>GIcon</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GFile"><type>GFile</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>



<refsect1>
<title>See Also</title>
<link linkend="GIcon"><type>GIcon</type></link>, <link linkend="GLoadableIcon"><type>GLoadableIcon</type></link>
</refsect1>


<refsect1><refsect2 /><refsect2 /></refsect1>
</refentry>
