方法

since: 1.2

声明 [src]

GSList*
pango_glyph_item_apply_attrs (
  PangoGlyphItem* glyph_item,
  const char* text,
  PangoAttrList* list
)

描述 [src]

根据属性列表将形状项(PangoGlyphItem)分割成多个项。

其目的是,如果有不对形状造成影响的属性,例如颜色或下划线,为了防止影响形状,可以过滤掉这些属性(pango_attr_list_filter()),应用形状过程,然后使用此函数重新将它们应用到结果上。

所有在聚类内部开始或结束的属性都将应用到该聚类上;例如,如果一个聚类的上半部分有下划线,而下半部分有删除线,则该聚类将最终同时具有下划线和删除线属性。在这些情况下,可能会出现结果中的一些项的item->extra_attrs具有相同类型的多个属性。

此函数将拥有glyph_item的控制权;它将被用作列表中的元素之一。

Available since: 1.2

参数

text

类型: const char*

list应用到的文本。

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

类型: PangoAttrList

一个PangoAttrList。

数据由方法的调用者拥有。

返回值

类型: 一个列表,包含None

分割glyph_item后得到的图形项的列表。使用pango_glyph_item_free()释放元素,使用g_slist_free()释放列表。

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