GtkMenuShell

gtk_menu_shell_append ()

void
gtk_menu_shell_append (GtkMenuShell *menu_shell,
                       GtkWidget *child);

Добавляет новый GtkMenuItem в конец списка элементов оболочки меню.

gtk_menu_shell_prepend ()

void
gtk_menu_shell_prepend (GtkMenuShell *menu_shell,
                        GtkWidget *child);

Добавляет новый GtkMenuItem в начало списка элементов оболочки меню.

gtk_menu_shell_insert ()

void
gtk_menu_shell_insert (GtkMenuShell *menu_shell,
                       GtkWidget *child,
                       gint position);

Добавляет новый GtkMenuItem в список элементов оболочки меню на позиции, указанной параметром position.

gtk_menu_shell_deactivate ()

void
gtk_menu_shell_deactivate (GtkMenuShell *menu_shell);

Деактивирует оболочку меню.

Как правило, это приводит к удалению оболочки меню с экрана.

gtk_menu_shell_select_item ()

void
gtk_menu_shell_select_item (GtkMenuShell *menu_shell,
                            GtkWidget *menu_item);

Выбирает элемент меню из оболочки меню.

gtk_menu_shell_select_first ()

void
gtk_menu_shell_select_first (GtkMenuShell *menu_shell,
                             gboolean search_sensitive);

Выбирает первый видимый или выбираемый дочерний элемент оболочки меню; не выбирать элементы разрыва, если единственный элемент — элемент разрыва.

С: 2.2

gtk_menu_shell_deselect ()

void
gtk_menu_shell_deselect (GtkMenuShell *menu_shell);

Отменяет выбор текущего выделенного элемента в оболочке меню, если он есть.

gtk_menu_shell_activate_item ()

void
gtk_menu_shell_activate_item (GtkMenuShell *menu_shell,
                              GtkWidget *menu_item,
                              gboolean force_deactivate);

Активирует элемент меню в оболочке меню.

gtk_menu_shell_cancel ()

void
gtk_menu_shell_cancel (GtkMenuShell *menu_shell);

Отменяет выбор в оболочке меню.

С: 2.4

gtk_menu_shell_set_take_focus ()

void
gtk_menu_shell_set_take_focus (GtkMenuShell *menu_shell,
                               gboolean take_focus);

Если take_focus равно TRUE (по умолчанию), оболочка меню получит фокус клавиатуры, чтобы получать все события клавиатуры, что необходимо для включения навигации по клавиатуре в меню.

Установка take_focus в FALSE полезна только для специальных приложений, таких как реализации виртуальных клавиатур, которые не должны получать фокус клавиатуры.

Состояние take_focus меню или панели меню автоматически передается подменю при каждом открытии подменю, поэтому вам не нужно беспокоиться о его рекурсивной настройке для всей иерархии меню. Только при программировании выбора подменю и его ручном открытии свойство take_focus подменю необходимо установить явно.

Обратите внимание, что установка его в FALSE имеет побочные эффекты:

Если фокус находится в другом приложении, фокус сохраняется, а навигация по клавиатуре в меню не работает. Следовательно, навигация по клавиатуре в меню будет работать только если фокус находится на каком-либо виджете верхнего уровня, принадлежащем экранной клавиатуре.

Чтобы избежать путаницы у пользователя, в менюх с take_focus, установленным в FALSE, не должны отображаться мнемоники или акселераторы, так как нет гарантии, что они будут работать.

См. также gdk_keyboard_grab()

С: 2.8

gtk_menu_shell_get_take_focus ()

gboolean
gtk_menu_shell_get_take_focus (GtkMenuShell *menu_shell);

Возвращает TRUE , если оболочка меню получит фокус клавиатуры при открытии.

С: 2.8

gtk_menu_shell_get_selected_item ()

GtkWidget *
gtk_menu_shell_get_selected_item (GtkMenuShell *menu_shell);

Возвращает текущий выбранный элемент.

С: 3.0

gtk_menu_shell_get_parent_shell ()

GtkWidget *
gtk_menu_shell_get_parent_shell (GtkMenuShell *menu_shell);

Возвращает родительское меню.

Родительское меню подменю — это GtkMenu или GtkMenuBar, из которого оно было открыто.

С: 3.0

gtk_menu_shell_bind_model ()

void
gtk_menu_shell_bind_model (GtkMenuShell *menu_shell,
                           GMenuModel *model,
                           const gchar *action_namespace,
                           gboolean with_separators);

Устанавливает связь между GtkMenuShell и GMenuModel.

Содержимое shell удаляется и затем заполняется элементами меню в соответствии с model . При изменении model , shell обновляется. Вызов этой функции дважды для shell с разными model приведет к замене первой привязки на привязку к новой модели. Если model — NULL, то любая предыдущая привязка разрывается, и все дочерние элементы удаляются.

with_separators определяет, нужно ли вставлять разделители между элементами верхнего уровня (например, разделами). Обычно это желательно для меню, но не имеет смысла для меню-строки.

Если action_namespace не NULL, то эффект такой, как будто все действия, упомянутые в model, имеют имена, префиксрованные с именем пространства имён, плюс точка. Например, если упомянуто действие «выход» и action_namespace — «приложение», то эффективное имя действия — «приложение.выход».

Эта функция использует GtkActionable для определения имени действия и целевых значений для созданных элементов меню. Если вы хотите использовать группу действий отличную от «приложение» и «окно», или если вы хотите использовать GtkMenuShell вне GtkApplicationWindow, то вам нужно будет прикрепить свою собственную группу действий к иерархии виджетов, используя gtk_widget_insert_action_group(). Например, если вы создали группу с действием «выход» и вставили её с именем «mygroup», то вы будете использовать имя действия «mygroup.выход» в вашем GMenuModel.

В большинстве случаев вам будет лучше использовать gtk_menu_new_from_model() или gtk_menu_bar_new_from_model(), или просто передать GMenuModel в gtk_application_set_app_menu() или gtk_application_set_menubar().

С: 3.6