方法
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
-
修改图标查找行为的标志。
返回值
类型: GtkIconPaintable
一个包含图标的GtkIconPaintable
对象。
方法的调用者承担返回数据的所有权,并负责释放它。 |