~ubuntu-branches/ubuntu/raring/gtk+2.0/raring-proposed

<a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-new" title="gtk_icon_theme_new ()">gtk_icon_theme_new</a> (<code>void</code>);

<a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-default" title="gtk_icon_theme_get_default ()">gtk_icon_theme_get_default</a> (<code>void</code>);

<a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-for-screen" title="gtk_icon_theme_get_for_screen ()">gtk_icon_theme_get_for_screen</a> (<code><a href="http://library.gnome.org/devel/gdk3/GdkScreen.html">GdkScreen</a> *screen</code>);

<a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-for-screen" title="gtk_icon_theme_get_for_screen ()">gtk_icon_theme_get_for_screen</a> (<code><a href="../gdk2/GdkScreen.html">GdkScreen</a> *screen</code>);

void <a class="link" href="GtkIconTheme.html#gtk-icon-theme-set-screen" title="gtk_icon_theme_set_screen ()">gtk_icon_theme_set_screen</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<code><a href="http://library.gnome.org/devel/gdk3/GdkScreen.html">GdkScreen</a> *screen</code>);

<code><a href="../gdk2/GdkScreen.html">GdkScreen</a> *screen</code>);

#define <a class="link" href="GtkIconTheme.html#gtk-icon-theme-set-search-path" title="gtk_icon_theme_set_search_path">gtk_icon_theme_set_search_path</a>

#define <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-search-path" title="gtk_icon_theme_get_search_path">gtk_icon_theme_get_search_path</a>

#define <a class="link" href="GtkIconTheme.html#gtk-icon-theme-append-search-path" title="gtk_icon_theme_append_search_path">gtk_icon_theme_append_search_path</a>

#define <a class="link" href="GtkIconTheme.html#gtk-icon-theme-prepend-search-path" title="gtk_icon_theme_prepend_search_path">gtk_icon_theme_prepend_search_path</a>

void <a class="link" href="GtkIconTheme.html#gtk-icon-theme-set-custom-theme" title="gtk_icon_theme_set_custom_theme ()">gtk_icon_theme_set_custom_theme</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *theme_name</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkIconTheme.html#gtk-icon-theme-has-icon" title="gtk_icon_theme_has_icon ()">gtk_icon_theme_has_icon</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *icon_name</code>);

<code>const gchar *theme_name</code>);

gboolean <a class="link" href="GtkIconTheme.html#gtk-icon-theme-has-icon" title="gtk_icon_theme_has_icon ()">gtk_icon_theme_has_icon</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<code>const gchar *icon_name</code>);

<a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()">gtk_icon_theme_lookup_icon</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *icon_name</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> size</code>,

<code>const gchar *icon_name</code>,

<code>gint size</code>,

<code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags">GtkIconLookupFlags</a> flags</code>);

<a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-choose-icon" title="gtk_icon_theme_choose_icon ()">gtk_icon_theme_choose_icon</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *icon_names[]</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> size</code>,

<code>const gchar *icon_names[]</code>,

<code>gint size</code>,

<code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags">GtkIconLookupFlags</a> flags</code>);

<a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-by-gicon" title="gtk_icon_theme_lookup_by_gicon ()">gtk_icon_theme_lookup_by_gicon</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<code><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html">GIcon</a> *icon</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> size</code>,

<code>GIcon *icon</code>,

<code>gint size</code>,

<code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags">GtkIconLookupFlags</a> flags</code>);

<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-load-icon" title="gtk_icon_theme_load_icon ()">gtk_icon_theme_load_icon</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *icon_name</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> size</code>,

<code>const gchar *icon_name</code>,

<code>gint size</code>,

<code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags">GtkIconLookupFlags</a> flags</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-list-contexts" title="gtk_icon_theme_list_contexts ()">gtk_icon_theme_list_contexts</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-list-icons" title="gtk_icon_theme_list_icons ()">gtk_icon_theme_list_icons</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *context</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-icon-sizes" title="gtk_icon_theme_get_icon_sizes ()">gtk_icon_theme_get_icon_sizes</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *icon_name</code>);

<code>GError **error</code>);

GList * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-list-contexts" title="gtk_icon_theme_list_contexts ()">gtk_icon_theme_list_contexts</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>);

GList * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-list-icons" title="gtk_icon_theme_list_icons ()">gtk_icon_theme_list_icons</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<code>const gchar *context</code>);

gint * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-icon-sizes" title="gtk_icon_theme_get_icon_sizes ()">gtk_icon_theme_get_icon_sizes</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<code>const gchar *icon_name</code>);

char * <a class="link" href="GtkIconTheme.html#gtk-icon-theme-get-example-icon-name" title="gtk_icon_theme_get_example_icon_name ()">gtk_icon_theme_get_example_icon_name</a>

