Themeable Stock Images
**********************

Manipulating stock icons

Overview
========

Browse the available stock icons in the list of stock IDs found here. You can also use the application for this purpose.

An icon factory manages a collection of <gtk-icon-set>; a <gtk-icon-set> manages a set of variants of a particular icon (i.e. a <gtk-icon-set> 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 <gtk-style> has a list of <gtk-icon-factory> 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 gtk-icon-factory-add-default and gtk-icon-factory-remove-default. Applications with icons should add a default icon factory with their icons, which will allow themes to override the icons for the application.

To display an icon, always use gtk-style-lookup-icon-set on the widget that will display the icon, or the convenience function gtk-widget-render-icon. These functions take the theme into account when looking up the icon to use for a given stock ID.

Usage
=====

     [file defuns-gtkiconfactory.xml.texi not included]