函数
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_origin
和 y_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
包含给定范围的剪辑区域。
函数调用者拥有数据的权所有权,并负责释放数据。 |