(<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkIconTheme.html#gtk-icon-theme-rescan-if-needed" title="gtk_icon_theme_rescan_if_needed ()">gtk_icon_theme_rescan_if_needed</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>);

void <a class="link" href="GtkIconTheme.html#gtk-icon-theme-add-builtin-icon" title="gtk_icon_theme_add_builtin_icon ()">gtk_icon_theme_add_builtin_icon</a> (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *icon_name</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> size</code>,

gboolean <a class="link" href="GtkIconTheme.html#gtk-icon-theme-rescan-if-needed" title="gtk_icon_theme_rescan_if_needed ()">gtk_icon_theme_rescan_if_needed</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>);

void <a class="link" href="GtkIconTheme.html#gtk-icon-theme-add-builtin-icon" title="gtk_icon_theme_add_builtin_icon ()">gtk_icon_theme_add_builtin_icon</a> (<code>const gchar *icon_name</code>,

<code>gint size</code>,

<code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> *pixbuf</code>);

<a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-copy" title="gtk_icon_info_copy ()">gtk_icon_info_copy</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>);

void <a class="link" href="GtkIconTheme.html#gtk-icon-info-free" title="gtk_icon_info_free ()">gtk_icon_info_free</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>);

<a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-new-for-pixbuf" title="gtk_icon_info_new_for_pixbuf ()">gtk_icon_info_new_for_pixbuf</a> (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-base-size" title="gtk_icon_info_get_base_size ()">gtk_icon_info_get_base_size</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>);

gint <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-base-size" title="gtk_icon_info_get_base_size ()">gtk_icon_info_get_base_size</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>);

#define <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-filename" title="gtk_icon_info_get_filename">gtk_icon_info_get_filename</a>

<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-builtin-pixbuf" title="gtk_icon_info_get_builtin_pixbuf ()">gtk_icon_info_get_builtin_pixbuf</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>);

100

<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-load-icon" title="gtk_icon_info_load_icon ()">gtk_icon_info_load_icon</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>,

101

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

101

<code>GError **error</code>);

102

void <a class="link" href="GtkIconTheme.html#gtk-icon-info-set-raw-coordinates" title="gtk_icon_info_set_raw_coordinates ()">gtk_icon_info_set_raw_coordinates</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>,

103

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> raw_coordinates</code>);

104

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-embedded-rect" title="gtk_icon_info_get_embedded_rect ()">gtk_icon_info_get_embedded_rect</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>,

105

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *rectangle</code>);

106

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-attach-points" title="gtk_icon_info_get_attach_points ()">gtk_icon_info_get_attach_points</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>,

107

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Points-Rectangles-and-Regions.html#GdkPoint">GdkPoint</a> **points</code>,

108

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *n_points</code>);

109

const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-display-name" title="gtk_icon_info_get_display_name ()">gtk_icon_info_get_display_name</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>);

103

<code>gboolean raw_coordinates</code>);

104

gboolean <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-embedded-rect" title="gtk_icon_info_get_embedded_rect ()">gtk_icon_info_get_embedded_rect</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>,

105

<code><a href="../gdk2/gdk2-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *rectangle</code>);

106

gboolean <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-attach-points" title="gtk_icon_info_get_attach_points ()">gtk_icon_info_get_attach_points</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>,

107

<code><a href="../gdk2/gdk2-Points-Rectangles-and-Regions.html#GdkPoint">GdkPoint</a> **points</code>,

108

<code>gint *n_points</code>);

109

const gchar * <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-display-name" title="gtk_icon_info_get_display_name ()">gtk_icon_info_get_display_name</a> (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>);

110

</pre>

111

</div>

112

113

<a name="GtkIconTheme.object-hierarchy"></a><h2>Object Hierarchy</h2>

114

115

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

115

GObject

116

+----GtkIconTheme

117

</pre>

118

</div>

119

120

<a name="GtkIconTheme.signals"></a><h2>Signals</h2>

121

122

"<a class="link" href="GtkIconTheme.html#GtkIconTheme-changed" title='The "changed" signal'>changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>

122

"<a class="link" href="GtkIconTheme.html#GtkIconTheme-changed" title='The "changed" signal'>changed</a>" : <code class="literal">Run Last</code>

123

</pre>

124

</div>

125

137

installed as operating system vendors and users choose.

138

139

140

Named icons are similar to the <a class="xref" href="gtk-Themeable-Stock-Images.html" title="Themeable Stock Images"><a name="gtk-Themeable-Stock-Images.top_of_page"></a>Themeable Stock Images(3)</a>

140

Named icons are similar to the <a class="xref" href="">???</a>

141

facility, and the distinction between the two may be a bit confusing.

142

A few things to keep in mind:

143

144

145

146

Stock images usually are used in conjunction with

147

