类

Gtk笔记本

描述 [src]

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

GtkNotebook 是一种容器，用户可以用标签在子项页面间切换。

An example GtkNotebook

GtkNotebook 有许多配置选项。除了其他选项之外，您还可以选择标签显示在哪条边上（参见 gtk_notebook_set_tab_pos()），如果标签太多而放不下，是将笔记本做得更大还是添加滚动箭头（参见 gtk_notebook_set_scrollable()），以及是否会有允许用户切换页面的弹出菜单。（参见 gtk_notebook_popup_enable()）。

作为 GtkBuildable 的 GtkNotebook

GtkNotebook 对 GtkBuildable 接口的实现支持将子项放入标签中，方法是将“标签”指定为 <child> 元素的“类型”属性。请注意，必须先创建标签的内容，才能填充标签。可以指定一个标签子项，而不指定 <child> 类型属性。

要在笔记本操作区域中添加一个子项小组件，请将“操作开始”或“操作结束”指定为 <child> 元素的“类型”属性。

带有 GtkNotebook 的 UI 定义片段示例

<object class="GtkNotebook">
  <child>
    <object class="GtkLabel" id="notebook-content">
      <property name="label">Content</property>
    </object>
  </child>
  <child type="tab">
    <object class="GtkLabel" id="notebook-tab">
      <property name="label">Tab</property>
    </object>
  </child>
</object>

快捷方式和手势

GtkNotebook 支持以下键盘快捷方式

Shift+F10 或 Menu 打开上下文菜单。
Home 将焦点移至第一个标签。
End 将焦点移至最后一个标签。

此外，以下信号具有默认键位绑定

标签支持在具有相同 group-name 的笔记本之间拖放，或者通过处理 ::create-window 信号来拖放到新窗口。

操作

GtkNotebook 定义了一组内置操作

menu.popup 打开选项卡上下文菜单。

CSS 节点

notebook
├── header.top
│   ├── [<action widget>]
│   ├── tabs
│   │   ├── [arrow]
│   │   ├── tab
│   │   │   ╰── <tab label>
┊   ┊   ┊
│   │   ├── tab[.reorderable-page]
│   │   │   ╰── <tab label>
│   │   ╰── [arrow]
│   ╰── [<action widget>]
│
╰── stack
    ├── <child>
    ┊
    ╰── <child>

GtkNotebook 有一个名称为 notebook 的主 CSS 节点，一个名称为 header 的子节点，以及在其下面一个名称为 tabs 的子节点，其中包含一个名称为 tab 的每个选项卡的子节点。

如果存在操作小组件，它们的 CSS 节点将放置在 tabs 节点的旁边。如果笔记本是可以滚动的，名称为 arrow 的 CSS 节点将作为 tabs 节点的第一个和最后一个子项放置。

当笔记本有边框时（请参阅 gtk_notebook_set_show_border()），主节点获取 .frame 样式类。

根据标签放置的位置，头节点获取 .top、.bottom、.left 或 .right 之一作为样式类。对于可重新排序的页面，标签节点获取 .reorderable-page 类。

tab 节点在通过拖放移动时获取 .dnd 样式类。

无论文本方向如何，这些节点总是从左到右排列。

辅助功能

GtkNotebook 使用以下角色

GTK_ACCESSIBLE_ROLE_GROUP 用于笔记本小组件
GTK_ACCESSIBLE_ROLE_TAB_LIST 用于标签列表
GTK_ACCESSIBLE_ROLE_TAB 角色用于每个标签
GTK_ACCESSIBLE_ROLE_TAB_PANEL 用于每页。

层次结构

祖先

实现

构造函数

gtk_notebook_new

创建一个不含任何页面的新 GtkNotebook 小组件。

从 GtkWidget (162) 继承的方法

有关方法的完整列表，请参阅 GtkWidget。

从 GObject (43) 继承的方法

有关方法的完整列表，请参阅 GObject。

从 GtkBuildable (1) 继承的方法

gtk_buildable_get_buildable_id

获取ID的 buildable 对象。

从 GtkAccessible (1) 继承的属性

GtkAccessible:辅助角色

GtkAccessible 实现的辅助角色。

从GObject (1)继承的信号

GObject::notify

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