GtkHeaderBar

CSS узлы

<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 узел GtkHeaderBar называется headerbar. Он содержит подузел windowhandle, который содержит поднод box, который содержит два поднода box в начале и конце заголовка, а также узел центра, который представляет заголовок.

Каждый из прямоугольников содержит поднод windowcontrols, см. GtkWindowControls для получения подробностей, а также другие дочерние элементы.

Удобство доступа

GtkHeaderBar использует роль GTK_ACCESSIBLE_ROLE_GROUP.

gtk_header_bar_new ()

GtkWidget *
gtk_header_bar_new (void);

Создаёт новый виджет GtkHeaderBar.

gtk_header_bar_set_title_widget ()

void
gtk_header_bar_set_title_widget (GtkHeaderBar *bar,
                                 GtkWidget *title_widget);

Устанавливает заголовок для GtkHeaderBar.

При значении NULL, верхняя панель отобразит заголовок окна, в котором она содержится.

Заголовок должен помочь пользователю идентифицировать текущий вид. Для достижения того же стиля, что и встроенный заголовок, используйте класс стиля «title».

Вы должны установить виджет заголовка в NULL, чтобы метка заголовка окна снова стала видимой.

gtk_header_bar_get_title_widget ()

GtkWidget *
gtk_header_bar_get_title_widget (GtkHeaderBar *bar);

Возвращает виджет заголовка панели. См. gtk_header_bar_set_title_widget().

gtk_header_bar_pack_start ()

void
gtk_header_bar_pack_start (GtkHeaderBar *bar,
                           GtkWidget *child);

Добавляет child в bar, размещая его относительно начала bar.

gtk_header_bar_pack_end ()

void
gtk_header_bar_pack_end (GtkHeaderBar *bar,
                         GtkWidget *child);

Добавляет child в bar, размещая его относительно конца bar.

gtk_header_bar_remove ()

void
gtk_header_bar_remove (GtkHeaderBar *bar,
                       GtkWidget *child);

Удаляет элемент из bar после добавления его с помощью gtk_header_bar_pack_start(), gtk_header_bar_pack_end() или gtk_header_bar_set_title_widget().

gtk_header_bar_set_show_title_buttons ()

void
gtk_header_bar_set_show_title_buttons (GtkHeaderBar *bar,
                                       gboolean setting);

Устанавливает, отображать ли стандартные кнопки заголовка окна (закрыть, максимизировать, минимизировать).

gtk_header_bar_get_show_title_buttons ()

gboolean
gtk_header_bar_get_show_title_buttons (GtkHeaderBar *bar);

Возвращает, отображаются ли стандартные кнопки заголовка окна.

gtk_header_bar_set_decoration-layout ()

void
gtk_header_bar_set_decoration_layout (GtkHeaderBar *bar,
                                      const char *layout);

Устанавливает макет декораций для этой верхней панели, перезаписывая значение “gtk-decoration-layout”.

Существуют веские причины для перезаписи значения, такие как дизайн верхней панели, который не позволяет кнопкам занимать место справа, или предлагает место только для одной кнопки закрытия. Раздельные верхние панели — ещё один пример переопределения.

Формат строки — это имена кнопок, разделённые запятыми. Двоеточие разделяет кнопки, которые должны отображаться слева, от тех, что справа. Распознаваемые имена кнопок: minimize, maximize, close и icon (иконка окна).

Например, «icon:minimize,maximize,close» указывает иконку слева и кнопки minimize, maximize и close справа.

gtk_header_bar_get_decoration-layout ()

const char *
gtk_header_bar_get_decoration_layout (GtkHeaderBar *bar);

Получает макет декораций, установленный с помощью gtk_header_bar_set_decoration_layout().

GtkHeaderBar

typedef struct _GtkHeaderBar GtkHeaderBar;

Свойство “decoration-layout”

  “decoration-layout”        char *

Макет декораций для кнопок. Если это свойство не установлено, используется значение “gtk-decoration-layout”.

См. gtk_header_bar_set_decoration_layout() для получения информации о формате этой строки.

Владелец: GtkHeaderBar

Флаги: Чтение / Запись

Значение по умолчанию: NULL

Свойство “show-title-buttons”

  “show-title-buttons”       gboolean

Определяет, отображать ли кнопки заголовка, такие как «закрыть», «минимизировать», «максимизировать».

Какие кнопки фактически отображаются и где определяется свойством “decoration-layout”, а также состоянием окна (например, кнопка закрытия не будет отображаться, если окно нельзя закрыть).

Владелец: GtkHeaderBar

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

Свойство “title-widget”

  “title-widget”             GtkWidget *

Виджет заголовка для отображения.

Владелец: GtkHeaderBar

Флаги: Чтение / Запись