<a class="xref" href="gtk-Stock-Items.html" title="Stock Items"><a name="gtk-Stock-Items.top_of_page"></a>Stock Items(3)</a>., such as <a class="link" href="gtk-Stock-Items.html#GTK-STOCK-OK:CAPS" title="GTK_STOCK_OK"><code class="literal">GTK_STOCK_OK</code></a> or

148

<a class="link" href="gtk-Stock-Items.html#GTK-STOCK-OPEN:CAPS" title="GTK_STOCK_OPEN"><code class="literal">GTK_STOCK_OPEN</code></a>. Named icons are easier to set up and therefore

147

<a class="xref" href="">???</a>., such as <a class="link" href="gtk2-Stock-Items.html#GTK-STOCK-OK:CAPS" title="GTK_STOCK_OK"><code class="literal">GTK_STOCK_OK</code></a> or

148

<a class="link" href="gtk2-Stock-Items.html#GTK-STOCK-OPEN:CAPS" title="GTK_STOCK_OPEN"><code class="literal">GTK_STOCK_OPEN</code></a>. Named icons are easier to set up and therefore

149

are more useful for new icons that an application wants to

150

add, such as application icons or window icons.

151

</li>

152

153

Stock images can only be loaded at the symbolic sizes defined

154

by the <a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize">GtkIconSize</a> enumeration, or by custom sizes defined

155

by <a class="link" href="gtk-Themeable-Stock-Images.html#gtk-icon-size-register" title="gtk_icon_size_register ()"><code class="function">gtk_icon_size_register()</code></a>, while named icons are more flexible

154

by the <a class="link" href="gtk2-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize">GtkIconSize</a> enumeration, or by custom sizes defined

155

by <a class="link" href="gtk2-Themeable-Stock-Images.html#gtk-icon-size-register" title="gtk_icon_size_register ()"><code class="function">gtk_icon_size_register()</code></a>, while named icons are more flexible

156

and any pixel size can be specified.

157

</li>

158

177

directly is also simple. The <a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> object acts

178

as a database of all the icons in the current theme. You

179

can create new <a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> objects, but its much more

180

efficient to use the standard icon theme for the <a href="http://library.gnome.org/devel/gdk3/GdkScreen.html">GdkScreen</a>

180

efficient to use the standard icon theme for the <a href="../gdk2/GdkScreen.html">GdkScreen</a>

181

so that the icon information is shared with other people

182

looking up icons. In the case where the default screen is

183

being used, looking up an icon can be as simple as:

205

206

207

19</pre></td>

208

<td class="listing_code"><pre class="programlisting">GError *error = <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>;

208

<td class="listing_code"><pre class="programlisting">GError *error = <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a>;

209

GtkIconTheme *icon_theme;

210

GdkPixbuf *pixbuf;

211

icon_theme = <a href="GtkIconTheme.html#gtk-icon-theme-get-default">gtk_icon_theme_get_default</a> ();

216

&error);

217

if (!pixbuf)

218

{

219

<a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-warning">g_warning</a> ("Couldn't load icon: %s", error->message);

220

<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#g-error-free">g_error_free</a> (error);

219

g_warning ("Couldn't load icon: %s", error->message);

220

g_error_free (error);

221

}

222

else

223

{

224

/* Use the pixbuf */

225

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a> (pixbuf);

225

g_object_unref (pixbuf);

226

}</pre></td>

227

</tr>

228

</tbody>

265

GTK_ICON_LOOKUP_FORCE_SIZE = 1 << 4

266

} GtkIconLookupFlags;

267

</pre>

268

269

Used to specify options for <a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()"><code class="function">gtk_icon_theme_lookup_icon()</code></a>

270

268

271

269

272

270

273

289

292

<td>When passed to

290

293

<a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()"><code class="function">gtk_icon_theme_lookup_icon()</code></a> includes builtin icons

291

294

as well as files. For a builtin icon, <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-filename" title="gtk_icon_info_get_filename"><code class="function">gtk_icon_info_get_filename()</code></a>

295

returns <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> and you need to call <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-builtin-pixbuf" title="gtk_icon_info_get_builtin_pixbuf ()"><code class="function">gtk_icon_info_get_builtin_pixbuf()</code></a>.

292

296

</td>

293

297

</tr>

294

298

<tr>

295

299

<td><a name="GTK-ICON-LOOKUP-GENERIC-FALLBACK:CAPS"></a><code class="literal">GTK_ICON_LOOKUP_GENERIC_FALLBACK</code></td>

296

<td>

300

<td>Try to shorten icon name at '-'

301

characters before looking at inherited themes. For more general

302

fallback, see <a class="link" href="GtkIconTheme.html#gtk-icon-theme-choose-icon" title="gtk_icon_theme_choose_icon ()"><code class="function">gtk_icon_theme_choose_icon()</code></a>. Since 2.12.

