函数

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 起提供

参数

accel_marker

类型: gunichar

加速键前缀字符或 0(无加速键)。

返回值

类型: GMarkupParseContext

应使用 g_markup_parse_context_free() 销毁的 GMarkupParseContext

数据归调用函数所有。