GtkPopoverMenu

Модели меню

Формат XML, понимаемый GtkBuilder для GMenuModel, состоит из верхнего уровня <menu> элемента, содержащего один или несколько <item> элементов. Каждый <item> элемент содержит <attribute> и <link> элементы с обязательным атрибутом name. <link> элементы имеют тот же формат, что и <menu>. Вместо <link name="submenu> или <link name="section">, можно использовать <submenu> или <section> элементы.

<menu id='app-menu'>
  <section>
    <item>
      <attribute name='label' translatable='yes'>_New Window</attribute>
      <attribute name='action'>app.new</attribute>
    </item>
    <item>
      <attribute name='label' translatable='yes'>_About Sunny</attribute>
      <attribute name='action'>app.about</attribute>
    </item>
    <item>
      <attribute name='label' translatable='yes'>_Quit</attribute>
      <attribute name='action'>app.quit</attribute>
    </item>
  </section>
</menu>

Значения атрибутов могут быть переведены с помощью gettext, как и другие содержимое GtkBuilder. <attribute> элементы могут быть помечены для перевода с помощью атрибута translatable="yes". Также можно указать контекст сообщения и комментарии переводчика, используя атрибуты context и comments. Для этого GtkBuilder должен быть предоставлен домен gettext.

Следующие атрибуты используются при построении пунктов меню:

Следующие атрибуты используются при построении разделов:

Следующие атрибуты используются при построении подменю:

Пункты меню также будут отображать сочетания клавиш, которые обычно связываются с действиями с помощью gtk_application_set_accels_for_action(), gtk_widget_class_add_binding_action() или gtk_shortcut_controller_add_shortcut().

CSS узлы

GtkPopoverMenu — это просто подкласс GtkPopover, к которому добавляется пользовательское содержимое, поэтому у него те же CSS узлы. Это один из случаев, когда к основному узлу всплывающего окна добавляется класс .menu.

Доступность

GtkPopoverMenu использует роль GTK_ACCESSIBLE_ROLE_MENU, а его пункты используют роли GTK_ACCESSIBLE_ROLE_MENU_ITEM, GTK_ACCESSIBLE_ROLE_MENU_ITEM_CHECKBOX или GTK_ACCESSIBLE_ROLE_MENU_ITEM_RADIO в зависимости от действия, к которому они подключены.

gtk_popover_menu_new_from_model ()

GtkWidget *
gtk_popover_menu_new_from_model (GMenuModel *model);

Создаёт GtkPopoverMenu и заполняет его в соответствии с model .

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

Действия также можно добавить, используя gtk_widget_insert_action_group() на виджете меню или на любом из его родительских виджетов.

Эта функция создаёт меню со сдвигающимися подменю. См. gtk_popover_menu_new_from_model_full() для управления этим.

gtk_popover_menu_new_from_model_full ()

GtkWidget *
gtk_popover_menu_new_from_model_full (GMenuModel *model,
                                      GtkPopoverMenuFlags flags);

Создаёт GtkPopoverMenu и заполняет его в соответствии с model .

Созданные кнопки подключаются к действиям, найденным в группах действий, доступных из родительского виджета. Это включает GtkApplicationWindow, к которому относится всплывающее меню. Действия также можно добавить, используя gtk_widget_insert_action_group() на родительском виджете или на любом из его родительских виджетов.

В настоящее время поддерживается только флаг GTK_POPOVER_MENU_NESTED, который заставляет GTK создавать традиционные вложенные подменю вместо стандартных сдвигающихся подменю.

gtk_popover_menu_set_menu_model ()

void
gtk_popover_menu_set_menu_model (GtkPopoverMenu *popover,
                                 GMenuModel *model);

Устанавливает новую модель меню для popover .

Существующее содержимое popover удаляется, и popover заполняется новым содержимым в соответствии с model .

gtk_popover_menu_get_menu_model ()

GMenuModel *
gtk_popover_menu_get_menu_model (GtkPopoverMenu *popover);

Возвращает модель меню, используемую для заполнения всплывающего меню.

gtk_popover_menu_add_child ()

gboolean
gtk_popover_menu_add_child (GtkPopoverMenu *popover,
                            GtkWidget *child,
                            const char *id);

Добавляет пользовательский виджет в сгенерированное меню.

Для этого модель меню popover должна содержать элемент с атрибутом custom, который соответствует id .

gtk_popover_menu_remove_child ()

gboolean
gtk_popover_menu_remove_child (GtkPopoverMenu *popover,
                               GtkWidget *child);

Удаляет виджет, ранее добавленный с помощью gtk_popover_menu_add_child().

GtkPopoverMenu

typedef struct _GtkPopoverMenu GtkPopoverMenu;

перечисление GtkPopoverMenuFlags

Флаги, влияющие на создание всплывающих меню из модели меню.

Свойство “menu-model”

  “menu-model”               GMenuModel *

Модель, из которой создаётся меню.

Владелец: GtkPopoverMenu

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

Свойство “visible-submenu”

  “visible-submenu”          char *

Имя видимого подменю.

Владелец: GtkPopoverMenu

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

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