GtkViewport

描述 [src]

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

GtkViewport 为缺少自身滚动功能的小组件实现了滚动功能。

使用 GtkViewport 滚动诸如 GtkGridGtkBox 等子小组件。

仅当 GtkViewport 在给定方向的分配量小于子小组件的最小尺寸时,它才会开始滚动内容。

CSS 节点

GtkViewport 有一个名为 viewport 的单个 CSS 节点。

可访问性

直到 GTK 4.10,GtkViewport 才使用 GTK_ACCESSIBLE_ROLE_GROUP 角色。

GTK 4.12 开始,GtkViewport 使用 GTK_ACCESSIBLE_ROLE_GENERIC 角色。

层级

hierarchy this GtkViewport implements_0 GtkAccessible this--implements_0 implements_1 GtkBuildable this--implements_1 implements_2 GtkConstraintTarget this--implements_2 implements_3 GtkScrollable this--implements_3 ancestor_0 GtkWidget ancestor_0--this ancestor_1 GInitiallyUnowned ancestor_1--ancestor_0 ancestor_2 GObject ancestor_2--ancestor_1

构造函数

gtk_viewport_new

创建一个新的 GtkViewport

实例方法

gtk_viewport_get_child

获取 viewport 的子小组件。

gtk_viewport_get_scroll_to_focus

获取视口是否滚动以将焦点的子元素保持在视 图中。

gtk_viewport_scroll_to

将视口的子项滚动到视 图中。

自:4.12

gtk_viewport_set_child

设置 viewport 的子小组件。

gtk_viewport_set_scroll_to_focus

设置视口是否应自动滚动以将焦点的子元素保持在视 图中。

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

GtkScrollable 继承的方法 (9)
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.Viewport:child

子小部件。

Gtk.Viewport:scroll-to-focus

焦点更改时是否滚动。

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` 实现的可访问角色。

GtkScrollable (4 个)继承的属性
GtkScrollable:hadjustment

滚动窗口小组件的水平 `GtkAdjustment`。

GtkScrollable:hscroll-policy

确定何时开始水平滚动。

GtkScrollable:vadjustment

滚动窗口小组件的垂直 `GtkAdjustment`。

GtkScrollable:vscroll-policy

确定何时开始垂直滚动。

信号

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() 等设置其属性值的其中一个属性值时,notify 信号会在该对象上发出。