1
2@c %start of fragment
3
4@node Themeable Stock Images
5@chapter Themeable Stock Images
6Manipulating stock icons
7
8@section Overview
9Browse the available stock icons in the list of stock IDs found here. You can
10also use the application for this purpose.
11
12An icon factory manages a collection of @code{<gtk-icon-set>}; a
13@code{<gtk-icon-set>} manages a set of variants of a particular icon (i.e. a
14@code{<gtk-icon-set>} contains variants for different sizes and widget states).
15Icons in an icon factory are named by a stock ID, which is a simple string
16identifying the icon. Each @code{<gtk-style>} has a list of
17@code{<gtk-icon-factory>} derived from the current theme; those icon factories
18are consulted first when searching for an icon. If the theme doesn't set a
19particular icon, GTK+ looks for the icon in a list of default icon factories,
20maintained by @code{gtk-icon-factory-add-default} and
21@code{gtk-icon-factory-remove-default}. Applications with icons should add a
22default icon factory with their icons, which will allow themes to override the
23icons for the application.
24
25To display an icon, always use @code{gtk-style-lookup-icon-set} on the widget
26that will display the icon, or the convenience function
27@code{gtk-widget-render-icon}. These functions take the theme into account when
28looking up the icon to use for a given stock ID.
29
30@section Usage
31@include defuns-gtkiconfactory.xml.texi
32
33@c %end of fragment
34