Class
Gtk.IconTheme
Description [src]
final class Gtk.IconTheme : GObject.Object {
/* No available fields */
}
GtkIconTheme
provides a facility for loading themed icons.
The main reason for using a name rather than simply providing a filename
is to allow different icons to be used depending on what “icon theme” is
selected by the user. The operation of icon themes on Linux and Unix
follows the Icon Theme Specification
There is a fallback icon theme, named hicolor
, where applications
should install their icons, but additional icon themes can be installed
as operating system vendors and users choose.
In many cases, named themes are used indirectly, via GtkImage
rather than directly, but looking up icons directly is also simple. The
GtkIconTheme
object acts as a database of all the icons in the current
theme. You can create new GtkIconTheme
objects, but it’s much more
efficient to use the standard icon theme of the GtkWidget
so that the
icon information is shared with other people looking up icons.
GtkIconTheme *icon_theme;
GtkIconPaintable *icon;
GdkPaintable *paintable;
icon_theme = gtk_icon_theme_get_for_display (gtk_widget_get_display (my_widget));
icon = gtk_icon_theme_lookup_icon (icon_theme,
"my-icon-name", // icon name
48, // icon size
1, // scale
0, // flags);
paintable = GDK_PAINTABLE (icon);
// Use the paintable
g_object_unref (icon);
Constructors
gtk_icon_theme_new
Creates a new icon theme object.
Instance methods
gtk_icon_theme_add_resource_path
Adds a resource path that will be looked at when looking for icons, similar to search paths.
gtk_icon_theme_add_search_path
Appends a directory to the search path.
gtk_icon_theme_get_display
Returns the display that the GtkIconTheme
object was
created for.
gtk_icon_theme_get_icon_names
Lists the names of icons in the current icon theme.
gtk_icon_theme_get_icon_sizes
Returns an array of integers describing the sizes at which the icon is available without scaling.
gtk_icon_theme_get_resource_path
Gets the current resource path.
gtk_icon_theme_get_search_path
Gets the current search path.
gtk_icon_theme_get_theme_name
Gets the current icon theme name.
gtk_icon_theme_has_gicon
Checks whether an icon theme includes an icon
for a particular GIcon
.
gtk_icon_theme_has_icon
Checks whether an icon theme includes an icon for a particular name.
gtk_icon_theme_lookup_by_gicon
Looks up a icon for a desired size and window scale.
gtk_icon_theme_lookup_icon
Looks up a named icon for a desired size and window scale,
returning a GtkIconPaintable
.
gtk_icon_theme_set_resource_path
Sets the resource paths that will be looked at when looking for icons, similar to search paths.
gtk_icon_theme_set_search_path
Sets the search path for the icon theme object.
gtk_icon_theme_set_theme_name
Sets the name of the icon theme that the GtkIconTheme
object uses
overriding system configuration.
Properties
Gtk.IconTheme:display
The display that this icon theme object is attached to.
Gtk.IconTheme:icon-names
The icon names that are supported by the icon theme.
Gtk.IconTheme:resource-path
Resource paths that will be looked at when looking for icons, similar to search paths.
Gtk.IconTheme:search-path
The search path for this icon theme.
Gtk.IconTheme:theme-name
The name of the icon theme that is being used.
Signals
Gtk.IconTheme::changed
Emitted when the icon theme changes.
Functions
gtk_icon_theme_get_for_display
Gets the icon theme object associated with display
.