类

GtkListBox

描述 [src]

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

GtkListBox 是垂直列表。

GtkListBox 仅包含 GtkListBoxRow 子级。这些行能够动态排序和筛选，还可以根据行内容动态添加标题。它还允许像典型的列表一样进行键盘和鼠标导航与选择。

使用 GtkListBox 通常是 GtkTreeView 的替代方案，特别是在列表内容具有比 GtkCellRenderer 允许的更复杂的布局时，或者当内容具有交互性（即其中具有按钮）时。

尽管 GtkListBox 必须仅具有 GtkListBoxRow 子级，但是你可以通过 gtk_list_box_prepend()、gtk_list_box_append() 和 gtk_list_box_insert() 向其中添加任何种类的控件，并且列表与控件之间会自动插入一个 GtkListBoxRow 控件。

GtkListBoxRows 能标记为可激活或可选择。如果某行可激活，则用户尝试激活它时将为此行触发 GtkListBox::row-activated。如果某行可选择，则用户尝试选择它时将把该行标记为已选择。

GtkListBox 作为 GtkBuildable

GtkListBox 实现的 GtkBuildable 接口支持将子元素设置为占位符，方法是将 <child> 元素的 “type” 属性指定为 “placeholder”。有关信息，请参见 gtk_list_box_set_placeholder()。

快捷键和手势

以下信号具有默认快捷键绑定

CSS 节点

list[.separators][.rich-list][.navigation-sidebar][.boxed-list]
╰── row[.activatable]

GtkListBox 使用名为 list 的单个 CSS 节点。当设置 GtkListBox:show-separators 属性时，它可能带有 .separators 样式类。每个 GtkListBoxRow 使用名为 row 的单个 CSS 节点。在适当的时候，行节点会添加 .activatable 样式类。

它也可能带有 .boxed-list 样式类。在这种情况下，列表会自动且框架包围，并带有分隔符。

主列表节点也可能会带有样式类来选择列表显示的样式：.rich-list、.navigation-sidebar 或 .data-table。

辅助功能

GtkListBox 使用 GTK_ACCESSIBLE_ROLE_LIST 角色，GtkListBoxRow 使用 GTK_ACCESSIBLE_ROLE_LIST_ITEM 角色。

层次结构

祖先

实现

构造函数

gtk_list_box_new

创建新的 GtkListBox 容器。

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