方法
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()释放列表。
方法的调用者将获取返回数据的所有权,并负责释放它。 |