2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
5
<!ENTITY version SYSTEM "version.xml">
7
<refentry id="GFileIcon">
9
<refentrytitle role="top_of_page" id="GFileIcon.top_of_page">GFileIcon</refentrytitle>
10
<manvolnum>3</manvolnum>
11
<refmiscinfo>GIO Library</refmiscinfo>
15
<refname>GFileIcon</refname>
16
<refpurpose>Icons pointing to an image file</refpurpose>
19
<refsynopsisdiv id="GFileIcon.synopsis" role="synopsis">
20
<title role="synopsis.title">Synopsis</title>
24
#include <gio/gio.h>
26
<link linkend="GFileIcon-struct">GFileIcon</link>;
27
<link linkend="GIcon">GIcon</link> * <link linkend="g-file-icon-new">g_file_icon_new</link> (<link linkend="GFile">GFile</link> *file);
28
<link linkend="GFile">GFile</link> * <link linkend="g-file-icon-get-file">g_file_icon_get_file</link> (<link linkend="GFileIcon">GFileIcon</link> *icon);
32
<refsect1 id="GFileIcon.object-hierarchy" role="object_hierarchy">
33
<title role="object_hierarchy.title">Object Hierarchy</title>
35
<link linkend="GObject">GObject</link>
42
<refsect1 id="GFileIcon.implemented-interfaces" role="impl_interfaces">
43
<title role="impl_interfaces.title">Implemented Interfaces</title>
46
<link linkend="GIcon">GIcon</link> and <link linkend="GLoadableIcon">GLoadableIcon</link>.</para>
50
<refsect1 id="GFileIcon.properties" role="properties">
51
<title role="properties.title">Properties</title>
53
"<link linkend="GFileIcon--file">file</link>" <link linkend="GFile">GFile</link>* : Read / Write / Construct Only
59
<refsect1 id="GFileIcon.description" role="desc">
60
<title role="desc.title">Description</title>
62
<link linkend="GFileIcon"><type>GFileIcon</type></link> specifies an icon by pointing to an image file
63
to be used as icon.</para>
68
<refsect1 id="GFileIcon.details" role="details">
69
<title role="details.title">Details</title>
70
<refsect2 id="GFileIcon-struct" role="struct">
71
<title>GFileIcon</title>
72
<indexterm zone="GFileIcon-struct"><primary sortas="FileIcon">GFileIcon</primary></indexterm><programlisting>typedef struct _GFileIcon GFileIcon;</programlisting>
74
Gets an icon for a <link linkend="GFile"><type>GFile</type></link>. Implements <link linkend="GLoadableIcon"><type>GLoadableIcon</type></link>.</para>
77
<refsect2 id="g-file-icon-new" role="function">
78
<title>g_file_icon_new ()</title>
79
<indexterm zone="g-file-icon-new"><primary sortas="file_icon_new">g_file_icon_new</primary></indexterm><programlisting><link linkend="GIcon">GIcon</link> * g_file_icon_new (<link linkend="GFile">GFile</link> *file);</programlisting>
81
Creates a new icon for a file.</para>
83
</para><variablelist role="params">
84
<varlistentry><term><parameter>file</parameter> :</term>
85
<listitem><simpara> a <link linkend="GFile"><type>GFile</type></link>.
86
</simpara></listitem></varlistentry>
87
<varlistentry><term><emphasis>Returns</emphasis> :</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.
88
</simpara></listitem></varlistentry>
89
</variablelist></refsect2>
90
<refsect2 id="g-file-icon-get-file" role="function">
91
<title>g_file_icon_get_file ()</title>
92
<indexterm zone="g-file-icon-get-file"><primary sortas="file_icon_get_file">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>
94
Gets the <link linkend="GFile"><type>GFile</type></link> associated with the given <parameter>icon</parameter>.</para>
96
</para><variablelist role="params">
97
<varlistentry><term><parameter>icon</parameter> :</term>
98
<listitem><simpara> a <link linkend="GIcon"><type>GIcon</type></link>.
99
</simpara></listitem></varlistentry>
100
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a <link linkend="GFile"><type>GFile</type></link>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
101
</simpara></listitem></varlistentry>
102
</variablelist></refsect2>
105
<refsect1 id="GFileIcon.property-details" role="property_details">
106
<title role="property_details.title">Property Details</title>
107
<refsect2 id="GFileIcon--file" role="property"><title>The <literal>"file"</literal> property</title>
108
<indexterm zone="GFileIcon--file"><primary sortas="FileIcon:file">GFileIcon:file</primary></indexterm><programlisting> "file" <link linkend="GFile">GFile</link>* : Read / Write / Construct Only</programlisting>
110
The file containing the icon.</para>
117
<refsect1 id="GFileIcon.see-also">
118
<title>See Also</title>
119
#GIcon, <link linkend="GLoadableIcon"><type>GLoadableIcon</type></link>