297

303

</td>

298

304

</tr>

299

305

<tr>

300

306

<td><a name="GTK-ICON-LOOKUP-FORCE-SIZE:CAPS"></a><code class="literal">GTK_ICON_LOOKUP_FORCE_SIZE</code></td>

301

<td>

307

<td>Always return the icon scaled to the

308

requested size. Since 2.14.

302

309

</td>

303

310

</tr>

304

311

</tbody>

310

317

<pre class="programlisting">#define GTK_ICON_THEME_ERROR gtk_icon_theme_error_quark ()

311

318

</pre>

312

319

313

The <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> used for <a class="link" href="GtkIconTheme.html#GtkIconThemeError" title="enum GtkIconThemeError">GtkIconThemeError</a> errors.

320

The GQuark used for <a class="link" href="GtkIconTheme.html#GtkIconThemeError" title="enum GtkIconThemeError">GtkIconThemeError</a> errors.

314

321

315

322

</div>

316

323

<hr>

393

400

<hr>

394

401

395

402

<a name="gtk-icon-theme-get-for-screen"></a><h3>gtk_icon_theme_get_for_screen ()</h3>

396

<pre class="programlisting"><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> * gtk_icon_theme_get_for_screen (<code><a href="http://library.gnome.org/devel/gdk3/GdkScreen.html">GdkScreen</a> *screen</code>);</pre>

403

<pre class="programlisting"><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> * gtk_icon_theme_get_for_screen (<code><a href="../gdk2/GdkScreen.html">GdkScreen</a> *screen</code>);</pre>

397

404

398

405

Gets the icon theme object associated with <code>screen</code>; if this

399

406

function has not previously been called for the given

412

419

<tbody>

413

420

<tr>

414

421

<td><code>screen</code> :</td>

415

<td>a <a href="http://library.gnome.org/devel/gdk3/GdkScreen.html">GdkScreen</a>

422

<td>a <a href="../gdk2/GdkScreen.html">GdkScreen</a>

416

423

</td>

417

424

</tr>

418

425

<tr>

431

438

432

439

<a name="gtk-icon-theme-set-screen"></a><h3>gtk_icon_theme_set_screen ()</h3>

433

440

<pre class="programlisting">void gtk_icon_theme_set_screen (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

434

<code><a href="http://library.gnome.org/devel/gdk3/GdkScreen.html">GdkScreen</a> *screen</code>);</pre>

441

<code><a href="../gdk2/GdkScreen.html">GdkScreen</a> *screen</code>);</pre>

435

442

436

443

Sets the screen for an icon theme; the screen is used

437

444

to track the user's currently configured icon theme,

450

457

</tr>

451

458

<tr>

452

459

<td><code>screen</code> :</td>

453

<td>a <a href="http://library.gnome.org/devel/gdk3/GdkScreen.html">GdkScreen</a>

460

<td>a <a href="../gdk2/GdkScreen.html">GdkScreen</a>

454

461

</td>

455

462

</tr>

456

463

</tbody>

525

532

</tr>

526

533

<tr>

527

534

528

<td>(array length=n_elements) (out): location to store a list of icon theme path directories or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

529

The stored value should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

535

<td>(array length=n_elements) (out): location to store a list of icon theme path directories or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>

536

The stored value should be freed with <code class="function">g_strfreev()</code>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

530

537

</td>

531

538

</tr>

532

539

<tr>

533

540

<td><code>n_elements</code> :</td>

534

541

<td>location to store number of elements

535

in <code>path</code>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

542

in <code>path</code>, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>

536

543

</td>

537

544

</tr>

538

545

</tbody>

599

606

600

607

<a name="gtk-icon-theme-set-custom-theme"></a><h3>gtk_icon_theme_set_custom_theme ()</h3>

601

608

<pre class="programlisting">void gtk_icon_theme_set_custom_theme (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

602

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *theme_name</code>);</pre>

609

<code>const gchar *theme_name</code>);</pre>

603

610

604

611

Sets the name of the icon theme that the <a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> object uses

605

612

overriding system configuration. This function cannot be called

620

627

<tr>

621

628

<td><code>theme_name</code> :</td>

622

629

<td>name of icon theme to use instead of configured theme,

623

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset a previously set custom theme</td>

630

or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset a previously set custom theme</td>

624

631

</tr>

625

632

</tbody>

626

633

</table></div>

629

636

<hr>

630

637

631

638

<a name="gtk-icon-theme-has-icon"></a><h3>gtk_icon_theme_has_icon ()</h3>

632

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_icon_theme_has_icon (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

633

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *icon_name</code>);</pre>

639

<pre class="programlisting">gboolean gtk_icon_theme_has_icon (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

640

<code>const gchar *icon_name</code>);</pre>

