GtkScrollbar

描述 [src]

final class Gtk.Scrollbar : Gtk.Widget
  implements Gtk.Accessible, Gtk.AccessibleRange, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Orientable {
  /* No available fields */
}

GtkScrollbar 小部件是一个水平或垂直滚动条。

An example GtkScrollbar

它的位置和移动由传递给或由 gtk_scrollbar_new() 创建的调整控制。有关详细信息,请参阅 GtkAdjustmentGtkAdjustment:value 字段设置滑块的位置,并且必须介于 GtkAdjustment:lowerGtkAdjustment:upper - GtkAdjustment:page-size 之间。 GtkAdjustment:page-size 表示可见可滚动区域的大小。

当用户要求按步长(例如使用光标箭头键)或按页面(例如使用向下/向上翻页键)移动时,字段 GtkAdjustment:step-incrementGtkAdjustment:page-increment 会被添加到或从 GtkAdjustment:value 中减去。

CSS 节点

scrollbar
╰── range[.fine-tune]
    ╰── trough
        ╰── slider

GtkScrollbar 具有名称为 scrollbar 的主 CSS 节点及其内容的子节点。主节点应用 .horizontal 或 .vertical 样式类,具体取决于滚动条的方向。

当滚动条处于“微调”模式时,范围节点会添加样式类 .fine-tune。

滚入 GtkScrolledWindow 内的滚动条中可能会添加的其他样式类包括位置类(.left、.right、top、.bottom)和与覆盖滚动相关的样式类(.overlay-indicator、.dragging、.hovering)。

辅助功能

GtkScrollbar 使用 GTK_ACCESSIBLE_ROLE_SCROLLBAR 角色。

层次结构

hierarchy this GtkScrollbar implements_0 GtkAccessible this--implements_0 implements_1 GtkAccessibleRange this--implements_1 implements_2 GtkBuildable this--implements_2 implements_3 GtkConstraintTarget this--implements_3 implements_4 GtkOrientable this--implements_4 ancestor_0 GtkWidget ancestor_0--this ancestor_1 GInitiallyUnowned ancestor_1--ancestor_0 ancestor_2 GObject ancestor_2--ancestor_1

构造函数

gtk_scrollbar_new

使用给定的方向创建新的滚动条。

实例方法

gtk_scrollbar_get_adjustment

返回滚动条的调整。

gtk_scrollbar_set_adjustment

使滚动条使用给定的调整。

GtkWidget 继承的方法 (162)

有关完整方法列表,请参阅 GtkWidget

GObject 继承的方法 (43)

有关完整方法列表,请参阅 GObject

GtkAccessible 继承的方法 (19)
gtk_accessible_announce

要求用户的屏幕阅读器播报给定的消息。

自: 4.14

gtk_accessible_get_accessible_parent

检索可访问对象的辅助父级。

自: 4.10

gtk_accessible_get_accessible_role

检索可访问对象的辅助角色。

gtk_accessible_get_at_context

检索给定可访问对象的实现。

自: 4.10

gtk_accessible_get_bounds

查询此可访问对象的坐标和维度。

自: 4.10

gtk_accessible_get_first_accessible_child

检索可访问对象的第一个可访问子项。

自: 4.10

gtk_accessible_get_next_accessible_sibling

检索可访问对象的下一个可访问兄弟项。

自: 4.10

gtk_accessible_get_platform_state

查询平台状态(例如焦点)。

自: 4.10

gtk_accessible_reset_property

将可访问属性重置为其默认值。

gtk_accessible_reset_relation

将可访问关系重置为其默认值。

gtk_accessible_reset_state

将可访问状态重置为其默认值。

gtk_accessible_set_accessible_parent

设置可访问对象的父项和兄弟项。

自: 4.10

gtk_accessible_update_next_accessible_sibling

更新下一个可访问的兄弟项。

自: 4.10

gtk_accessible_update_property

更新可访问属性列表。

gtk_accessible_update_property_value

更新一个可访问属性数组。

gtk_accessible_update_relation

更新可访问关系列表。

gtk_accessible_update_relation_value

更新一个可访问关系数组。

gtk_accessible_update_state

更新可访问状态列表。

gtk_accessible_update_state_value

更新一个可访问状态数组。

GtkBuildable(1)继承的方法
gtk_buildable_get_buildable_id

获取 buildable 对象的 ID

