类

GtkTreeExpander

描述 [src]

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

GtkTreeExpander 是一个为列表提供扩展功能的小部件。

它通常作为 GtkListView 的最底层子项放置，以允许用户在带有 GtkTreeListModel 的列表中展开和折叠子项。 GtkTreeExpander 为此目的提供了常见的UI元素、手势和键绑定。

除此之外，还提供了“listitem.expand”、“listitem.collapse”和“listitem.toggle-expand”操作，以允许添加用于管理已扩展状态的自定义UI。

值得一提的是，使用此小部件时，您需要将 GtkListItem:focusable 属性设置为FALSE，因为您希望键盘焦点位于扩展器中，而不是列表中以使用键绑定。

GtkTreeListModel 必须设置为非直通。然后它将提供 GtkTreeListRow 项，这些项可以通过扩展器上的 gtk_tree_expander_set_list_row() 设置。然后，扩展器将自动监视该行项。 gtk_tree_expander_set_child() 设置显示实际行内容的小部件。

GtkTreeExpander 可以使用属性（如 GtkTreeExpander:indent-for-icon、 GtkTreeExpander:indent-for-depth 和 GtkTreeExpander:hide-expander）进行修改，以实现不同的外观。甚至可以通过此方法影响各个行，例如将 GtkTreeExpander:hide-expander 属性绑定到列表行模型的项目计数，以隐藏没有子项的行扩展器，即使该行是可扩展的。.

快捷方式和手势

GtkTreeExpander 控件支持下列键盘快捷键

+ 或 * 展开扩展器。
- 或 / 折叠扩展器。
与 Shift 或 Ctrl+Shift 结合使用时，左右箭头键将根据当前区域的文本方向，进行展开或折叠。
Ctrl+␣ 切换扩展器状态。

该行还可以通过拖拽手势扩展。

操作

GtkTreeExpander 定义了一组内建操作

listitem.展开如果可扩展，则展开扩展器。
listitem.折叠折叠扩展器。
listitem.切换扩展如果扩展器已折叠，则尝试展开它，如果已展开，则尝试折叠它。

CSS 节点

treeexpander
├── [indent]*
├── [expander]
╰── <child>

GtkTreeExpander具有零个或一个名为“expander”的CSS 节点，它将显示扩展器图标。扩展后，该节点将变为:checked。如果该节点不可扩展，则会显示一个“ident”节点代替它。

对于每个深度级别，都会前置另一个“ident”节点。

无障碍

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

从GTK 4.12 开始，GtkTreeExpander改用GTK_ACCESSIBLE_ROLE_BUTTON角色。切换该角色将改变GTK_ACCESSIBLE_STATE_EXPANDED状态。

层次结构

祖先

实施

构造函数

gtk_tree_expander_new

创建一个新的GtkTreeExpander。

从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

当对象的属性值通过 g_object_set_property()、g_object_set() 等设置时，notify 信号会发出。

类结构

struct GtkTreeExpanderClass {
  GtkWidgetClass parent_class;
  
}

无可用描述。

类成员

parent_class: GtkWidgetClass: 无可用描述。