方法

PangoLayoutset_height

自: 1.20

声明 [源]

void
pango_layout_set_height (
  PangoLayout* layout,
  int height
)

描述 [源]

设置 PangoLayout 应在其上省略的高度。

根据 height 的值是正数还是负数,存在两种不同的行为。

如果 height 是正数,它将是布局的最大高度。只会显示可以容纳的行,如果有文本被省略,会添加省略号。无论高度值多小,每个段落至少包含一行。值为零将使整个布局只显示一行。

如果 height 是负数,它将是每段的最大行数(负数)。这意味着如果布局包含多个文本段落,显示的总行数可能比这个值多。默认值 -1 表示每段的第一行会省略。这种行为在将来可能会改为按布局而不是按段落实施。如果你的代码依赖于这个行为,请在 https://gitlab.gnome.org/gnome/pango 上提交一个bug。

只有当在 layout 上设置了一个正宽度,且 layout 的省略号模式不是 PANGO_ELLIPSIZE_NONE 时,高度设置才有效。如果设置了除了 -1 以外的其他高度值,且省略号模式设置为 PANGO_ELLIPSIZE_NONE,行为是未定义的,并且可能在将来更改。

自:1.20版本起可用

参数

height

类型: int

如果为正数,为布局在 Pango 单位中希望的高度;如果为负数,为希望显示的行数。