RubyGems - gdk3 - Versions diffs - 1.2.0-x86-mingw32 - Mend

gdk3 1.2.0-x86-mingw32

Files changed (1337) hide show

data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Themeable-Stock-Images.html ADDED Viewed

@@ -0,0 +1,1730 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Themeable Stock Images</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
+<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
+<link rel="up" href="theming.html" title="Part III. Theming in GTK+">
+<link rel="prev" href="GtkIconTheme.html" title="GtkIconTheme">
+<link rel="next" href="GtkNumerableIcon.html" title="GtkNumerableIcon">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
+<tr valign="middle">
+<td><a accesskey="p" href="GtkIconTheme.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="theming.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GTK+ 3 Reference Manual</th>
+<td><a accesskey="n" href="GtkNumerableIcon.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#gtk3-Themeable-Stock-Images.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#gtk3-Themeable-Stock-Images.description" class="shortcut">Description</a>
+                   |
+                  <a href="#gtk3-Themeable-Stock-Images.object-hierarchy" class="shortcut">Object Hierarchy</a>
+                   |
+                  <a href="#gtk3-Themeable-Stock-Images.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="gtk3-Themeable-Stock-Images"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="gtk3-Themeable-Stock-Images.top_of_page"></a>Themeable Stock Images</span></h2>
+<p>Themeable Stock Images — Manipulating stock icons</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="gtk3-Themeable-Stock-Images.synopsis"></a><h2>Synopsis</h2>
+<a name="GtkIconFactory"></a><a name="GtkIconSet"></a><pre class="synopsis">
+#include &lt;gtk/gtk.h&gt;
+                    <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource">GtkIconSource</a>;
+struct              <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory-struct" title="struct GtkIconFactory">GtkIconFactory</a>;
+                    <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet-struct" title="GtkIconSet">GtkIconSet</a>;
+enum                <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize">GtkIconSize</a>;
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="returnvalue">GtkIconSource</span></a> *     <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-copy" title="gtk_icon_source_copy ()">gtk_icon_source_copy</a>                (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-free" title="gtk_icon_source_free ()">gtk_icon_source_free</a>                (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-add" title="gtk_icon_factory_add ()">gtk_icon_factory_add</a>                (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a> *factory</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-add-default" title="gtk_icon_factory_add_default ()">gtk_icon_factory_add_default</a>        (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a> *factory</code></em>);
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="returnvalue">GtkIconSet</span></a> *        <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-lookup" title="gtk_icon_factory_lookup ()">gtk_icon_factory_lookup</a>             (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a> *factory</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="returnvalue">GtkIconSet</span></a> *        <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-lookup-default" title="gtk_icon_factory_lookup_default ()">gtk_icon_factory_lookup_default</a>     (<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="returnvalue">GtkIconFactory</span></a> *    <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-new" title="gtk_icon_factory_new ()">gtk_icon_factory_new</a>                (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-remove-default" title="gtk_icon_factory_remove_default ()">gtk_icon_factory_remove_default</a>     (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a> *factory</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-add-source" title="gtk_icon_set_add_source ()">gtk_icon_set_add_source</a>             (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>,
+                                                         <em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="returnvalue">GtkIconSet</span></a> *        <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-copy" title="gtk_icon_set_copy ()">gtk_icon_set_copy</a>                   (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>);
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="returnvalue">GtkIconSet</span></a> *        <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-new" title="gtk_icon_set_new ()">gtk_icon_set_new</a>                    (<em class="parameter"><code><span class="type">void</span></code></em>);
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="returnvalue">GtkIconSet</span></a> *        <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-new-from-pixbuf" title="gtk_icon_set_new_from_pixbuf ()">gtk_icon_set_new_from_pixbuf</a>        (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="returnvalue">GtkIconSet</span></a> *        <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-ref" title="gtk_icon_set_ref ()">gtk_icon_set_ref</a>                    (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>);
+<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-render-icon" title="gtk_icon_set_render_icon ()">gtk_icon_set_render_icon</a>            (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> *style</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkTextDirection" title="enum GtkTextDirection"><span class="type">GtkTextDirection</span></a> direction</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> state</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *detail</code></em>);
+<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-render-icon-pixbuf" title="gtk_icon_set_render_icon_pixbuf ()">gtk_icon_set_render_icon_pixbuf</a>     (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-unref" title="gtk_icon_set_unref ()">gtk_icon_set_unref</a>                  (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-size-lookup" title="gtk_icon_size_lookup ()">gtk_icon_size_lookup</a>                (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *width</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *height</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-size-lookup-for-settings" title="gtk_icon_size_lookup_for_settings ()">gtk_icon_size_lookup_for_settings</a>   (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *width</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *height</code></em>);
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>         <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-size-register" title="gtk_icon_size_register ()">gtk_icon_size_register</a>              (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> width</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> height</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-size-register-alias" title="gtk_icon_size_register_alias ()">gtk_icon_size_register_alias</a>        (<em class="parameter"><code>const <span class="type">gchar</span> *alias</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> target</code></em>);
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>         <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-size-from-name" title="gtk_icon_size_from_name ()">gtk_icon_size_from_name</a>             (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);
+const <span class="returnvalue">gchar</span> *       <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-size-get-name" title="gtk_icon_size_get_name ()">gtk_icon_size_get_name</a>              (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-get-sizes" title="gtk_icon_set_get_sizes ()">gtk_icon_set_get_sizes</a>              (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> **sizes</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *n_sizes</code></em>);
+<a class="link" href="GtkWidget.html#GtkTextDirection" title="enum GtkTextDirection"><span class="returnvalue">GtkTextDirection</span></a>    <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-get-direction" title="gtk_icon_source_get_direction ()">gtk_icon_source_get_direction</a>       (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-get-direction-wildcarded" title="gtk_icon_source_get_direction_wildcarded ()">gtk_icon_source_get_direction_wildcarded</a>
+                                                        (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);
+const <span class="returnvalue">gchar</span> *       <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-get-filename" title="gtk_icon_source_get_filename ()">gtk_icon_source_get_filename</a>        (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);
+<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-get-pixbuf" title="gtk_icon_source_get_pixbuf ()">gtk_icon_source_get_pixbuf</a>          (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);
+const <span class="returnvalue">gchar</span> *       <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-get-icon-name" title="gtk_icon_source_get_icon_name ()">gtk_icon_source_get_icon_name</a>       (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>         <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-get-size" title="gtk_icon_source_get_size ()">gtk_icon_source_get_size</a>            (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-get-size-wildcarded" title="gtk_icon_source_get_size_wildcarded ()">gtk_icon_source_get_size_wildcarded</a> (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);
+<a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="returnvalue">GtkStateType</span></a>        <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-get-state" title="gtk_icon_source_get_state ()">gtk_icon_source_get_state</a>           (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-get-state-wildcarded" title="gtk_icon_source_get_state_wildcarded ()">gtk_icon_source_get_state_wildcarded</a>
+                                                        (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="returnvalue">GtkIconSource</span></a> *     <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-new" title="gtk_icon_source_new ()">gtk_icon_source_new</a>                 (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-direction" title="gtk_icon_source_set_direction ()">gtk_icon_source_set_direction</a>       (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkTextDirection" title="enum GtkTextDirection"><span class="type">GtkTextDirection</span></a> direction</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-direction-wildcarded" title="gtk_icon_source_set_direction_wildcarded ()">gtk_icon_source_set_direction_wildcarded</a>
+                                                        (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-filename" title="gtk_icon_source_set_filename ()">gtk_icon_source_set_filename</a>        (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-pixbuf" title="gtk_icon_source_set_pixbuf ()">gtk_icon_source_set_pixbuf</a>          (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-icon-name" title="gtk_icon_source_set_icon_name ()">gtk_icon_source_set_icon_name</a>       (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-size" title="gtk_icon_source_set_size ()">gtk_icon_source_set_size</a>            (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-size-wildcarded" title="gtk_icon_source_set_size_wildcarded ()">gtk_icon_source_set_size_wildcarded</a> (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-state" title="gtk_icon_source_set_state ()">gtk_icon_source_set_state</a>           (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> state</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-state-wildcarded" title="gtk_icon_source_set_state_wildcarded ()">gtk_icon_source_set_state_wildcarded</a>
+                                                        (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="gtk3-Themeable-Stock-Images.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="synopsis">
+  GObject
+   +----GtkIconFactory
+</pre>
+<pre class="synopsis">
+  GBoxed
+   +----GtkIconSet
+</pre>
+</div>
+<div class="refsect1">
+<a name="gtk3-Themeable-Stock-Images.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
+<p>
+GtkIconFactory implements
+ <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
+</div>
+<div class="refsect1">
+<a name="gtk3-Themeable-Stock-Images.description"></a><h2>Description</h2>
+<p>
+Browse the available stock icons in the list of stock IDs found here. You can also use
+the <span class="application">gtk-demo</span> application for this purpose.
+</p>
+<p>
+An icon factory manages a collection of <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>; a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> manages a
+set of variants of a particular icon (i.e. a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> contains variants for
+different sizes and widget states). Icons in an icon factory are named by a
+stock ID, which is a simple string identifying the icon. Each <a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> has a
+list of <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a> derived from the current theme; those icon factories
+are consulted first when searching for an icon. If the theme doesn't set a
+particular icon, GTK+ looks for the icon in a list of default icon factories,
+maintained by <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-add-default" title="gtk_icon_factory_add_default ()"><code class="function">gtk_icon_factory_add_default()</code></a> and
+<a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-remove-default" title="gtk_icon_factory_remove_default ()"><code class="function">gtk_icon_factory_remove_default()</code></a>. Applications with icons should add a default
+icon factory with their icons, which will allow themes to override the icons
+for the application.
+</p>
+<p>
+To display an icon, always use <a class="link" href="GtkStyle.html#gtk-style-lookup-icon-set" title="gtk_style_lookup_icon_set ()"><code class="function">gtk_style_lookup_icon_set()</code></a> on the widget that
+will display the icon, or the convenience function
+<a class="link" href="GtkWidget.html#gtk-widget-render-icon" title="gtk_widget_render_icon ()"><code class="function">gtk_widget_render_icon()</code></a>. These functions take the theme into account when
+looking up the icon to use for a given stock ID.
+</p>
+<p>
+</p>
+<div class="refsect2">
+<a name="GtkIconFactory-BUILDER-UI"></a><h3>GtkIconFactory as GtkBuildable</h3>
+<p>
+GtkIconFactory supports a custom &lt;sources&gt; element, which can contain
+multiple &lt;source&gt; elements.
+The following attributes are allowed:
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term">stock-id</span></p></td>
+<td><p>
+The stock id of the source, a string.
+This attribute is mandatory
+</p></td>
+</tr>
+<tr>
+<td><p><span class="term">filename</span></p></td>
+<td><p>
+The filename of the source, a string.
+This attribute is optional
+</p></td>
+</tr>
+<tr>
+<td><p><span class="term">icon-name</span></p></td>
+<td><p>
+The icon name for the source, a string.
+This attribute is optional.
+</p></td>
+</tr>
+<tr>
+<td><p><span class="term">size</span></p></td>
+<td><p>
+Size of the icon, a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> enum value.
+This attribute is optional.
+</p></td>
+</tr>
+<tr>
+<td><p><span class="term">direction</span></p></td>
+<td><p>
+Direction of the source, a <a class="link" href="GtkWidget.html#GtkTextDirection" title="enum GtkTextDirection"><span class="type">GtkTextDirection</span></a> enum value.
+This attribute is optional.
+</p></td>
+</tr>
+<tr>
+<td><p><span class="term">state</span></p></td>
+<td><p>
+State of the source, a <a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> enum value.
+This attribute is optional.
+</p></td>
+</tr>
+</tbody>
+</table></div>
+<p>
+</p>
+<div class="example">
+<a name="idm140520403499232"></a><p class="title"><b>Example 42. A <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a> UI definition fragment.</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkIconFactory"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"iconfactory1"</span><span class="symbol">&gt;</span>
+<span class="normal">  </span><span class="symbol">&lt;</span><span class="normal">sources</span><span class="symbol">&gt;</span>
+<span class="normal">    </span><span class="symbol">&lt;</span><span class="usertype">source</span><span class="normal"> stock</span><span class="symbol">-</span><span class="normal">id</span><span class="symbol">=</span><span class="string">"apple-red"</span><span class="normal"> filename</span><span class="symbol">=</span><span class="string">"apple-red.png"</span><span class="symbol">/&gt;</span>
+<span class="normal">  </span><span class="symbol">&lt;/</span><span class="normal">sources</span><span class="symbol">&gt;</span>
+<span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
+<span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkWindow"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"window1"</span><span class="symbol">&gt;</span>
+<span class="normal">  </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
+<span class="normal">    </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkButton"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"apple_button"</span><span class="symbol">&gt;</span>
+<span class="normal">      </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"label"</span><span class="symbol">&gt;</span><span class="normal">apple</span><span class="symbol">-</span><span class="normal">red</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
+<span class="normal">      </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"use-stock"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
+<span class="normal">    </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
+<span class="normal">  </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
+<span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+</p>
+</div>
+<p>
+</p>
+</div>
+<div class="refsect1">
+<a name="gtk3-Themeable-Stock-Images.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="GtkIconSource"></a><h3>GtkIconSource</h3>
+<pre class="programlisting">typedef struct _GtkIconSource GtkIconSource;</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkIconFactory-struct"></a><h3>struct GtkIconFactory</h3>
+<pre class="programlisting">struct GtkIconFactory;</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkIconSet-struct"></a><h3>GtkIconSet</h3>
+<pre class="programlisting">typedef struct _GtkIconSet GtkIconSet;</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkIconSize"></a><h3>enum GtkIconSize</h3>
+<pre class="programlisting">typedef enum {
+  GTK_ICON_SIZE_INVALID,
+  GTK_ICON_SIZE_MENU,
+  GTK_ICON_SIZE_SMALL_TOOLBAR,
+  GTK_ICON_SIZE_LARGE_TOOLBAR,
+  GTK_ICON_SIZE_BUTTON,
+  GTK_ICON_SIZE_DND,
+  GTK_ICON_SIZE_DIALOG
+} GtkIconSize;
+</pre>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><a name="GTK-ICON-SIZE-INVALID:CAPS"></a><span class="term"><code class="literal">GTK_ICON_SIZE_INVALID</code></span></p></td>
+<td></td>
+</tr>
+<tr>
+<td><p><a name="GTK-ICON-SIZE-MENU:CAPS"></a><span class="term"><code class="literal">GTK_ICON_SIZE_MENU</code></span></p></td>
+<td></td>
+</tr>
+<tr>
+<td><p><a name="GTK-ICON-SIZE-SMALL-TOOLBAR:CAPS"></a><span class="term"><code class="literal">GTK_ICON_SIZE_SMALL_TOOLBAR</code></span></p></td>
+<td></td>
+</tr>
+<tr>
+<td><p><a name="GTK-ICON-SIZE-LARGE-TOOLBAR:CAPS"></a><span class="term"><code class="literal">GTK_ICON_SIZE_LARGE_TOOLBAR</code></span></p></td>
+<td></td>
+</tr>
+<tr>
+<td><p><a name="GTK-ICON-SIZE-BUTTON:CAPS"></a><span class="term"><code class="literal">GTK_ICON_SIZE_BUTTON</code></span></p></td>
+<td></td>
+</tr>
+<tr>
+<td><p><a name="GTK-ICON-SIZE-DND:CAPS"></a><span class="term"><code class="literal">GTK_ICON_SIZE_DND</code></span></p></td>
+<td></td>
+</tr>
+<tr>
+<td><p><a name="GTK-ICON-SIZE-DIALOG:CAPS"></a><span class="term"><code class="literal">GTK_ICON_SIZE_DIALOG</code></span></p></td>
+<td></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-copy"></a><h3>gtk_icon_source_copy ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="returnvalue">GtkIconSource</span></a> *     gtk_icon_source_copy                (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);</pre>
+<p>
+Creates a copy of <em class="parameter"><code>source</code></em>; mostly useful for language bindings.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-free"></a><h3>gtk_icon_source_free ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_source_free                (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);</pre>
+<p>
+Frees a dynamically-allocated icon source, along with its
+filename, size, and pixbuf fields if those are not <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-factory-add"></a><h3>gtk_icon_factory_add ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_factory_add                (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a> *factory</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>);</pre>
+<p>
+Adds the given <em class="parameter"><code>icon_set</code></em> to the icon factory, under the name
+<em class="parameter"><code>stock_id</code></em>.  <em class="parameter"><code>stock_id</code></em> should be namespaced for your application,
+e.g. "myapp-whatever-icon".  Normally applications create a
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>, then add it to the list of default factories with
+<a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-add-default" title="gtk_icon_factory_add_default ()"><code class="function">gtk_icon_factory_add_default()</code></a>. Then they pass the <em class="parameter"><code>stock_id</code></em> to
+widgets such as <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> to display the icon. Themes can provide
+an icon with the same name (such as "myapp-whatever-icon") to
+override your application's default icons. If an icon already
+existed in <em class="parameter"><code>factory</code></em> for <em class="parameter"><code>stock_id</code></em>, it is unreferenced and replaced
+with the new <em class="parameter"><code>icon_set</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>factory</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>stock_id</code></em> :</span></p></td>
+<td>icon name</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>icon_set</code></em> :</span></p></td>
+<td>icon set</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-factory-add-default"></a><h3>gtk_icon_factory_add_default ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_factory_add_default        (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a> *factory</code></em>);</pre>
+<p>
+Adds an icon factory to the list of icon factories searched by
+<a class="link" href="GtkStyle.html#gtk-style-lookup-icon-set" title="gtk_style_lookup_icon_set ()"><code class="function">gtk_style_lookup_icon_set()</code></a>. This means that, for example,
+<a class="link" href="GtkImage.html#gtk-image-new-from-stock" title="gtk_image_new_from_stock ()"><code class="function">gtk_image_new_from_stock()</code></a> will be able to find icons in <em class="parameter"><code>factory</code></em>.
+There will normally be an icon factory added for each library or
+application that comes with icons. The default icon factories
+can be overridden by themes.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>factory</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-factory-lookup"></a><h3>gtk_icon_factory_lookup ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="returnvalue">GtkIconSet</span></a> *        gtk_icon_factory_lookup             (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a> *factory</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
+<p>
+Looks up <em class="parameter"><code>stock_id</code></em> in the icon factory, returning an icon set
+if found, otherwise <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. For display to the user, you should
+use <a class="link" href="GtkStyle.html#gtk-style-lookup-icon-set" title="gtk_style_lookup_icon_set ()"><code class="function">gtk_style_lookup_icon_set()</code></a> on the <a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> for the
+widget that will display the icon, instead of using this
+function directly, so that themes are taken into account.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>factory</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>stock_id</code></em> :</span></p></td>
+<td>an icon name</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>icon set of <em class="parameter"><code>stock_id</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-factory-lookup-default"></a><h3>gtk_icon_factory_lookup_default ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="returnvalue">GtkIconSet</span></a> *        gtk_icon_factory_lookup_default     (<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
+<p>
+Looks for an icon in the list of default icon factories.  For
+display to the user, you should use <a class="link" href="GtkStyle.html#gtk-style-lookup-icon-set" title="gtk_style_lookup_icon_set ()"><code class="function">gtk_style_lookup_icon_set()</code></a> on
+the <a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> for the widget that will display the icon, instead of
+using this function directly, so that themes are taken into
+account.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>stock_id</code></em> :</span></p></td>
+<td>an icon name</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-factory-new"></a><h3>gtk_icon_factory_new ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="returnvalue">GtkIconFactory</span></a> *    gtk_icon_factory_new                (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Creates a new <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>. An icon factory manages a collection
+of <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>s; a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> manages a set of variants of a
+particular icon (i.e. a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> contains variants for different
+sizes and widget states). Icons in an icon factory are named by a
+stock ID, which is a simple string identifying the icon. Each
+<a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> has a list of <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>s derived from the current
+theme; those icon factories are consulted first when searching for
+an icon. If the theme doesn't set a particular icon, GTK+ looks for
+the icon in a list of default icon factories, maintained by
+<a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-add-default" title="gtk_icon_factory_add_default ()"><code class="function">gtk_icon_factory_add_default()</code></a> and
+<a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-remove-default" title="gtk_icon_factory_remove_default ()"><code class="function">gtk_icon_factory_remove_default()</code></a>. Applications with icons should
+add a default icon factory with their icons, which will allow
+themes to override the icons for the application.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-factory-remove-default"></a><h3>gtk_icon_factory_remove_default ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_factory_remove_default     (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a> *factory</code></em>);</pre>
+<p>
+Removes an icon factory from the list of default icon
+factories. Not normally used; you might use it for a library that
+can be unloaded or shut down.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>factory</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a> previously added with <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-factory-add-default" title="gtk_icon_factory_add_default ()"><code class="function">gtk_icon_factory_add_default()</code></a>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-set-add-source"></a><h3>gtk_icon_set_add_source ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_set_add_source             (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>,
+                                                         <em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);</pre>
+<p>
+Icon sets have a list of <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>, which they use as base
+icons for rendering icons in different states and sizes. Icons are
+scaled, made to look insensitive, etc. in
+<a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-render-icon" title="gtk_icon_set_render_icon ()"><code class="function">gtk_icon_set_render_icon()</code></a>, but <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> needs base images to
+work with. The base images and when to use them are described by
+a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>.
+</p>
+<p>
+This function copies <em class="parameter"><code>source</code></em>, so you can reuse the same source immediately
+without affecting the icon set.
+</p>
+<p>
+An example of when you'd use this function: a web browser's "Back
+to Previous Page" icon might point in a different direction in
+Hebrew and in English; it might look different when insensitive;
+and it might change size depending on toolbar mode (small/large
+icons). So a single icon set would contain all those variants of
+the icon, and you might add a separate source for each one.
+</p>
+<p>
+You should nearly always add a "default" icon source with all
+fields wildcarded, which will be used as a fallback if no more
+specific source matches. <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> always prefers more specific
+icon sources to more generic icon sources. The order in which you
+add the sources to the icon set does not matter.
+</p>
+<p>
+<a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-new-from-pixbuf" title="gtk_icon_set_new_from_pixbuf ()"><code class="function">gtk_icon_set_new_from_pixbuf()</code></a> creates a new icon set with a
+default icon source based on the given pixbuf.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>icon_set</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-set-copy"></a><h3>gtk_icon_set_copy ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="returnvalue">GtkIconSet</span></a> *        gtk_icon_set_copy                   (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>);</pre>
+<p>
+Copies <em class="parameter"><code>icon_set</code></em> by value.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>icon_set</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> identical to the first.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-set-new"></a><h3>gtk_icon_set_new ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="returnvalue">GtkIconSet</span></a> *        gtk_icon_set_new                    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Creates a new <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>. A <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> represents a single icon
+in various sizes and widget states. It can provide a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
+for a given size and state on request, and automatically caches
+some of the rendered <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> objects.
+</p>
+<p>
+Normally you would use <a class="link" href="GtkWidget.html#gtk-widget-render-icon-pixbuf" title="gtk_widget_render_icon_pixbuf ()"><code class="function">gtk_widget_render_icon_pixbuf()</code></a> instead of
+using <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> directly. The one case where you'd use
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> is to create application-specific icon sets to place in
+a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-set-new-from-pixbuf"></a><h3>gtk_icon_set_new_from_pixbuf ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="returnvalue">GtkIconSet</span></a> *        gtk_icon_set_new_from_pixbuf        (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
+<p>
+Creates a new <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> with <em class="parameter"><code>pixbuf</code></em> as the default/fallback
+source image. If you don't add any additional <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> to the
+icon set, all variants of the icon will be created from <em class="parameter"><code>pixbuf</code></em>,
+using scaling, pixelation, etc. as required to adjust the icon size
+or make the icon look insensitive/prelighted.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
+<td>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-set-ref"></a><h3>gtk_icon_set_ref ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="returnvalue">GtkIconSet</span></a> *        gtk_icon_set_ref                    (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>);</pre>
+<p>
+Increments the reference count on <em class="parameter"><code>icon_set</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>icon_set</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<em class="parameter"><code>icon_set</code></em>.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-set-render-icon"></a><h3>gtk_icon_set_render_icon ()</h3>
+<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         gtk_icon_set_render_icon            (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> *style</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkTextDirection" title="enum GtkTextDirection"><span class="type">GtkTextDirection</span></a> direction</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> state</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *detail</code></em>);</pre>
+<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Warning</h3>
+<p><code class="literal">gtk_icon_set_render_icon</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-render-icon-pixbuf" title="gtk_icon_set_render_icon_pixbuf ()"><code class="function">gtk_icon_set_render_icon_pixbuf()</code></a> instead</p>
+</div>
+<p>
+Renders an icon using <a class="link" href="GtkStyle.html#gtk-style-render-icon" title="gtk_style_render_icon ()"><code class="function">gtk_style_render_icon()</code></a>. In most cases,
+<a class="link" href="GtkWidget.html#gtk-widget-render-icon" title="gtk_widget_render_icon ()"><code class="function">gtk_widget_render_icon()</code></a> is better, since it automatically provides
+most of the arguments from the current widget settings.  This
+function never returns <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>; if the icon can't be rendered
+(perhaps because an image file fails to load), a default "missing
+image" icon will be returned instead.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>icon_set</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>style</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> associated with <em class="parameter"><code>widget</code></em>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>direction</code></em> :</span></p></td>
+<td>text direction</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>state</code></em> :</span></p></td>
+<td>widget state</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
+<td>icon size. A size of (GtkIconSize)-1
+means render at the size of the source and don't scale. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
+<td>widget that will display the icon, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.
+The only use that is typically made of this
+is to determine the appropriate <a href="../gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>detail</code></em> :</span></p></td>
+<td>detail to pass to the theme engine, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.
+Note that passing a detail of anything but <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
+will disable caching. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> to be displayed. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-set-render-icon-pixbuf"></a><h3>gtk_icon_set_render_icon_pixbuf ()</h3>
+<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         gtk_icon_set_render_icon_pixbuf     (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> *context</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
+<p>
+Renders an icon using <a class="link" href="GtkStyleContext.html#gtk-render-icon-pixbuf" title="gtk_render_icon_pixbuf ()"><code class="function">gtk_render_icon_pixbuf()</code></a>. In most cases,
+<a class="link" href="GtkWidget.html#gtk-widget-render-icon-pixbuf" title="gtk_widget_render_icon_pixbuf ()"><code class="function">gtk_widget_render_icon_pixbuf()</code></a> is better, since it automatically provides
+most of the arguments from the current widget settings.  This
+function never returns <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>; if the icon can't be rendered
+(perhaps because an image file fails to load), a default "missing
+image" icon will be returned instead.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>icon_set</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
+<td>icon size. A size of (GtkIconSize)-1
+means render at the size of the source and don't scale. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> to be displayed. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-set-unref"></a><h3>gtk_icon_set_unref ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_set_unref                  (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>);</pre>
+<p>
+Decrements the reference count on <em class="parameter"><code>icon_set</code></em>, and frees memory
+if the reference count reaches 0.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>icon_set</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-size-lookup"></a><h3>gtk_icon_size_lookup ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_icon_size_lookup                (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *width</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *height</code></em>);</pre>
+<p>
+Obtains the pixel size of a semantic icon size, possibly
+modified by user preferences for the default <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a>.
+(See <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-size-lookup-for-settings" title="gtk_icon_size_lookup_for_settings ()"><code class="function">gtk_icon_size_lookup_for_settings()</code></a>.)
+Normally <em class="parameter"><code>size</code></em> would be
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GTK-ICON-SIZE-MENU:CAPS"><span class="type">GTK_ICON_SIZE_MENU</span></a>, <a class="link" href="gtk3-Themeable-Stock-Images.html#GTK-ICON-SIZE-BUTTON:CAPS"><span class="type">GTK_ICON_SIZE_BUTTON</span></a>, etc.  This function
+isn't normally needed, <a class="link" href="GtkWidget.html#gtk-widget-render-icon-pixbuf" title="gtk_widget_render_icon_pixbuf ()"><code class="function">gtk_widget_render_icon_pixbuf()</code></a> is the usual
+way to get an icon for rendering, then just look at the size of
+the rendered pixbuf. The rendered pixbuf may not even correspond to
+the width/height returned by <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-size-lookup" title="gtk_icon_size_lookup ()"><code class="function">gtk_icon_size_lookup()</code></a>, because themes
+are free to render the pixbuf however they like, including changing
+the usual size.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
+<td>an icon size. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
+<td>location to store icon width. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
+<td>location to store icon height. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if <em class="parameter"><code>size</code></em> was a valid size</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-size-lookup-for-settings"></a><h3>gtk_icon_size_lookup_for_settings ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_icon_size_lookup_for_settings   (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *width</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *height</code></em>);</pre>
+<p>
+Obtains the pixel size of a semantic icon size, possibly
+modified by user preferences for a particular
+<a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a>. Normally <em class="parameter"><code>size</code></em> would be
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GTK-ICON-SIZE-MENU:CAPS"><span class="type">GTK_ICON_SIZE_MENU</span></a>, <a class="link" href="gtk3-Themeable-Stock-Images.html#GTK-ICON-SIZE-BUTTON:CAPS"><span class="type">GTK_ICON_SIZE_BUTTON</span></a>, etc.  This function
+isn't normally needed, <a class="link" href="GtkWidget.html#gtk-widget-render-icon-pixbuf" title="gtk_widget_render_icon_pixbuf ()"><code class="function">gtk_widget_render_icon_pixbuf()</code></a> is the usual
+way to get an icon for rendering, then just look at the size of
+the rendered pixbuf. The rendered pixbuf may not even correspond to
+the width/height returned by <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-size-lookup" title="gtk_icon_size_lookup ()"><code class="function">gtk_icon_size_lookup()</code></a>, because themes
+are free to render the pixbuf however they like, including changing
+the usual size.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> object, used to determine
+which set of user preferences to used.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
+<td>an icon size. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
+<td>location to store icon width. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
+<td>location to store icon height. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if <em class="parameter"><code>size</code></em> was a valid size</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.2</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-size-register"></a><h3>gtk_icon_size_register ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>         gtk_icon_size_register              (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> width</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> height</code></em>);</pre>
+<p>
+Registers a new icon size, along the same lines as <a class="link" href="gtk3-Themeable-Stock-Images.html#GTK-ICON-SIZE-MENU:CAPS"><span class="type">GTK_ICON_SIZE_MENU</span></a>,
+etc. Returns the integer value for the size.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
+<td>name of the icon size</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
+<td>the icon width</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
+<td>the icon height</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>integer value representing the size. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-size-register-alias"></a><h3>gtk_icon_size_register_alias ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_size_register_alias        (<em class="parameter"><code>const <span class="type">gchar</span> *alias</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> target</code></em>);</pre>
+<p>
+Registers <em class="parameter"><code>alias</code></em> as another name for <em class="parameter"><code>target</code></em>.
+So calling <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-size-from-name" title="gtk_icon_size_from_name ()"><code class="function">gtk_icon_size_from_name()</code></a> with <em class="parameter"><code>alias</code></em> as argument
+will return <em class="parameter"><code>target</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>alias</code></em> :</span></p></td>
+<td>an alias for <em class="parameter"><code>target</code></em>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
+<td>an existing icon size. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-size-from-name"></a><h3>gtk_icon_size_from_name ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>         gtk_icon_size_from_name             (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
+<p>
+Looks up the icon size associated with <em class="parameter"><code>name</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
+<td>the name to look up.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the icon size. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-size-get-name"></a><h3>gtk_icon_size_get_name ()</h3>
+<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_icon_size_get_name              (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
+<p>
+Gets the canonical name of the given icon size. The returned string
+is statically allocated and should not be freed.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the name of the given icon size.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-set-get-sizes"></a><h3>gtk_icon_set_get_sizes ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_set_get_sizes              (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> *icon_set</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> **sizes</code></em>,
+                                                         <em class="parameter"><code><span class="type">gint</span> *n_sizes</code></em>);</pre>
+<p>
+Obtains a list of icon sizes this icon set can render. The returned
+array must be freed with <code class="function">g_free()</code>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>icon_set</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sizes</code></em> :</span></p></td>
+<td>return location
+for array of sizes. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_sizes][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>n_sizes</code></em> :</span></p></td>
+<td>location to store number of elements in returned array</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-get-direction"></a><h3>gtk_icon_source_get_direction ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html#GtkTextDirection" title="enum GtkTextDirection"><span class="returnvalue">GtkTextDirection</span></a>    gtk_icon_source_get_direction       (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);</pre>
+<p>
+Obtains the text direction this icon source applies to. The return
+value is only useful/meaningful if the text direction is <span class="emphasis"><em>not</em></span>
+wildcarded.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>text direction this source matches</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-get-direction-wildcarded"></a><h3>gtk_icon_source_get_direction_wildcarded ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_icon_source_get_direction_wildcarded
+                                                        (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);</pre>
+<p>
+Gets the value set by <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-direction-wildcarded" title="gtk_icon_source_set_direction_wildcarded ()"><code class="function">gtk_icon_source_set_direction_wildcarded()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if this icon source is a base for any text direction variant</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-get-filename"></a><h3>gtk_icon_source_get_filename ()</h3>
+<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_icon_source_get_filename        (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);</pre>
+<p>
+Retrieves the source filename, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if none is set. The
+filename is not a copy, and should not be modified or expected to
+persist beyond the lifetime of the icon source.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>image filename. This string must not
+be modified or freed. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-get-pixbuf"></a><h3>gtk_icon_source_get_pixbuf ()</h3>
+<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         gtk_icon_source_get_pixbuf          (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);</pre>
+<p>
+Retrieves the source pixbuf, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if none is set.
+In addition, if a filename source is in use, this
+function in some cases will return the pixbuf from
+loaded from the filename. This is, for example, true
+for the GtkIconSource passed to the GtkStyle::<code class="function">render_icon()</code>
+virtual function. The reference count on the pixbuf is
+not incremented.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>source pixbuf. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-get-icon-name"></a><h3>gtk_icon_source_get_icon_name ()</h3>
+<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_icon_source_get_icon_name       (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);</pre>
+<p>
+Retrieves the source icon name, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if none is set. The
+icon_name is not a copy, and should not be modified or expected to
+persist beyond the lifetime of the icon source.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>icon name. This string must not be modified or freed.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-get-size"></a><h3>gtk_icon_source_get_size ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>         gtk_icon_source_get_size            (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);</pre>
+<p>
+Obtains the icon size this source applies to. The return value
+is only useful/meaningful if the icon size is <span class="emphasis"><em>not</em></span> wildcarded.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>icon size this source matches. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-get-size-wildcarded"></a><h3>gtk_icon_source_get_size_wildcarded ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_icon_source_get_size_wildcarded (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);</pre>
+<p>
+Gets the value set by <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-size-wildcarded" title="gtk_icon_source_set_size_wildcarded ()"><code class="function">gtk_icon_source_set_size_wildcarded()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if this icon source is a base for any icon size variant</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-get-state"></a><h3>gtk_icon_source_get_state ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="returnvalue">GtkStateType</span></a>        gtk_icon_source_get_state           (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);</pre>
+<p>
+Obtains the widget state this icon source applies to. The return
+value is only useful/meaningful if the widget state is <span class="emphasis"><em>not</em></span>
+wildcarded.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>widget state this source matches</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-get-state-wildcarded"></a><h3>gtk_icon_source_get_state_wildcarded ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_icon_source_get_state_wildcarded
+                                                        (<em class="parameter"><code>const <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>);</pre>
+<p>
+Gets the value set by <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-state-wildcarded" title="gtk_icon_source_set_state_wildcarded ()"><code class="function">gtk_icon_source_set_state_wildcarded()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if this icon source is a base for any widget state variant</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-new"></a><h3>gtk_icon_source_new ()</h3>
+<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="returnvalue">GtkIconSource</span></a> *     gtk_icon_source_new                 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Creates a new <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>. A <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> contains a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> (or
+image filename) that serves as the base image for one or more of the
+icons in a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>, along with a specification for which icons in the
+icon set will be based on that pixbuf or image file. An icon set contains
+a set of icons that represent "the same" logical concept in different states,
+different global text directions, and different sizes.
+</p>
+<p>
+So for example a web browser's "Back to Previous Page" icon might
+point in a different direction in Hebrew and in English; it might
+look different when insensitive; and it might change size depending
+on toolbar mode (small/large icons). So a single icon set would
+contain all those variants of the icon. <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> contains a list
+of <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> from which it can derive specific icon variants in
+the set.
+</p>
+<p>
+In the simplest case, <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> contains one source pixbuf from
+which it derives all variants. The convenience function
+<a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-new-from-pixbuf" title="gtk_icon_set_new_from_pixbuf ()"><code class="function">gtk_icon_set_new_from_pixbuf()</code></a> handles this case; if you only have
+one source pixbuf, just use that function.
+</p>
+<p>
+If you want to use a different base pixbuf for different icon
+variants, you create multiple icon sources, mark which variants
+they'll be used to create, and add them to the icon set with
+<a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-set-add-source" title="gtk_icon_set_add_source ()"><code class="function">gtk_icon_set_add_source()</code></a>.
+</p>
+<p>
+By default, the icon source has all parameters wildcarded. That is,
+the icon source will be used as the base icon for any desired text
+direction, widget state, or icon size.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-set-direction"></a><h3>gtk_icon_source_set_direction ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_source_set_direction       (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkTextDirection" title="enum GtkTextDirection"><span class="type">GtkTextDirection</span></a> direction</code></em>);</pre>
+<p>
+Sets the text direction this icon source is intended to be used
+with.
+</p>
+<p>
+Setting the text direction on an icon source makes no difference
+if the text direction is wildcarded. Therefore, you should usually
+call <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-direction-wildcarded" title="gtk_icon_source_set_direction_wildcarded ()"><code class="function">gtk_icon_source_set_direction_wildcarded()</code></a> to un-wildcard it
+in addition to calling this function.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>direction</code></em> :</span></p></td>
+<td>text direction this source applies to</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-set-direction-wildcarded"></a><h3>gtk_icon_source_set_direction_wildcarded ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_source_set_direction_wildcarded
+                                                        (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
+<p>
+If the text direction is wildcarded, this source can be used
+as the base image for an icon in any <a class="link" href="GtkWidget.html#GtkTextDirection" title="enum GtkTextDirection"><span class="type">GtkTextDirection</span></a>.
+If the text direction is not wildcarded, then the
+text direction the icon source applies to should be set
+with <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-direction" title="gtk_icon_source_set_direction ()"><code class="function">gtk_icon_source_set_direction()</code></a>, and the icon source
+will only be used with that text direction.
+</p>
+<p>
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> prefers non-wildcarded sources (exact matches) over
+wildcarded sources, and will use an exact match when possible.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> to wildcard the text direction</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-set-filename"></a><h3>gtk_icon_source_set_filename ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_source_set_filename        (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>);</pre>
+<p>
+Sets the name of an image file to use as a base image when creating
+icon variants for <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>. The filename must be absolute.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
+<td>image file to use. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-set-pixbuf"></a><h3>gtk_icon_source_set_pixbuf ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_source_set_pixbuf          (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
+<p>
+Sets a pixbuf to use as a base image when creating icon variants
+for <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
+<td>pixbuf to use as a source</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-set-icon-name"></a><h3>gtk_icon_source_set_icon_name ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_source_set_icon_name       (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>);</pre>
+<p>
+Sets the name of an icon to look up in the current icon theme
+to use as a base image when creating icon variants for <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>icon_name</code></em> :</span></p></td>
+<td>name of icon to use. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-set-size"></a><h3>gtk_icon_source_set_size ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_source_set_size            (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
+<p>
+Sets the icon size this icon source is intended to be used
+with.
+</p>
+<p>
+Setting the icon size on an icon source makes no difference
+if the size is wildcarded. Therefore, you should usually
+call <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-size-wildcarded" title="gtk_icon_source_set_size_wildcarded ()"><code class="function">gtk_icon_source_set_size_wildcarded()</code></a> to un-wildcard it
+in addition to calling this function.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
+<td>icon size this source applies to. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-set-size-wildcarded"></a><h3>gtk_icon_source_set_size_wildcarded ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_source_set_size_wildcarded (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
+<p>
+If the icon size is wildcarded, this source can be used as the base
+image for an icon of any size.  If the size is not wildcarded, then
+the size the source applies to should be set with
+<a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-size" title="gtk_icon_source_set_size ()"><code class="function">gtk_icon_source_set_size()</code></a> and the icon source will only be used
+with that specific size.
+</p>
+<p>
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> prefers non-wildcarded sources (exact matches) over
+wildcarded sources, and will use an exact match when possible.
+</p>
+<p>
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> will normally scale wildcarded source images to produce
+an appropriate icon at a given size, but will not change the size
+of source images that match exactly.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> to wildcard the widget state</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-set-state"></a><h3>gtk_icon_source_set_state ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_source_set_state           (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> state</code></em>);</pre>
+<p>
+Sets the widget state this icon source is intended to be used
+with.
+</p>
+<p>
+Setting the widget state on an icon source makes no difference
+if the state is wildcarded. Therefore, you should usually
+call <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-state-wildcarded" title="gtk_icon_source_set_state_wildcarded ()"><code class="function">gtk_icon_source_set_state_wildcarded()</code></a> to un-wildcard it
+in addition to calling this function.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>state</code></em> :</span></p></td>
+<td>widget state this source applies to</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-icon-source-set-state-wildcarded"></a><h3>gtk_icon_source_set_state_wildcarded ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_icon_source_set_state_wildcarded
+                                                        (<em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a> *source</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
+<p>
+If the widget state is wildcarded, this source can be used as the
+base image for an icon in any <a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a>.  If the widget state
+is not wildcarded, then the state the source applies to should be
+set with <a class="link" href="gtk3-Themeable-Stock-Images.html#gtk-icon-source-set-state" title="gtk_icon_source_set_state ()"><code class="function">gtk_icon_source_set_state()</code></a> and the icon source will
+only be used with that specific state.
+</p>
+<p>
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> prefers non-wildcarded sources (exact matches) over
+wildcarded sources, and will use an exact match when possible.
+</p>
+<p>
+<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSet"><span class="type">GtkIconSet</span></a> will normally transform wildcarded source images to
+produce an appropriate icon for a given state, for example
+lightening an image on prelight, but will not modify source images
+that match exactly.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
+<td>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSource" title="GtkIconSource"><span class="type">GtkIconSource</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> to wildcard the widget state</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.18.1</div>
+</body>
+</html>