函数
Pangomarkup_parser_new
自:1.31.0 起
[src] 声明
GMarkupParseContext*
pango_markup_parser_new (
gunichar accel_marker
)
[src] 说明
逐步解析标记文本以创建纯文本字符串和属性列表。
有关受支持标记的详细信息,请参阅 Pango 标记 文档。
如果 accel_marker
非零,则给定字符将标记其后的字符作为加速键。例如,accel_marker
可能是&符号或下划线。所有标记为加速键的字符都将收到 PANGO_UNDERLINE_LOW
属性,第一个如此标记的字符将在调用 pango_markup_parser_finish()
时返回 accel_char
中。两个连续的 accel_marker
字符生成单个字面 accel_marker
字符。
要将标记提供给解析器,请使用返回的 g_markup_parse_context_parse()
对 GMarkupParseContext
。在完成将标记提供给解析器的操作后,使用 pango_markup_parser_finish()
从中获取数据,然后使用 g_markup_parse_context_free()
释放它。
此函数专为从流中读取 Pango 标记的应用程序而设计。要只解析包含 Pango 标记的字符串,建议使用 pango_parse_markup()
API。
自 1.31.0 起提供
返回值
应使用 g_markup_parse_context_free()
销毁的 GMarkupParseContext
。
数据归调用函数所有。 |