GtkGridView

描述 [源代码]

final class Gtk.GridView : Gtk.ListBase
  implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Orientable, Gtk.Scrollable {
  /* No available fields */
}

GtkGridView 展示一个大型动态网格的 item。

GtkGridView 使用其工厂为每个可见 item 生成一个子小部件,并以网格形式展示它们。网格视图的方向决定网格是垂直重排还是 水平重排。

GtkGridView 允许用户根据模型的选择特征选择 item。对于允许选择多个 item 的模型,可以使用 GtkGridView:enable-rubberband 启用橡皮筋选择

要了解有关列表小部件框架的更多信息,请参见 概述

操作

GtkGridView 定义了一组内置 操作

CSS 节点

gridview
├── child[.activatable]
│
├── child[.activatable]
│
┊
╰── [rubberband]

GtkGridView 使用单个 CSS 节点,名称为 gridview。每个子节点使用单个 CSS 节点,名称为 child。如果 GtkListItem:activatable 属性已设置,则相应行将具有 .activatable 样式类。对于橡皮筋选择,会使用名为 rubberband 的子节点。

辅助功能

GtkGridView 使用 GTK_ACCESSIBLE_ROLE_GRID 角色,并且 item 使用 GTK_ACCESSIBLE_ROLE_GRID_CELL 角色。

层次结构

hierarchy this GtkGridView implements_0 GtkAccessible this--implements_0 implements_1 GtkBuildable this--implements_1 implements_2 GtkConstraintTarget this--implements_2 implements_3 GtkOrientable this--implements_3 implements_4 GtkScrollable this--implements_4 ancestor_0 GtkListBase ancestor_0--this ancestor_1 GtkWidget ancestor_1--ancestor_0 ancestor_2 GInitiallyUnowned ancestor_2--ancestor_1 ancestor_3 GObject ancestor_3--ancestor_2

构造函数

gtk_grid_view_new

创建一个新的 GtkGridView,它对小部件使用给定的 factory 来映射项目。

实例方法

gtk_grid_view_get_enable_rubberband

返回可以通过用鼠标拖动选择行。

gtk_grid_view_get_factory

获取目前用于填充项目列表的工厂。

gtk_grid_view_get_max_columns

获取网格将使用的最大列数。

gtk_grid_view_get_min_columns

获取网格将使用的最小列数。

gtk_grid_view_get_model

获取目前用于读取显示项目所使用。

gtk_grid_view_get_single_click_activate

返回在单机时激活项目,并且在悬停时选择的项目。

gtk_grid_view_get_tab_behavior

获取为 Tab 键设置的行为。

自:4.12

gtk_grid_view_scroll_to

滚动到给定位置的项目,并且执行 flags 中所指定的动作。

自:4.12

gtk_grid_view_set_enable_rubberband

在用鼠标拖动时设置是否可以选择。

gtk_grid_view_set_factory

设置 GtkListItemFactory,用于填充项目列表。

gtk_grid_view_set_max_columns

设置要使用的最大列数。

gtk_grid_view_set_min_columns

设置要使用的最小列数。

gtk_grid_view_set_model

设置要使用的模型。

gtk_grid_view_set_single_click_activate

设置在单机时应该激活,并且在悬停时应该选择项目。

gtk_grid_view_set_tab_behavior

设置 TabShift+Tab 键的行为。

自:4.12

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 的方向。

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.GridView:enable-rubberband

允许橡皮筋选择。

Gtk.GridView:factory

填充列表项的工厂。

Gtk.GridView:max-columns

每行允许的最大列数。

Gtk.GridView:min-columns

每行允许的最小列数。

Gtk.GridView:model

显示项目的模型。

Gtk.GridView:single-click-activate

单击激活行,并悬停选择它们。

Gtk.GridView:tab-behavior

Tab 键的行为。

自:4.12

GtkListBase 继承的属性 (1)
Gtk.ListBase:orientation

列表的方向。有关详细信息,请参见 GtkOrientable:orientation。

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

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

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

可定向的方向。

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

可滚动控件的水平 GtkAdjustment

GtkScrollable:hscroll-policy

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

GtkScrollable:vadjustment

可滚动控件的垂直 GtkAdjustment

GtkScrollable:vscroll-policy

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

信号

Gtk.GridView::activate

当一个单元被用户激活时发出,通常是通过激活 GtkGridView|list.activate-item 操作实现的。

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

widgetGdkSurface 关联时发出。

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 信号。

类结构

struct GtkGridViewClass {
  /* no available fields */
}

暂无说明。