Themeable Stock Images
Manipulating stock icons
Browse the available stock icons in the list of stock IDs found here. You can also use
the gtk-demo application for this purpose.
An icon factory manages a collection of #GtkIconSet; a #GtkIconSet manages a
set of variants of a particular icon (i.e. a #GtkIconSet 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 #GtkStyle has a
list of #GtkIconFactory 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.
GtkIconFactory as GtkBuildable
GtkIconFactory supports a custom <sources> element, which
can contain multiple <source> elements.
The following attributes are allowed:
stock-idThe stock id of the source, a string.
This attribute is mandatoryfilenameThe filename of the source, a string.
This attribute is optionalicon-nameThe icon name for the source, a string.
This attribute is optional.sizeSize of the icon, a #GtkIconSize enum value.
This attribute is optional.directionDirection of the source, a #GtkTextDirection enum value.
This attribute is optional.stateState of the source, a #GtkStateType enum value.
This attribute is optional.A <structname>GtkIconFactory</structname> UI definition fragment.
]]>
@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:
@source:
@Returns:
@source:
@factory:
@stock_id:
@icon_set:
@factory:
@factory:
@stock_id:
@Returns:
@stock_id:
@Returns:
@void:
@Returns:
@factory:
@icon_set:
@source:
@icon_set:
@Returns:
@void:
@Returns:
@pixbuf:
@Returns:
@icon_set:
@Returns:
@icon_set:
@style:
@direction:
@state:
@size:
@widget:
@detail:
@Returns:
@icon_set:
@size:
@width:
@height:
@Returns:
@settings:
@size:
@width:
@height:
@Returns:
@name:
@width:
@height:
@Returns:
@alias:
@target:
@name:
@Returns:
@size:
@Returns:
@icon_set:
@sizes:
@n_sizes:
@source:
@Returns:
@source:
@Returns:
@source:
@Returns:
@source:
@Returns:
@source:
@Returns:
@source:
@Returns:
@source:
@Returns:
@source:
@Returns:
@source:
@Returns:
@void:
@Returns:
@source:
@direction:
@source:
@setting:
@source:
@filename:
@source:
@pixbuf:
@source:
@icon_name:
@source:
@size:
@source:
@setting:
@source:
@state:
@source:
@setting: