类
GtkScrollbar
描述 [src]
final class Gtk.Scrollbar : Gtk.Widget
implements Gtk.Accessible, Gtk.AccessibleRange, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Orientable {
/* No available fields */
}
GtkScrollbar
小部件是一个水平或垂直滚动条。
它的位置和移动由传递给或由 gtk_scrollbar_new()
创建的调整控制。有关详细信息,请参阅 GtkAdjustment
。 GtkAdjustment:value
字段设置滑块的位置,并且必须介于 GtkAdjustment:lower
和 GtkAdjustment:upper
- GtkAdjustment:page-size
之间。 GtkAdjustment:page-size
表示可见可滚动区域的大小。
当用户要求按步长(例如使用光标箭头键)或按页面(例如使用向下/向上翻页键)移动时,字段 GtkAdjustment:step-increment
和 GtkAdjustment: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
角色。
实例方法
从 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)继承的方法
从 GtkOrientable(2)继承的方法
属性
从 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) 继承的属性
从 GtkOrientable (1) 继承的属性
信号
从 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() 等设置其值时,在对象上发出通知信号。