接口

GtkScrollable

描述 [src]

interface Gtk.Scrollable : GObject.Object

GtkScrollable 是一个具有原生滚动能力的小部件的接口。

要实现此接口,您应该覆盖 GtkScrollable:hadjustmentGtkScrollable:vadjustment 属性。

创建可滚动小部件

所有可滚动小部件都应执行 以下操作。

  • 当父子小部件设置可滚动的子小部件的调整时,小部件应连接到 GtkAdjustment::value-changed 信号。然后,子小部件应尽快填充调整的属性,这通常意味着立即排队分配并在 Gtk.WidgetClass.size_allocate 实现中填充属性。

  • 由于其首选大小是完全展开小部件的大小,因此可滚动小部件必须能够处理分配不足的情况。这意味着它必须接受传递给它Gtk.WidgetClass.size_allocate 实现的任何值。

  • 当父级将空间分配给可滚动的子小部件时,小部件必须确保调整属性的值正确且是最新的,例如使用 gtk_adjustment_configure()

  • 当任何调整发出 GtkAdjustment::value-changed 信号时,可滚动小部件应滚动其 内容。

先决条件

为了实现 Scrollable,您的类型必须继承自GObject

实例方法

gtk_scrollable_get_border

返回可滚动外侧周围的非滚动边框的大小。

gtk_scrollable_get_hadjustment

检索用于水平 滚动的 GtkAdjustment

gtk_scrollable_get_hscroll_policy

获取水平 GtkScrollablePolicy

gtk_scrollable_get_vadjustment

检索用于垂直 滚动的 GtkAdjustment

gtk_scrollable_get_vscroll_policy

获取垂直 GtkScrollablePolicy

gtk_scrollable_set_hadjustment

设置 GtkScrollable 的水平调整。

gtk_scrollable_set_hscroll_policy

设置 GtkScrollablePolicy

gtk_scrollable_set_vadjustment

设置 GtkScrollable 的垂直调整。

gtk_scrollable_set_vscroll_policy

设置 GtkScrollablePolicy

属性

Gtk.Scrollable:hadjustment

可滚动小组件的水平 GtkAdjustment

Gtk.Scrollable:hscroll-policy

确定何时应开始水平滚动。

Gtk.Scrollable:vadjustment

可滚动小组件的垂直 GtkAdjustment

Gtk.Scrollable:vscroll-policy

确定何时应开始垂直滚动。

接口结构

struct GtkScrollableInterface {
  GTypeInterface base_iface;
  gboolean (* get_border) (
    GtkScrollable* scrollable,
    GtkBorder* border
  );
  
}

没有可用的说明。

接口成员
base_iface
GTypeInterface
 

没有可用的说明。

get_border
gboolean (* get_border) (
    GtkScrollable* scrollable,
    GtkBorder* border
  )
 

没有可用的说明。

虚拟方法

Gtk.Scrollable.get_border

返回可滚动外侧周围的非滚动边框的大小。