方法

PangoContextget_metrics

声明 [源代码]

PangoFontMetrics*
pango_context_get_metrics (
  PangoContext* context,
  const PangoFontDescription* desc,
  PangoLanguage* language
)

描述 [源代码]

获取特定字体描述的全局度量信息。

由于度量值可能因不同的脚本而有很大差异，可以提供一个语言标签以指示应检索与该语言使用的脚本对应的度量值。

PangoFontDescription 的解释方式与 pango_itemize() 类似，家族名称可以是逗号分隔的名称列表。如果使用这些家族中的多个家族的字符来渲染字符串，则返回的字体将是这些为各个家族加载的字体度量的组合。

参数

desc

类型: PangoFontDescription

PangoFontDescription 结构体。NULL 表示将使用上下文中的字体描述。

参数可以 NULL。
数据由方法的调用者拥有。
language

类型: PangoLanguage

用于确定获取度量值的脚本的语言标签。 NULL 表示将使用上下文中的语言标签。如果没有设置上下文中的语言标签，则将返回由 pango_language_get_default() 确定的默认语言的度量信息。

参数可以 NULL。
数据由方法的调用者拥有。

返回值

类型: PangoFontMetrics

一个 PangoFontMetrics 对象。调用者必须在完成使用该对象后调用 pango_font_metrics_unref()。

方法的调用者将拥有返回的数据，并负责释放它。