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.22/GtkModelButton.html
