方法

GtkIconThemelookup_icon

声明 [src]

GtkIconPaintable*
gtk_icon_theme_lookup_icon (
  GtkIconTheme* self,
  const char* icon_name,
  const char** fallbacks,
  int size,
  int scale,
  GtkTextDirection direction,
  GtkIconLookupFlags flags
)

描述 [src]

查找指定大小和窗口缩放的命名字符图标,返回一个GtkIconPaintable

然后可以使用它作为GdkPaintable进行渲染,或者获取如文件名和大小的信息。

如果可用的icon_name不可用且提供了fallbacks,它们将依次尝试。

如果没有找到匹配的图标,则返回一个绘制“缺失图标”的绘制对象。如果您需要对缺失的图标执行其他操作,您需要使用gtk_icon_theme_has_icon()

请注意,您可能想监听图标主题更改并更新图标。这通常通过覆盖GtkWidgetClass.css-changed()函数来完成。

参数

icon_name

类型: const char*

要查找的图标的名称。

数据由方法调用者拥有。
值是一个以NUL终止的UTF-8字符串。
fallbacks

类型: 一个char*的数组

回退名称。

参数可以NULL
数组分必须以NULL-终止。
数据由方法调用者拥有。
每个元素是一个以NUL终止的UTF-8字符串。
size

类型: int

所需图标大小,以应用像素为单位。

scale

类型: int

将在其上显示的窗口缩放。

direction

类型: GtkTextDirection

图标将显示的文本方向。

flags

类型: GtkIconLookupFlags

修改图标查找行为的标志。

返回值

类型: GtkIconPaintable

一个包含图标的GtkIconPaintable对象。

方法的调用者承担返回数据的所有权,并负责释放它。