2000-11-05 16:09:41 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
Themeable Stock Images
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
|
|
|
2001-02-03 01:09:41 +00:00
|
|
|
Manipulating stock icons
|
2000-11-05 16:09:41 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2001-02-03 01:09:41 +00:00
|
|
|
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.
|
|
|
|
</para>
|
2000-11-05 16:09:41 +00:00
|
|
|
|
2001-02-03 01:09:41 +00:00
|
|
|
<para>
|
|
|
|
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.
|
2000-11-05 16:09:41 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkIconSource ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkIconFactory ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@parent_instance:
|
|
|
|
@icons:
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkIconSet ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2001-03-23 22:21:06 +00:00
|
|
|
<!-- ##### ENUM GtkIconSize ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@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_DIALOG:
|
|
|
|
|
2000-11-05 16:09:41 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_source_copy ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_free ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_factory_add ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@factory:
|
|
|
|
@stock_id:
|
|
|
|
@icon_set:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_factory_add_default ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@factory:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_factory_lookup ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@factory:
|
|
|
|
@stock_id:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_factory_lookup_default ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@stock_id:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_factory_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_factory_remove_default ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@factory:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_set_add_source ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_set:
|
|
|
|
@source:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_set_copy ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_set:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_set_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-03-23 22:21:06 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_set_new_from_pixbuf ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@pixbuf:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2000-11-05 16:09:41 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_set_ref ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_set:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_set_render_icon ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_set:
|
|
|
|
@style:
|
|
|
|
@direction:
|
|
|
|
@state:
|
|
|
|
@size:
|
|
|
|
@widget:
|
|
|
|
@detail:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_set_unref ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_set:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_size_lookup ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-03-12 18:46:53 +00:00
|
|
|
@size:
|
2000-11-05 16:09:41 +00:00
|
|
|
@width:
|
|
|
|
@height:
|
|
|
|
@Returns:
|
2001-03-12 18:46:53 +00:00
|
|
|
<!-- # Unused Parameters # -->
|
|
|
|
@alias:
|
2000-11-05 16:09:41 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_size_register ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-03-12 18:46:53 +00:00
|
|
|
@name:
|
2000-11-05 16:09:41 +00:00
|
|
|
@width:
|
|
|
|
@height:
|
2001-03-12 18:46:53 +00:00
|
|
|
@Returns:
|
|
|
|
<!-- # Unused Parameters # -->
|
|
|
|
@alias:
|
2000-11-05 16:09:41 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_size_register_alias ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@alias:
|
|
|
|
@target:
|
|
|
|
|
|
|
|
|
2001-03-23 22:21:06 +00:00
|
|
|
<!-- ##### FUNCTION gtk_icon_size_from_name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@name:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_size_get_name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@size:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_get_direction ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_get_direction_wildcarded ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_get_filename ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_get_pixbuf ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_get_size ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_get_size_wildcarded ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_get_state ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_get_state_wildcarded ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_set_direction ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@direction:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_set_direction_wildcarded ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@setting:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_set_filename ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@filename:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_set_pixbuf ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@pixbuf:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_set_size ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@size:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_set_size_wildcarded ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@setting:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_set_state ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@state:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_icon_source_set_state_wildcarded ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@source:
|
|
|
|
@setting:
|
|
|
|
|
|
|
|
|