类

GtkPaned

描述 [src]

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

带有两个窗格的小组件，水平或垂直排列。

An example GtkPaned

用户可以通过拖动一个控制手柄来调整两个窗格之间的分隔。

子小组件通过 gtk_paned_set_start_child() 和 gtk_paned_set_end_child() 添加到小组件的窗格。两个子组件之间的分隔默认根据子组件的大小请求进行设置，但用户可以调整它。

如果缺少其中一个子组件，则不会绘制分隔符。一个 paned 小组件在两个子组件之间绘制一个分隔符和一个用于调整分隔的小控制手柄。它不会在子组件或分隔符周围绘制任何凸起。（分隔符所在的区域称为槽。）通常，将每个子组件放入 GtkFrame 中非常有用，这样槽就会显示为一个脊。如果没有，则不绘制分隔符。

每个子项都可以设置两个选项，“调整大小”和“收缩”。如果“调整大小”为 true，则当 GtkPaned 大小时，该子项将随着窗格小部件一起展开或收缩。如果“收缩”为 true，则用户可以使该子项小于其请示。将“收缩”设置为 false 允许应用程序设置最小大小。如果两个子项的“调整大小”都是 false，则视为两个子项都将“调整大小”设置为 true。

应用程序可以通过调用 gtk_paned_set_position() 设置滑块的位置，就像由用户设置一样。

快捷键和手势

以下信号具有默认的键位绑定

CSS 节点

paned
├── <child>
├── separator[.wide]
╰── <child>

GtkPaned 有一个带有名称 paned 的主 CSS 节点，和一个带有名称 separator 的分隔符子节点。如果窗格应该变宽，该子节点会获取一个 .wide 样式类。

在水平方向上，这些节点将根据文本方向进行排列，因此在从左到右模式中，:first-child 将选择最左边的子项，而在 RTL 布局中，它将选择最右边的子项。

GtkWidget *hpaned = gtk_paned_new (GTK_ORIENTATION_HORIZONTAL);
GtkWidget *frame1 = gtk_frame_new (NULL);
GtkWidget *frame2 = gtk_frame_new (NULL);

gtk_widget_set_size_request (hpaned, 200, -1);

gtk_paned_set_start_child (GTK_PANED (hpaned), frame1);
gtk_paned_set_resize_start_child (GTK_PANED (hpaned), TRUE);
gtk_paned_set_shrink_start_child (GTK_PANED (hpaned), FALSE);
gtk_widget_set_size_request (frame1, 50, -1);

gtk_paned_set_end_child (GTK_PANED (hpaned), frame2);
gtk_paned_set_resize_end_child (GTK_PANED (hpaned), FALSE);
gtk_paned_set_shrink_end_child (GTK_PANED (hpaned), FALSE);
gtk_widget_set_size_request (frame2, 50, -1);

层次结构

祖先

实现

构造函数

gtk_paned_new

创建新的 GtkPaned 小部件。

从 GtkWidget 继承的方法 (162)

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

从 GObject 继承的方法 (43)

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

从 GtkBuildable 继承的方法 (1)

gtk_buildable_get_buildable_id

获取 buildable 对象的 ID。

从 GtkOrientable 继承的方法 (2)

gtk_orientable_get_orientation

检索 orientable 的方向。

gtk_orientable_set_orientation

设置 orientable 的方向。

从 GtkAccessible（1）继承的属性

GtkAccessible:accessible-role

给定的 `GtkAccessible` 实现的可访问角色。

从 GtkOrientable（1）继承的属性

GtkOrientable:orientation

可定向组件的方向。

从 GObject 继承的信号 (1)

GObject::notify

当一个对象的某个属性通过 g_object_set_property()、g_object_set() 等设置值时，会在该对象上发出通知信号。