Class
Adw.HeaderBar
Description [src]
final class Adw.HeaderBar : Gtk.Widget {
/* No available fields */
}
A title bar widget.
AdwHeaderBar
is similar to GtkHeaderBar
, but provides additional
features compared to it. Refer to GtkHeaderBar
for details.
AdwHeaderBar:centering-policy
allows to enforce strict centering of
the title widget, this is useful for AdwViewSwitcherTitle
.
AdwHeaderBar:show-start-title-buttons
and
AdwHeaderBar:show-end-title-buttons
allow to easily create split
header bar layouts using AdwLeaflet
, as follows:
<object class="AdwLeaflet" id="leaflet">
<child>
<object class="GtkBox">
<property name="orientation">vertical</property>
<child>
<object class="AdwHeaderBar">
<binding name="show-end-title-buttons">
<lookup name="folded">leaflet</lookup>
</binding>
</object>
</child>
<!-- ... -->
</object>
</child>
<!-- ... -->
<child>
<object class="GtkBox">
<property name="orientation">vertical</property>
<property name="hexpand">True</property>
<child>
<object class="AdwHeaderBar">
<binding name="show-start-title-buttons">
<lookup name="folded">leaflet</lookup>
</binding>
</object>
</child>
<!-- ... -->
</object>
</child>
</object>
CSS nodes
headerbar
╰── windowhandle
╰── box
├── widget
│ ╰── box.start
│ ├── windowcontrols.start
│ ╰── [other children]
├── [Title Widget]
╰── widget
╰── box.end
├── [other children]
╰── windowcontrols.end
AdwHeaderBar
‘s CSS node is called headerbar
. It contains a windowhandle
subnode, which contains a box
subnode, which contains two widget
subnodes
at the start and end of the header bar, each of which contains a box
subnode with the .start
and .end
style classes respectively, as well as a
center node that represents the title.
Each of the boxes contains a windowcontrols
subnode, see
GtkWindowControls
for details, as well as other children.
Accessibility
AdwHeaderBar
uses the GTK_ACCESSIBLE_ROLE_GROUP
role.
Available since: | 1.0 |
Instance methods
adw_header_bar_get_centering_policy
Gets the policy for aligning the center widget.
Available since: 1.0
adw_header_bar_get_show_end_title_buttons
Gets whether to show title buttons at the end of self
.
Available since: 1.0
adw_header_bar_get_show_start_title_buttons
Gets whether to show title buttons at the start of self
.
Available since: 1.0
adw_header_bar_pack_end
Adds child
to self
, packed with reference to the end of self
.
Available since: 1.0
adw_header_bar_pack_start
Adds child
to self
, packed with reference to the start of the self
.
Available since: 1.0
adw_header_bar_set_centering_policy
Sets the policy for aligning the center widget.
Available since: 1.0
adw_header_bar_set_show_end_title_buttons
Sets whether to show title buttons at the end of self
.
Available since: 1.0
adw_header_bar_set_show_start_title_buttons
Sets whether to show title buttons at the start of self
.
Available since: 1.0
Properties
Adw.HeaderBar:show-end-title-buttons
Whether to show title buttons at the end of the header bar.
Available since: 1.0
Adw.HeaderBar:show-start-title-buttons
Whether to show title buttons at the start of the header bar.
Available since: 1.0