类

GtkScrolledWindow

说明 [src]

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

GtkScrolledWindow 是一个容器，使它的子内容可滚动。

它使用内部添加的滚动条或外部关联的调整来执行此操作，并且可以选择在子内容周围绘制一个框架。

支持本机滚动功能的小组件，即其类实现了 GtkScrollable 接口，将直接添加。对于其他类型的组件，GtkViewport 类充当适配器，使得其他组件具有滚动性。 gtk_scrolled_window_set_child() 会智能地检测添加的子项是否是 GtkScrollable。如果不是，它会将子项包装在 GtkViewport 中。因此，您只需添加任何子项小组件，无需担心详情。

如果 gtk_scrolled_window_set_child() 为您添加了 GtkViewport，那么当您取消设置子项时，它将自动删除。除非 GtkScrolledWindow:hscrollbar-policy 和 GtkScrolledWindow:vscrollbar-policy 为 GTK_POLICY_NEVER 或 GTK_POLICY_EXTERNAL，否则 GtkScrolledWindow 会围绕其子项添加内部 GtkScrollbar 小组件。子项和滚动条（如果适用）的滚动位置由与 GtkScrolledWindow 关联的 GtkScrolledWindow:hadjustment 和 GtkScrolledWindow:vadjustment 控制。关于该功能的详细信息请参阅 GtkScrollbar 的相关文档，但请注意，“step_increment”和“page_increment”字段仅在策略导致存在滚动条时才有效。

如果 GtkScrolledWindow 的行为与您的预期不符，或者布局不完全正确，完全可以使用 GtkScrollbar 和例如 GtkGrid 设置滚动。

触控支持

GtkScrolledWindow 内置了对触控设备的支持。使用触摸屏时，滑动将移动滚动窗口，并呈现“动能”行为。如果不需要这种行为，可以使用 GtkScrolledWindow:kinetic-scrolling 属性关闭它。

当内容被拉出末端时，GtkScrolledWindow 还会显示视觉“超调”指示，可以通过 GtkScrolledWindow::edge-overshot 信号捕获此情况。

如果没有鼠标设备，滚动条将以窄边框的形式叠加在内容上，并自动隐藏。如果希望使用传统的滚动条，但没有鼠标，可以使用 GtkScrolledWindow:overlay-scrolling 属性关闭此行为。

快捷方式和手势

以下信号具有默认快捷键

GtkScrolledWindow::scroll-child

CSS 节点

GtkScrolledWindow 有一个名称为 scrolledwindow 的主 CSS 节点。当 GtkScrolledWindow:has-frame 为 TRUE 时，它会添加一个 .frame 样式类。

它使用名称为 overshoot 和 undershoot 的子节点绘制溢出和欠流指示。这些节点会添加 .left、.right、.top 或 .bottom 样式类，具体取决于指示绘制的位置。

GtkScrolledWindow 还会在滚动条上设置位置样式类（.left、.right、.top、.bottom）和与叠加滚动相关的样式类（.overlay-indicator、.dragging、.hovering）。

如果两个滚动条都可见，它们相遇的区域将用名称为 junction 的子节点绘制。

可访问性

在 GTK 4.10 之前，GtkScrolledWindow 使用了 GTK_ACCESSIBLE_ROLE_GROUP 角色。

从 GTK 4.12 开始，GtkScrolledWindow 使用 GTK_ACCESSIBLE_ROLE_GENERIC 角色。

层次结构

祖先

实现

构造函数

gtk_scrolled_window_new

创建一个新的滚动窗口。

从 GtkWidget （162）继承的方法

请参见 GtkWidget 以获取方法的完整列表。

从 GObject （43）继承的方法

请参见 GObject 以获取方法的完整列表。

从 GtkBuildable（1）继承的方法

gtk_buildable_get_buildable_id

获取buildable对象的ID。

从 GtkAccessible（1）继承的属性

GtkAccessible:accessible-role

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

从 GObject 继承的信号（1）

GObject::notify

触发 notify 信号时通过 g_object_set_property()、g_object_set() 等方法设置对象某个属性的值。