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