GtkOrientable(2)继承的方法
gtk_orientable_get_orientation

检索 orientable 的方向。

gtk_orientable_set_orientation

设置 orientable 的方向。

属性

Gtk.Scrollbar:adjustment

此滚动条控制的 GtkAdjustment

GtkWidget(34)继承的属性
Gtk.Widget:can-focus

该控件或其任何子代是否可以接受输入焦点。

Gtk.Widget:can-target

该控件是否可以接收指针事件。

Gtk.Widget:css-classes

应用于此控件的 css 类别列表。

Gtk.Widget:css-name

此控件在 CSS 树中的名称。

Gtk.Widget:cursor

widget 使用的游标。

Gtk.Widget:focus-on-click

当使用鼠标单击时,该控件是否应获取焦点。

Gtk.Widget:focusable

此小部件本身是否接受输入焦点。

Gtk.Widget:halign

如果小部件获取额外空间,如何分配水平空间。

Gtk.Widget:has-default

该控件是否是默认控件。

Gtk.Widget:has-focus

该小部件是否有输入焦点。

Gtk.Widget:has-tooltip

启用或禁用在 widget 上发出 GtkWidget::query-tooltip 信号。

Gtk.Widget:height-request

跳过对小部件高度的请求。

Gtk.Widget:hexpand

是否水平扩展。

Gtk.Widget:hexpand-set

是否使用 hexpand 属性。

Gtk.Widget:layout-manager

用于计算小部件首选大小并分配其子项的 GtkLayoutManager 实例。

Gtk.Widget:margin-bottom

在小部件底部边缘的边距。

Gtk.Widget:margin-end

在水平方向上小部件末尾的边距。

Gtk.Widget:margin-start

在水平方向上小部件开头的边距。

Gtk.Widget:margin-top

在小部件顶部边缘的边距。

Gtk.Widget:name

小部件的名称。

Gtk.Widget:opacity

小部件请求的不透明度。

Gtk.Widget:overflow

超出窗口区域内容的处理方式。

Gtk.Widget:parent

该窗口的父窗口。

Gtk.Widget:receives-default

当窗口获得焦点时窗口是否会收到默认操作。

Gtk.Widget:root

包含此窗口的窗口树的GtkRoot窗口。

Gtk.Widget:scale-factor

窗口的缩放比例。

Gtk.Widget:sensitive

窗口是否响应输入。

Gtk.Widget:tooltip-markup

使用 Pango 标记将工具提示文本设置为给定的字符串。

Gtk.Widget:tooltip-text

将工具提示文本设置为给定的字符串。

Gtk.Widget:valign

当窗口获得额外空间时的垂直空间分布方式。

Gtk.Widget:vexpand

是否在垂直方向上扩展。

Gtk.Widget:vexpand-set

是否使用`vexpand`属性。

Gtk.Widget:visible

窗口是否可见。

Gtk.Widget:width-request

覆盖窗口的宽度请求。

GtkAccessible (1) 继承的属性
GtkAccessible:accessible-role

给定 `GtkAccessible` 实现的可访问角色。

GtkOrientable (1) 继承的属性
GtkOrientable:orientation

可定向窗口的方向。

信号

GtkWidget (13) 继承的信号
GtkWidget::destroy

当所有持有窗口的引用的持有者都应释放其持有的引用时发出的信号。

GtkWidget::direction-changed

当窗口的文本方向更改时发出。

GtkWidget::hide

当 `widget` 隐藏时发出。

GtkWidget::keynav-failed

当键盘导航失败时发出。

GtkWidget::map

当 `widget` 准备映射时发出。

GtkWidget::mnemonic-activate

当通过助记符激活小部件时发出。

GtkWidget::move-focus

当焦点移动时发出。

GtkWidget::query-tooltip

当窗口的工具提示即将显示时发出。

GtkWidget::realize

当 `widget` 与 `GdkSurface` 关联时发出。

GtkWidget::show

当 `widget` 显示时发出。

GtkWidget::state-flags-changed

当窗口状态更改时发出。

GtkWidget::unmap

当 `widget` 准备取消映射时发出。

GtkWidget::unrealize

当与 `widget` 关联的 `GdkSurface` 被销毁时发出。

GObject (1) 继承的信号
GObject::notify

当对象的一个属性通过 g_object_set_property()、g_object_set() 等设置其值时,在对象上发出通知信号。