函数

Gdkpango_layout_get_clip_region

声明 [源代码]

cairo_region_t*
gdk_pango_layout_get_clip_region (
  PangoLayout* layout,
  int x_origin,
  int y_origin,
  const int* index_ranges,
  int n_ranges
)

说明 [源代码]

获取剪辑区域,其中包含将显示的文本范围的区域。

x_originy_origin 是居中布局的左上角点。index_ranges 应包含该布局中的字节范围 的文字。

请注意,返回的区域与文本范围的逻辑范围相对应,而不是墨水范围。因此,绘制的布局实际上可能会接触剪辑区域之外的区域。剪辑区域主要用于突出显示文本的某些部分,例如,在选择文本时。

此函数不对语言绑定直接可用。

参数

layout

类型: PangoLayout

一个 PangoLayout

数据归函数调用者所有。
x_origin

类型: int

使用此剪辑在其中绘制布局的 X 像素。

y_origin

类型: int

Y 像素,您打算使用此剪辑在其中绘制布局。

index_ranges

类型: const int*

布局中的字节索引数组,其中数组的偶数成员为开始索引,奇数元素为结束索引。

数据归函数调用者所有。
n_ranges

类型: int

index_ranges 中的范围数,即 index_ranges 大小的一半。

返回值

类型: cairo_region_t

包含给定范围的剪辑区域。

函数调用者拥有数据的权所有权,并负责释放数据。