GtkWindowControls
GtkWindowControls — Виджет, отображающий кнопки окна
Функции
| GtkWidget * | gtk_window_controls_new () |
| GtkPackType | gtk_window_controls_get_side () |
| void | gtk_window_controls_set_side () |
| const char * | gtk_window_controls_get_decoration_layout () |
| void | gtk_window_controls_set_decoration-layout () |
| gboolean | gtk_window_controls_get_empty () |
Свойства
| char * | decoration-layout | Чтение/Запись |
| gboolean | empty | Чтение |
| GtkPackType | side | Чтение/Запись |
Типы и значения
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkWindowControls
Реализованные интерфейсы
GtkWindowControls реализует GtkAccessible, GtkBuildable и GtkConstraintTarget.
Файлы заголовков
#include <gtk/gtk.h>
Описание
GtkWindowControls отображает элементы управления рамкой окна, такие как кнопки «Свернуть», «Развернуть» и «Закрыть», а также значок окна.
GtkWindowControls отображает только кнопки со стороны начала или конца (см. «side»), поэтому он всегда должен использоваться в паре с другим GtkWindowControls, использующим противоположную сторону, например:
Узлы CSS
<object class="GtkBox">
<child>
<object class="GtkWindowControls">
<property name="side">start</property>
</object>
</child>
...
<child>
<object class="GtkWindowControls">
<property name="side">end</property>
</object>
</child>
</object>Узел CSS GtkWindowControls называется windowcontrols. Он содержит подузлы, соответствующие каждой кнопке заголовка. Наличие и расположение кнопок заголовка зависят от среды рабочего стола и значения «decoration-layout».
Когда «empty» равно TRUE, к нему добавляется класс стиля .empty.
Доступность
GtkWindowHandle использует роль GTK_ACCESSIBLE_ROLE_GROUP.
Детали функций
gtk_window_controls_new ()
GtkWidget *
gtk_window_controls_new (GtkPackType side); Создаёт новый GtkWindowControls.
Параметры
side | сторона |
Возвращаемое значение
новый GtkWindowControls.
gtk_window_controls_get_side ()
GtkPackType
gtk_window_controls_get_side (GtkWindowControls *self); Возвращает сторону, установленную с помощью gtk_window_controls_set_side().
Параметры
self |
Возвращаемое значение
сторону
gtk_window_controls_set_side ()
void gtk_window_controls_set_side (GtkWindowControls *self,GtkPackType side);
Устанавливает сторону для self, определяя, какой части макета оформления она использует.
См. gtk_window_controls_set_decoration_layout()
Параметры
self | ||
side | сторона |
gtk_window_controls_get_decoration-layout ()
const char *
gtk_window_controls_get_decoration_layout
(GtkWindowControls *self); Возвращает макет оформления, установленный с помощью gtk_window_controls_set_decoration_layout().
Параметры
self |
Возвращаемое значение
макет оформления или NULL , если он не установлен.
[nullable]
gtk_window_controls_set-decoration-layout ()
void gtk_window_controls_set_decoration_layout (GtkWindowControls *self,const char *layout);
Устанавливает макет оформления для кнопок заголовка, переопределяя настройку «gtk-decoration-layout».
Формат строки — имена кнопок, разделенные запятыми. Двоеточие разделяет кнопки, которые должны отображаться слева, от тех, которые должны отображаться справа. Распознаваемые имена кнопок — minimize, maximize, close и icon (значок окна).
Например, «icon:minimize,maximize,close» задает значок слева и кнопки «Свернуть», «Развернуть» и «Закрыть» справа.
Если значение «side» равно GTK_PACK_START , self будет отображать часть перед двоеточием, в противном случае после него.
Параметры
self | ||
layout | макет оформления или | [nullable] |
gtk_window_controls_get_empty ()
gboolean
gtk_window_controls_get_empty (GtkWindowControls *self); Возвращает значение, указывающее, содержит ли видет какие-либо кнопки окна.
Параметры
self |
Возвращаемое значение
TRUE , если видет содержит кнопки окна, иначе FALSE
Типы и значения
GtkWindowControls
typedef struct _GtkWindowControls GtkWindowControls;
Подробное описание свойств
Свойство “decoration-layout”
“decoration-layout” char *
Макет элементов управления окном. Если это свойство не задано, используется настройка “gtk-decoration-layout”.
См. gtk_window_controls_set_decoration_layout() для получения информации о формате этой строки.
Владелец: GtkWindowControls
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “empty”
“empty” gboolean
Наличие кнопок управления окном в виджете.
Владелец: GtkWindowControls
Флаги: Чтение
Значение по умолчанию: TRUE
Свойство “side”
“side” GtkPackType
Показывать ли начальную или конечную сторону макета элементов управления.
См. gtk_window_controls_set_decoration_layout().
Владелец: GtkWindowControls
Флаги: Чтение / Запись
Значение по умолчанию: GTK_PACK_START
См. также
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkWindowControls.html