634

641

635

642

Checks whether an icon theme includes an icon

636

643

for a particular name.

653

660

<tr>

654

661

<td>Returns :</td>

655

662

<td>

656

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <code>icon_theme</code> includes an

663

<code class="literal">TRUE</code> if <code>icon_theme</code> includes an

657

664

icon for <code>icon_name</code>.</td>

658

665

</tr>

659

666

</tbody>

664

671

665

672

<a name="gtk-icon-theme-lookup-icon"></a><h3>gtk_icon_theme_lookup_icon ()</h3>

666

673

<pre class="programlisting"><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> * gtk_icon_theme_lookup_icon (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

667

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *icon_name</code>,

668

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> size</code>,

674

<code>const gchar *icon_name</code>,

675

<code>gint size</code>,

669

676

<code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags">GtkIconLookupFlags</a> flags</code>);</pre>

670

677

671

678

Looks up a named icon and returns a structure containing

700

707

<tr>

701

708

<td>Returns :</td>

702

709

<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> structure containing information

703

about the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the icon wasn't found. Free with

710

about the icon, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if the icon wasn't found. Free with

704

711

705

712

</td>

706

713

</tr>

712

719

713

720

<a name="gtk-icon-theme-choose-icon"></a><h3>gtk_icon_theme_choose_icon ()</h3>

714

721

<pre class="programlisting"><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> * gtk_icon_theme_choose_icon (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

715

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *icon_names[]</code>,

716

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> size</code>,

722

<code>const gchar *icon_names[]</code>,

723

<code>gint size</code>,

717

724

<code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags">GtkIconLookupFlags</a> flags</code>);</pre>

718

725

719

726

Looks up a named icon and returns a structure containing

741

748

<tr>

742

749

<td><code>icon_names</code> :</td>

743

750

<td>

744

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of

751

<a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of

745

752

icon names to lookup. [<acronym title="Parameter points to an array of items.">array</acronym> zero-terminated=1]

746

753

</td>

747

754

</tr>

756

763

<tr>

757

764

<td>Returns :</td>

758

765

<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> structure containing information

759

about the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the icon wasn't found. Free with

766

about the icon, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if the icon wasn't found. Free with

760

767

761

768

</td>

762

769

</tr>

768

775

769

776

<a name="gtk-icon-theme-lookup-by-gicon"></a><h3>gtk_icon_theme_lookup_by_gicon ()</h3>

770

777

<pre class="programlisting"><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> * gtk_icon_theme_lookup_by_gicon (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

771

<code><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html">GIcon</a> *icon</code>,

772

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> size</code>,

778

<code>GIcon *icon</code>,

779

<code>gint size</code>,

773

780

<code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags">GtkIconLookupFlags</a> flags</code>);</pre>

774

781

775

782

Looks up an icon and returns a structure containing

790

797

</tr>

791

798

<tr>

792

799

793

<td>the <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html">GIcon</a> to look up</td>

800

<td>the GIcon to look up</td>

794

801

</tr>

795

802

<tr>

796

803

803

810

<tr>

804

811

<td>Returns :</td>

805

812

<td>a <a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> structure containing

806

information about the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the icon

813

information about the icon, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if the icon

807

814

wasn't found. Free with <a class="link" href="GtkIconTheme.html#gtk-icon-info-free" title="gtk_icon_info_free ()"><code class="function">gtk_icon_info_free()</code></a>

808

815

</td>

809

816

</tr>

815

822

816

823

<a name="gtk-icon-theme-load-icon"></a><h3>gtk_icon_theme_load_icon ()</h3>

817

824

<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * gtk_icon_theme_load_icon (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

818

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *icon_name</code>,

819

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> size</code>,

825

<code>const gchar *icon_name</code>,

826

<code>gint size</code>,

820

827

<code><a class="link" href="GtkIconTheme.html#GtkIconLookupFlags" title="enum GtkIconLookupFlags">GtkIconLookupFlags</a> flags</code>,

821

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

828

<code>GError **error</code>);</pre>

822

829

823

830

Looks up an icon in an icon theme, scales it to the given size

824

831

and renders it into a pixbuf. This is a convenience function;

860

867

</tr>

861

868

<tr>

862

869

<td><code>error</code> :</td>

863

<td>Location to store error information on failure, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

870

<td>Location to store error information on failure, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

864

871

</td>

865

872

</tr>

866

873

<tr>

867

874

<td>Returns :</td>

868

875

<td>the rendered icon; this may be a newly

869

876

created icon or a new reference to an internal icon, so you must not modify

870

the icon. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release your reference to the

871

icon. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the icon isn't found. [<acronym title="Free data after the code is done.">transfer full</acronym>]

877

the icon. Use <code class="function">g_object_unref()</code> to release your reference to the

878

icon. <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if the icon isn't found. [<acronym title="Free data after the code is done.">transfer full</acronym>]

872

879

</td>

873

880

</tr>

874

881

</tbody>

878

885

<hr>

879

886

880

887

<a name="gtk-icon-theme-list-contexts"></a><h3>gtk_icon_theme_list_contexts ()</h3>

881

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> * gtk_icon_theme_list_contexts (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>);</pre>

888

<pre class="programlisting">GList * gtk_icon_theme_list_contexts (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>);</pre>

882

889

883

890

Gets the list of contexts available within the current

884

891

hierarchy of icon themes

896

903

</tr>

897

904

<tr>

898

905

<td>Returns :</td>

899

<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> list holding the names of all the

906

<td>a GList list holding the names of all the

900

907

contexts in the theme. You must first free each element

901

in the list with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>, then free the list itself

902

with <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>. [<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> utf8][<acronym title="Free data after the code is done.">transfer full</acronym>]

908

in the list with <code class="function">g_free()</code>, then free the list itself

909

with <code class="function">g_list_free()</code>. [<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> utf8][<acronym title="Free data after the code is done.">transfer full</acronym>]

903

910

</td>

904

911

</tr>

905

912

</tbody>

909

916

<hr>

910

917

911

918

<a name="gtk-icon-theme-list-icons"></a><h3>gtk_icon_theme_list_icons ()</h3>

912

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> * gtk_icon_theme_list_icons (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

913

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *context</code>);</pre>

919

<pre class="programlisting">GList * gtk_icon_theme_list_icons (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

920

<code>const gchar *context</code>);</pre>

914

921

915

922

Lists the icons in the current icon theme. Only a subset

916

923

of the icons can be listed by providing a context string.

932

939

<tr>

933

940

<td><code>context</code> :</td>

934

941

<td>a string identifying a particular type of icon,

935

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to list all icons.</td>

942

or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> to list all icons.</td>

936

943

</tr>

937

944

<tr>

938

945

<td>Returns :</td>

939

<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> list

946

<td>a GList list

940

947

holding the names of all the icons in the theme. You must first

941

free each element in the list with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>, then free the list

942

itself with <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>. [<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> utf8][<acronym title="Free data after the code is done.">transfer full</acronym>]

948

free each element in the list with <code class="function">g_free()</code>, then free the list

949

itself with <code class="function">g_list_free()</code>. [<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> utf8][<acronym title="Free data after the code is done.">transfer full</acronym>]

943

950

</td>

944

951

</tr>

945

952

</tbody>

949

956

<hr>

950

957

951

958

<a name="gtk-icon-theme-get-icon-sizes"></a><h3>gtk_icon_theme_get_icon_sizes ()</h3>

952

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> * gtk_icon_theme_get_icon_sizes (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

953

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *icon_name</code>);</pre>

959

<pre class="programlisting">gint * gtk_icon_theme_get_icon_sizes (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>,

960

<code>const gchar *icon_name</code>);</pre>

954

961

955

962

Returns an array of integers describing the sizes at which

956

963

the icon is available without scaling. A size of -1 means

976

983

<td>Returns :</td>

977

984

<td>An newly allocated array

978

985

describing the sizes at which the icon is available. The array

979

should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when it is no longer needed. [<acronym title="Parameter points to an array of items.">array</acronym> zero-terminated=1]

986

should be freed with <code class="function">g_free()</code> when it is no longer needed. [<acronym title="Parameter points to an array of items.">array</acronym> zero-terminated=1]

980

987

</td>

981

988

</tr>

982

989

</tbody>

1006

1013

</tr>

1007

1014

<tr>

1008

1015

<td>Returns :</td>

1009

<td>the name of an example icon or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

1010

Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>

1016

<td>the name of an example icon or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.

1017

Free with <code class="function">g_free()</code>.</td>

1011

1018

</tr>

1012

1019

</tbody>

1013

1020

</table></div>

1016

1023

<hr>

1017

1024

1018

1025

<a name="gtk-icon-theme-rescan-if-needed"></a><h3>gtk_icon_theme_rescan_if_needed ()</h3>

1019

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_icon_theme_rescan_if_needed (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>);</pre>

1026

<pre class="programlisting">gboolean gtk_icon_theme_rescan_if_needed (<code><a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme</code>);</pre>

1020

1027

1021

1028

Checks to see if the icon theme has changed; if it has, any

1022

1029

currently cached information is discarded and will be reloaded

1036

1043

<tr>

1037

1044

<td>Returns :</td>

1038

1045

<td>

1039

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the icon theme has changed and needed

1046

<code class="literal">TRUE</code> if the icon theme has changed and needed

1040

1047

to be reloaded.</td>

1041

1048

</tr>

1042

1049

</tbody>

1046

1053

<hr>

1047

1054

1048

1055

<a name="gtk-icon-theme-add-builtin-icon"></a><h3>gtk_icon_theme_add_builtin_icon ()</h3>

1049

<pre class="programlisting">void gtk_icon_theme_add_builtin_icon (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *icon_name</code>,

1050

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> size</code>,

1056

<pre class="programlisting">void gtk_icon_theme_add_builtin_icon (<code>const gchar *icon_name</code>,

1057

<code>gint size</code>,

1051

1058

1052

1059

1053

1060

Registers a built-in icon for icon theme lookups. The idea

1174

1181

<hr>

1175

1182

1176

1183

1177

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> gtk_icon_info_get_base_size (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>);</pre>

1184

<pre class="programlisting">gint gtk_icon_info_get_base_size (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>);</pre>

1178

1185

1179

1186

Gets the base size for the icon. The base size

1180

1187

is a size for the icon that was specified by

1224

1231

</colgroup>

1225

1232

1226

1233

<td>Returns :</td>

1227

<td>the filename for the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1234

<td>the filename for the icon, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>

1228

1235

if <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-builtin-pixbuf" title="gtk_icon_info_get_builtin_pixbuf ()"><code class="function">gtk_icon_info_get_builtin_pixbuf()</code></a> should

1229

1236

be used instead. The return value is owned by

1230

1237

GTK+ and should not be modified or freed.</td>

1254

1261

</tr>

1255

1262

<tr>

1256

1263

<td>Returns :</td>

1257

<td>the built-in image pixbuf, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. No

1264

<td>the built-in image pixbuf, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. No

1258

1265

extra reference is added to the returned pixbuf, so if

1259

you want to keep it around, you must use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>.

1266

you want to keep it around, you must use <code class="function">g_object_ref()</code>.

1260

1267

The returned image must not be modified. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1261

1268

</td>

1262

1269

</tr>

1268

1275

1269

1276

1270

1277

<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * gtk_icon_info_load_icon (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>,

1271

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

1278

<code>GError **error</code>);</pre>

1272

1279

1273

1280

Renders an icon previously looked up in an icon theme using

1274

1281

<a class="link" href="GtkIconTheme.html#gtk-icon-theme-lookup-icon" title="gtk_icon_theme_lookup_icon ()"><code class="function">gtk_icon_theme_lookup_icon()</code></a>; the size will be based on the size

1296

1303

<tr>

1297

1304

<td><code>error</code> :</td>

1298

1305

<td>location to store error information on failure,

1299

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1306

or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1300

1307

</td>

1301

1308

</tr>

1302

1309

<tr>

1303

1310

<td>Returns :</td>

1304

1311

<td>the rendered icon; this may be a newly

1305

1312

created icon or a new reference to an internal icon, so you must

1306

not modify the icon. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release your reference

1313

not modify the icon. Use <code class="function">g_object_unref()</code> to release your reference

1307

1314

to the icon. [<acronym title="Free data after the code is done.">transfer full</acronym>]

1308

1315

</td>

1309

1316

</tr>

1315

1322

1316

1323

<a name="gtk-icon-info-set-raw-coordinates"></a><h3>gtk_icon_info_set_raw_coordinates ()</h3>

1317

1324

<pre class="programlisting">void gtk_icon_info_set_raw_coordinates (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>,

1318

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> raw_coordinates</code>);</pre>

1325

<code>gboolean raw_coordinates</code>);</pre>

1319

1326

1320

1327

Sets whether the coordinates returned by <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-embedded-rect" title="gtk_icon_info_get_embedded_rect ()"><code class="function">gtk_icon_info_get_embedded_rect()</code></a>

1321

1328

and <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-attach-points" title="gtk_icon_info_get_attach_points ()"><code class="function">gtk_icon_info_get_attach_points()</code></a> should be returned in their

1327

1334

respect to the unscaled pixmap for PNG and XPM icons, but for SVG

1328

1335

icons, they are in a 1000x1000 coordinate space that is scaled

1329

1336

to the final size of the icon. You can determine if the icon is an SVG

1330

icon by using <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-filename" title="gtk_icon_info_get_filename"><code class="function">gtk_icon_info_get_filename()</code></a>, and seeing if it is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1337

icon by using <a class="link" href="GtkIconTheme.html#gtk-icon-info-get-filename" title="gtk_icon_info_get_filename"><code class="function">gtk_icon_info_get_filename()</code></a>, and seeing if it is non-<a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>

1331

1338

and ends in '.svg'.

1332

1339

1333

1340

1358

1365

<hr>

1359

1366

1360

1367

<a name="gtk-icon-info-get-embedded-rect"></a><h3>gtk_icon_info_get_embedded_rect ()</h3>

1361

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_icon_info_get_embedded_rect (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>,

1362

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *rectangle</code>);</pre>

1368

<pre class="programlisting">gboolean gtk_icon_info_get_embedded_rect (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>,

1369

<code><a href="../gdk2/gdk2-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *rectangle</code>);</pre>

1363

1370

1364

1371

Gets the coordinates of a rectangle within the icon

1365

1372

that can be used for display of information such

1381

1388

<tr>

1382

1389

<td><code>rectangle</code> :</td>

1383

1390

<td>

1384

<a href="http://library.gnome.org/devel/gdk3/gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> in which to store embedded

1391

<a href="../gdk2/gdk2-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> in which to store embedded

1385

1392

rectangle coordinates; coordinates are only stored

1386

when this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

1393

when this function returns <code class="literal">TRUE</code>. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

1387

1394

</td>

1388

1395

</tr>

1389

1396

<tr>

1390

1397

<td>Returns :</td>

1391

1398

<td>

1392

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the icon has an embedded rectangle</td>

1399

<code class="literal">TRUE</code> if the icon has an embedded rectangle</td>

1393

1400

</tr>

1394

1401

</tbody>

1395

1402

</table></div>

1398

1405

<hr>

1399

1406

1400

1407

<a name="gtk-icon-info-get-attach-points"></a><h3>gtk_icon_info_get_attach_points ()</h3>

1401

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_icon_info_get_attach_points (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>,

1402

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Points-Rectangles-and-Regions.html#GdkPoint">GdkPoint</a> **points</code>,

1403

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *n_points</code>);</pre>

1408

<pre class="programlisting">gboolean gtk_icon_info_get_attach_points (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>,

1409

<code><a href="../gdk2/gdk2-Points-Rectangles-and-Regions.html#GdkPoint">GdkPoint</a> **points</code>,

1410

<code>gint *n_points</code>);</pre>

1404

1411

1405

1412

Fetches the set of attach points for an icon. An attach point

1406

1413

is a location in the icon that can be used as anchor points for attaching

1419

1426

</tr>

1420

1427

<tr>

1421

1428

<td><code>points</code> :</td>

1422

<td>(array length=n_points) (out): location to store pointer to an array of points, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1423

free the array of points with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1429

<td>(array length=n_points) (out): location to store pointer to an array of points, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>

1430

free the array of points with <code class="function">g_free()</code>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1424

1431

</td>

1425

1432

</tr>

1426

1433

<tr>

1427

1434

<td><code>n_points</code> :</td>

1428

<td>location to store the number of points in <code>points</code>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1435

<td>location to store the number of points in <code>points</code>, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1429

1436

</td>

1430

1437

</tr>

1431

1438

<tr>

1432

1439

<td>Returns :</td>

1433

1440

<td>

1434

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if there are any attach points for the icon.</td>

1441

<code class="literal">TRUE</code> if there are any attach points for the icon.</td>

1435

1442

</tr>

1436

1443

</tbody>

1437

1444

</table></div>

1440

1447

<hr>

1441

1448

1442

1449

<a name="gtk-icon-info-get-display-name"></a><h3>gtk_icon_info_get_display_name ()</h3>

1443

<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * gtk_icon_info_get_display_name (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>);</pre>

1450

<pre class="programlisting">const gchar * gtk_icon_info_get_display_name (<code><a class="link" href="GtkIconTheme.html#GtkIconInfo" title="GtkIconInfo">GtkIconInfo</a> *icon_info</code>);</pre>

1444

1451

1445

1452

Gets the display name for an icon. A display name is a

1446

1453

string to be used in place of the icon name in a user

1459

1466

</tr>

1460

1467

<tr>

1461

1468

<td>Returns :</td>

1462

<td>the display name for the icon or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, if

1469

<td>the display name for the icon or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>, if

1463

1470

the icon doesn't have a specified display name. This value

1464

1471

is owned <code>icon_info</code> and must not be modified or free.</td>

1465

1472

</tr>

1473

1480

1474

1481

<a name="GtkIconTheme-changed"></a><h3>The <code class="literal">"changed"</code> signal</h3>

1475

1482

<pre class="programlisting">void user_function (<a class="link" href="GtkIconTheme.html" title="GtkIconTheme">GtkIconTheme</a> *icon_theme,

1476

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>

1483

gpointer user_data) : <code class="literal">Run Last</code></pre>

1477

1484

1478

1485

Emitted when the current icon theme is switched or GTK+ detects

1479

1486

that a change has occurred in the contents of the current

1500

1507

</div>

1501

1508

1502

1509

<hr>

1503

Generated by GTK-Doc V1.18.1</div>

1510

Generated by GTK-Doc V1.18</div>

1504

1511

</body>

1505

1512

</html>

b'\\ No newline at end of file'

Older »