方法

GtkTextViewscroll_to_iter

声明 [src]

gboolean
gtk_text_view_scroll_to_iter (
  GtkTextView* text_view,
  GtkTextIter* iter,
  double within_margin,
  gboolean use_align,
  double xalign,
  double yalign
)

描述 [src]

text_view滚动,使iter在屏幕上位于xalignyalign指示的位置。

对齐值为0.0表示左或顶边,1.0表示右或底边,0.5表示居中。如果use_alignFALSE,文本只滚动到足以使标记出现在屏幕上的最小距离,可能根本不滚动。此函数的有效屏幕尺寸会因within_margin大小的边距而减少。

注意,此函数使用文本缓冲区中行的当前计算高度。行高是在空闲处理程序中计算的;因此,如果在高度计算之前调用此函数,可能无法达到期望的效果。为了避免异常,请考虑使用gtk_text_view_scroll_to_mark(),它可以在行验证后保存一个要滚动的点。

参数

iter

类型: GtkTextIter

GtkTextIter

数据由方法调用者所有。
within_margin

类型: double

屏幕大小的[0.0,0.5)分数形式的边距。

use_align

类型: gboolean

是否使用对齐参数(如果FALSE,则仅将标记显示在屏幕上)。

xalign

类型: double

标记在可视区域内的水平对齐。

yalign

类型: double

标记在可视区域内的垂直对齐。

返回值

类型: gboolean

TRUE如果滚动发生。