since: 3.12

Declaration [src]

gtk_header_bar_set_decoration_layout (
  GtkHeaderBar* bar,
  const gchar* layout

Description [src]

Sets the decoration layout for this header bar, overriding the GtkSettings:gtk-decoration-layout setting.

There can be valid reasons for overriding the setting, such as a header bar design that does not allow for buttons to take room on the right, or only offers room for a single close button. Split header bars are another example for overriding the setting.

The format of the string is button names, separated by commas. A colon separates the buttons that should appear on the left from those on the right. Recognized button names are minimize, maximize, close, icon (the window icon) and menu (a menu button for the fallback app menu).

For example, “menu:minimize,maximize,close” specifies a menu on the left, and minimize, maximize and close buttons on the right.

Available since: 3.12



Type: const gchar*

A decoration layout, or NULL to unset the layout.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.