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 — «app», то эффективное имя действия — «app.выход».

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

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

С: 3.6