类

GtkHeaderBar

说明 [src]

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

用于创建自定义 windows 标题栏的小组件。

An example GtkHeaderBar

GtkHeaderBar 与水平 GtkCenterBox 类似。它允许在开始或末尾放置子项。此外，它允许显示窗口标题。标题将根据框的宽度居中，即使两侧的子项占用不同的空间也是如此。

GtkHeaderBar 可以添加标准的窗口框架控件，例如最小化、最大化和关闭按钮或窗口图标。

出于这些原因，GtkHeaderBar 是用作 GtkWindow 自定义标题栏小组件的自然选择（参见 gtk_window_set_titlebar()），因为它提供标题栏的典型功能，同时允许添加子项小组件。

GtkHeaderBar 作为 GtkBuildable

GtkHeaderBar 对 GtkBuildable 接口的实现支持在开始或结束侧添加子项，方法是将 <child> 元素的 “type” 属性指定为 “start” 或 “end”，或者通过指定 “title” 值设置标题小组件。

默认情况下，GtkHeaderBar 使用 GtkLabel 显示它所在窗口的标题作为标题小组件，相当于以下 UI 定义

<object class="GtkHeaderBar">
  <property name="title-widget">
    <object class="GtkLabel">
      <property name="label" translatable="yes">Label</property>
      <property name="single-line-mode">True</property>
      <property name="ellipsize">end</property>
      <property name="width-chars">5</property>
      <style>
        <class name="title"/>
      </style>
    </object>
  </property>
</object>

CSS 节点

headerbar
╰── windowhandle
    ╰── box
        ├── box.start
        │   ├── windowcontrols.start
        │   ╰── [other children]
        ├── [Title Widget]
        ╰── box.end
            ├── [other children]
            ╰── windowcontrols.end

GtkHeaderBar 的 CSS 节点称为 headerbar。它包含一个 windowhandle 子节点，其中包含一个 box 子节点，该子节点在标题栏的开始和结束位置包含两个 box 子节点，以及表示标题的中心节点。

每个框都包含一个 windowcontrols 子节点，有关详细信息，请参见 GtkWindowControls，以及其他子项。

辅助功能

GtkHeaderBar 使用 GTK_ACCESSIBLE_ROLE_GROUP 角色。

层级

父类

实现

构造函数

gtk_header_bar_new

创建一个新的 GtkHeaderBar 小组件。

从 GtkWidget (162) 继承的方法

请参阅 GtkWidget 以获取方法的完整列表。

从 GObject (43) 继承的方法

请参阅 GObject 以获取方法的完整列表。

从 GtkBuildable (1) 继承的方法

gtk_buildable_get_buildable_id

获取 GtkBuildable 对象的 ID。

从 GtkAccessible (1) 继承的属性

GtkAccessible:accessible-role

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

信号

继承自 GObject（1）发出的信号

GObject::notify

将一个对象的一个属性的值设为通过 g_object_set_property()、g_object_set() 等设置的值时，该对象就会发出 notify 信号。