GtkModelButton
GtkModelButton — Кнопка, использующая GAction в качестве модели
Функции
Свойства
Типы и значения
| GtkModelButton | |
| перечисление | GtkButtonRole |
Иерархия объектов
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkButton ╰── GtkModelButton
Реализованные интерфейсы
GtkModelButton реализует AtkImplementorIface, GtkBuildable, GtkActionable и GtkActivatable.
Включаемые файлы
#include <gtk/gtk.h>
Описание
GtkModelButton — это класс кнопок, который может использовать GAction в качестве своей модели. В отличие от GtkToggleButton или GtkRadioButton, которые также могут использовать GAction через свойство “action-name”, GtkModelButton адаптирует свой вид в соответствии с типом используемого действия и отображается как простая, флажковая или радиокнопка.
Кнопки-модели используются при появлении всплывающих меню из модели меню с gtk_popover_new_from_model(); их также можно использовать вручную в GtkPopoverMenu.
Когда действие задаётся через свойства “action-name” и “action-target”, роль кнопки (т. е. является ли она простой, флажковой или радиокнопкой) определяется типом действия и не должна быть явно указана свойством “role”.
Содержание кнопки задаётся свойствами “text” и “icon”.
Внешний вид кнопок-моделей может быть изменён свойствами “centered” и “iconic”.
Кнопки-модели имеют встроенную поддержку подменю в GtkPopoverMenu. Чтобы создать GtkModelButton, открывающую подменю при активации, установите свойство “menu-name”. Чтобы создать кнопку, возвращающуюся в родительское меню, необходимо установить свойство “inverted” для размещения индикатора подменю на противоположной стороне.
Пример
Узлы CSS
GtkModelButton имеет главный узел CSS с именем modelbutton и дочерний узел, который будет иметь имя check, radio или arrow в зависимости от роли кнопки и наличия имени меню.
Дочерний узел расположен перед или после узлов содержимого и получает класс стиля .left или .right в зависимости от расположения.
<object class="GtkPopoverMenu">
<child>
<object class="GtkBox">
<property name="visible">True</property>
<property name="margin">10</property>
<child>
<object class="GtkModelButton">
<property name="visible">True</property>
<property name="action-name">view.cut</property>
<property name="text" translatable="yes">Cut</property>
</object>
</child>
<child>
<object class="GtkModelButton">
<property name="visible">True</property>
<property name="action-name">view.copy</property>
<property name="text" translatable="yes">Copy</property>
</object>
</child>
<child>
<object class="GtkModelButton">
<property name="visible">True</property>
<property name="action-name">view.paste</property>
<property name="text" translatable="yes">Paste</property>
</object>
</child>
</object>
</child>
</object>Кнопки-модели с иконками (см. “iconic”) изменяют имя своего основного узла на button и добавляют к нему класс стиля .model. В этом случае индикатор дочернего узла невидимый.
Подробное описание функций
gtk_model_button_new ()
GtkWidget *
gtk_model_button_new (void); Создаёт новую кнопку GtkModelButton.
Возвращает
новый созданный виджет GtkModelButton
С момента: 3.16
Типы и значения
GtkModelButton
typedef struct _GtkModelButton GtkModelButton;
перечисление GtkButtonRole
Роль определяет желаемый вид GtkModelButton.
Члены
GTK_BUTTON_ROLE_NORMAL | Простая кнопка | |
GTK_BUTTON_ROLE_CHECK | Флажковая кнопка | |
GTK_BUTTON_ROLE_RADIO | Радиокнопка |
Подробное описание свойств
Свойство “active”
“active” gboolean
Состояние кнопки. Оно отражает состояние связанного GAction.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С версии: 3.16
Свойство “centered”
“centered” gboolean
Определяет, будет ли содержимое кнопки выравниваться по центру, вместо выравнивания по левому краю. Это свойство должно устанавливаться для элементов, подобных заголовкам.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С версии: 3.16
Свойство “icon”
“icon” GIcon *
Иконка GIcon, которая будет использоваться, если для кнопки требуется иконка.
Флаги: Чтение / Запись
С версии: 3.16
Свойство “iconic”
“iconic” gboolean
Если это свойство установлено, кнопка будет отображать иконку, если она задана. Если иконка не задана, будет использоваться текст. Обычно используется для горизонтальных разделов связанных кнопок.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С версии: 3.16
Свойство “inverted”
“inverted” gboolean
Указывает, нужно ли отображать индикатор подменю с противоположной стороны, чем обычно. Это свойство должно устанавливаться для кнопок модели, которые возвращаются в родительское меню.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С версии: 3.16
Свойство “menu-name”
“menu-name” gchar *
Имя подменю, которое откроется при нажатии на кнопку. Если это свойство установлено, кнопка не должна иметь связанного действия.
Флаги: Чтение / Запись
Значение по умолчанию: NULL
С версии: 3.16
Свойство “role”
“role” GtkButtonRole
Указывает, является ли кнопка обычной, флажком или радиокнопкой. Когда свойство “action-name” установлено, роль определяется из действия и не должна устанавливаться явно.
Флаги: Чтение / Запись
Значение по умолчанию: GTK_BUTTON_ROLE_NORMAL
С версии: 3.16
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.20/GtkModelButton.html
