GtkIconTheme

说明 [源代码]

final class Gtk.IconTheme : GObject.Object
{
  /* No available fields */
}

GtkIconTheme 提供了加载主题图标的功能。

使用名称而不是简单提供文件名的主要原因是允许使用不同的图标,具体取决于用户选择的“图标主题”。Linux 和 Unix 上的图标主题的操作遵循 图标主题规范 有一个名为 hicolor 的备用图标主题,应用程序应该将图标安装在这里,但也可以安装其他图标主题,具体由操作系统供应商和用户决定。

在很多情况下,通过 GtkImage 间接使用命名主题,而不是直接使用,但直接查找图标也非常简单。GtkIconTheme 对象充当当前主题中所有图标的数据库。你可以创建新的 GtkIconTheme 对象,但使用 GtkWidget 的标准图标主题可以更高效,以便图标信息与查找图标的其他人员共享。

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);

层级

hierarchy this GtkIconTheme ancestor_0 GObject ancestor_0--this

祖先

构造函数

gtk_icon_theme_new

创建一个新的图标主题对象。

函数

gtk_icon_theme_get_for_display

获取与 display 关联的图标主题对象。

实例方法

gtk_icon_theme_add_resource_path

添加将在查找图标时查阅的资源路径,类似于搜索路径。

gtk_icon_theme_add_search_path

将目录追加到搜索路径。

gtk_icon_theme_get_display

返回为 GtkIconTheme 对象创建的显示。

gtk_icon_theme_get_icon_names

列出当前图标主题中的图标名称。

gtk_icon_theme_get_icon_sizes

返回一个整数数组,描述可在不用缩放的情况下获得图标的大小。

gtk_icon_theme_get_resource_path

获取当前资源路径。

gtk_icon_theme_get_search_path

获取当前搜索路径。

gtk_icon_theme_get_theme_name

获取当前图标主题名称。

gtk_icon_theme_has_gicon

检查图标主题是否包含特定 GIcon 的图标。

自版本 4.2 起

gtk_icon_theme_has_icon

检查图标主题是否包含特定名称的图标。

gtk_icon_theme_lookup_by_gicon

查找所需大小和窗口比例的图标。

gtk_icon_theme_lookup_icon

查找指定大小和窗口比例的命名图标,并返回一个 GtkIconPaintable

gtk_icon_theme_set_resource_path

设置查找图标时要查看的资源路径,类似于搜索路径。

gtk_icon_theme_set_search_path

设置图标主题对象的搜索路径。

gtk_icon_theme_set_theme_name

设置 GtkIconTheme 对象使用的图标主题的名称,并覆盖系统配置。

GObject (43) 继承的方法

有关方法的完整列表,请访问 GObject

属性

Gtk.IconTheme:display

此图标主题对象所附加的显示器。

Gtk.IconTheme:icon-names

图标主题支持的图标名称。

Gtk.IconTheme:resource-path

查找图标时要查看的资源路径,类似于搜索路径。

Gtk.IconTheme:search-path

该图标主题的搜索路径。

Gtk.IconTheme:theme-name

正在使用的图标主题的名称。

信号

Gtk.IconTheme::changed

图标主题改变后发出。

GObject (1) 继承的信号
GObject::notify

当某个对象的一个属性的值通过 g_object_set_property()、g_object_set() 等函数设置时,会在该对象上发出该 notify 信号。