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, имели свои имена, префиксрованные пространством имен, плюс точка. Например, если упомянуто действие «quit», а action_namespace равно «app», то эффективное имя действия равно «app.quit».

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

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

С: 3.6