GtkMenu

gtk_menu_new ()

GtkWidget *
gtk_menu_new (void);

Создаёт новый GtkMenu

gtk_menu_new_from_model ()

GtkWidget *
gtk_menu_new_from_model (GMenuModel *model);

Создаёт GtkMenu и заполняет его пунктами меню и подменю в соответствии с model.

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

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

С: 3.4

gtk_menu_set_screen ()

void
gtk_menu_set_screen (GtkMenu *menu,
                     GdkScreen *screen);

Устанавливает GdkScreen, на котором будет отображаться меню.

С: 2.2

gtk_menu_reorder_child ()

void
gtk_menu_reorder_child (GtkMenu *menu,
                        GtkWidget *child,
                        gint position);

Перемещает child в новое position в списке menu дочерних элементов.

gtk_menu_attach ()

void
gtk_menu_attach (GtkMenu *menu,
                 GtkWidget *child,
                 guint left_attach,
                 guint right_attach,
                 guint top_attach,
                 guint bottom_attach);

Добавляет новый GtkMenuItem в меню (таблицу). Количество «ячеек», которые будет занимать элемент, задаётся left_attach, right_attach, top_attach и bottom_attach. Они представляют собой номера столбцов и строк самой левой, самой правой, самой верхней и самой нижней ячеек таблицы. (Столбцы и строки индексируются с нуля).

Обратите внимание, что эта функция не связана с gtk_menu_detach().

С: 2.4

gtk_menu_popup_at_rect ()

void
gtk_menu_popup_at_rect (GtkMenu *menu,
                        GdkWindow *rect_window,
                        const GdkRectangle *rect,
                        GdkGravity rect_anchor,
                        GdkGravity menu_anchor,
                        const GdkEvent *trigger_event);

Отображает menu и делает его доступным для выбора.

См. gtk_menu_popup_at_widget() и gtk_menu_popup_at_pointer(), которые обрабатывают более распространённые случаи для отображения меню.

menu будет позиционироваться по rect, выравнивая их точки привязки. rect относительно верхнего левого угла rect_window. rect_anchor и menu_anchor определяют точки привязки к rect и menu для совмещения. menu может быть дополнительно смещён на “rect-anchor-dx” и “rect-anchor-dy”.

Точки привязки следует указывать в предположении, что направление текста слева направо; они будут автоматически перевернуты по горизонтали, если направление текста справа налево.

Другие свойства, которые влияют на поведение этой функции, — “anchor-hints” и “menu-type-hint”. Подключитесь к сигналу “popped-up”, чтобы узнать, как он был фактически позиционирован.

С: 3.22

gtk_menu_popup_at_widget ()

void
gtk_menu_popup_at_widget (GtkMenu *menu,
                          GtkWidget *widget,
                          GdkGravity widget_anchor,
                          GdkGravity menu_anchor,
                          const GdkEvent *trigger_event);

Отображает menu и делает его доступным для выбора.

См. gtk_menu_popup_at_pointer(), чтобы отобразить меню в позиции указателя. gtk_menu_popup_at_rect() также позволяет позиционировать меню в произвольной прямоугольной области.

menu будет позиционирован относительно widget, выравнивая их точки якорной привязки. widget_anchor и menu_anchor определяют точки якорной привязки для widget и menu соответственно. menu можно дополнительно сместить на “rect-anchor-dx” и “rect-anchor-dy”.

Якорные точки должны быть указаны с учетом направления текста слева направо; они будут автоматически изменены на горизонтально обратные, если направление текста справа налево.

Другие свойства, влияющие на поведение этой функции, — это “anchor-hints” и “menu-type-hint”. Подключитесь к сигналу “popped-up”, чтобы узнать, как он был фактически расположен.

С: 3.22

gtk_menu_popup_at_pointer ()

void
gtk_menu_popup_at_pointer (GtkMenu *menu,
                           const GdkEvent *trigger_event);

Отображает menu и делает его доступным для выбора.

См. gtk_menu_popup_at_widget(), чтобы отобразить меню в позиции элемента. gtk_menu_popup_at_rect() также позволяет позиционировать меню в произвольной прямоугольной области.

menu будет позиционирован относительно указателя, связанного с trigger_event.

Свойства, влияющие на поведение этой функции, — это “anchor-hints”, “rect-anchor-dx”, “rect-anchor-dy” и “menu-type-hint”. Подключитесь к сигналу “popped-up”, чтобы узнать, как он был фактически расположен.

С: 3.22

gtk_menu_popup_for_device ()

void
gtk_menu_popup_for_device (GtkMenu *menu,
                           GdkDevice *device,
                           GtkWidget *parent_menu_shell,
                           GtkWidget *parent_menu_item,
                           GtkMenuPositionFunc func,
                           gpointer data,
                           GDestroyNotify destroy,
                           guint button,
                           guint32 activate_time);

Отображает меню и делает его доступным для выбора.

Приложения могут использовать эту функцию для отображения контекстных меню, и обычно будут передавать NULL для параметров parent_menu_shell, parent_menu_item, func, data и destroy. По умолчанию функция позиционирования меню разместит его в текущем положении device (или его соответствующего указателя).

Параметр button должен содержать кнопку мыши, нажатие которой инициировало всплывающее меню. Если всплывающее меню было инициировано не нажатием кнопки мыши, например, отпусканием кнопки мыши или нажатием клавиши, button должно быть равно 0.

Параметр activate_time используется для разрешения конфликтов при одновременном запросе захвата мыши/клавиатуры. Для корректной работы он должен содержать временной отметку события пользователя (например, щелчка мыши или нажатия клавиши), вызвавшего инициацию всплывающего меню. Только если такое событие недоступно, можно использовать gtk_get_current_event_time().

Обратите внимание, что эта функция работает не очень хорошо на GDK-бекендах, не имеющих глобальных координат, таких как Wayland или Mir. Вы, вероятно, должны использовать одну из функций gtk_menu_popup_at_, которые не имеют этой проблемы.

С: 3.0

gtk_menu_popup ()

void
gtk_menu_popup (GtkMenu *menu,
                GtkWidget *parent_menu_shell,
                GtkWidget *parent_menu_item,
                GtkMenuPositionFunc func,
                gpointer data,
                guint button,
                guint32 activate_time);

Отображает меню и делает его доступным для выбора.

Приложения могут использовать эту функцию для отображения контекстных меню, и обычно будут передавать NULL для параметров parent_menu_shell, parent_menu_item, func и data. По умолчанию функция позиционирования меню разместит его в текущем положении курсора мыши.

Параметр button должен содержать кнопку мыши, нажатие которой инициировало всплывающее меню. Если всплывающее меню было инициировано не нажатием кнопки мыши, например, отпусканием кнопки мыши или нажатием клавиши, button должно быть равно 0.

Параметр activate_time используется для разрешения конфликтов при одновременном запросе захвата мыши/клавиатуры. Для корректной работы он должен содержать временную метку события пользователя (например, щелчка мыши или нажатия клавиши), вызвавшего инициацию всплывающего меню. Только если такое событие недоступно, можно использовать gtk_get_current_event_time().

Обратите внимание, что эта функция работает не очень хорошо на GDK-бекендах, не имеющих глобальных координат, таких как Wayland или Mir. Вы, вероятно, должны использовать одну из функций gtk_menu_popup_at_, которые не имеют этой проблемы.

gtk_menu_set_accel_group ()

void
gtk_menu_set_accel_group (GtkMenu *menu,
                          GtkAccelGroup *accel_group);

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

gtk_menu_get_accel_group ()

GtkAccelGroup *
gtk_menu_get_accel_group (GtkMenu *menu);

Получает GtkAccelGroup, содержащий глобальные активаторы для меню. См. gtk_menu_set_accel_group().

gtk_menu_set_accel_path ()

void
gtk_menu_set_accel_path (GtkMenu *menu,
                         const gchar *accel_path);

Устанавливает путь активатора для этого меню, из которого можно создавать пути активаторов для его непосредственных дочерних элементов и пунктов меню. Основная цель этой функции — избавить программиста от необходимости вызывать gtk_menu_item_set_accel_path() для каждого элемента меню, который должен поддерживать изменяемые пользователем активаторы во время выполнения. Вместо этого, вызвав gtk_menu_set_accel_path() для родительского элемента, каждый пункт меню этого меню, содержащий метку, описывающую его назначение, автоматически получает назначенный путь активатора.

Например, меню, содержащее пункты меню «Новый» и «Выход», после вызова gtk_menu_set_accel_path (menu, "<Gnumeric-Sheet>/File");, назначит своим пунктам пути активаторов: "<Gnumeric-Sheet>/File/New" и "<Gnumeric-Sheet>/File/Exit".

Назначение путей активаторов пунктам меню позволяет пользователю изменять их активаторы во время выполнения. Более подробную информацию о путях активаторов и их настройках по умолчанию можно найти в gtk_accel_map_add_entry().

Обратите внимание, что строка accel_path будет храниться в GQuark. Поэтому, если вы передаете статическую строку, вы можете сэкономить некоторое количество памяти, предварительно интернировав ее с помощью g_intern_static_string().

gtk_menu_get_accel_path ()

const gchar *
gtk_menu_get_accel_path (GtkMenu *menu);

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

С: 2.14

gtk_menu_set_title ()

void
gtk_menu_set_title (GtkMenu *menu,
                    const gchar *title);

Устанавливает строку заголовка для меню.

Заголовок отображается, когда меню отображается как вырывающееся меню. Если title имеет значение NULL, меню проверит, прикреплено ли оно к родительскому пункту меню, и в случае положительного результата попытается использовать тот же текст, что и метка этого пункта меню.

gtk_menu_get_reserve_toggle_size ()

gboolean
gtk_menu_get_reserve_toggle_size (GtkMenu *menu);

Возвращает, резервирует ли меню место для переключателей и значков, независимо от их фактического наличия.

С: 2.18

gtk_menu_popdown ()

void
gtk_menu_popdown (GtkMenu *menu);

Удаляет меню с экрана.

gtk_menu_reposition ()

void
gtk_menu_reposition (GtkMenu *menu);

Перемещает меню в соответствии с его функцией позиционирования.

gtk_menu_get_active ()

GtkWidget *
gtk_menu_get_active (GtkMenu *menu);

Возвращает выбранный пункт меню из меню. Используется GtkComboBox.

gtk_menu_set_active ()

void
gtk_menu_set_active (GtkMenu *menu,
                     guint index);

Выбирает указанный пункт меню в меню. Используется GtkComboBox и не должен использоваться другими.

gtk_menu_set_tearoff_state ()

void
gtk_menu_set_tearoff_state (GtkMenu *menu,
                            gboolean torn_off);

Изменяет состояние отрыва меню. Меню обычно отображается как выпадающее меню, которое сохраняется до тех пор, пока меню активно. Оно также может отображаться как меню отрыва, которое сохраняется до тех пор, пока оно не будет закрыто или повторно подключено.

gtk_menu_attach_to_widget ()

void
gtk_menu_attach_to_widget (GtkMenu *menu,
                           GtkWidget *attach_widget,
                           GtkMenuDetachFunc detacher);

Прикрепляет меню к виджету и предоставляет функцию обратного вызова, которая будет вызвана, когда меню вызовет gtk_menu_detach() во время своего уничтожения.

Если меню прикреплено к виджету, оно будет уничтожено при уничтожении виджета, как если бы это был дочерний виджет. Прикрепленное меню также будет правильно перемещаться между экранами, если виджет перемещается между экранами.

gtk_menu_detach ()

void
gtk_menu_detach (GtkMenu *menu);

Открепляет меню от виджета, к которому оно было прикреплено. Эта функция вызовет функцию обратного вызова, detacher , предоставленную при вызове функции gtk_menu_attach_to_widget().

gtk_menu_get_attach_widget ()

GtkWidget *
gtk_menu_get_attach_widget (GtkMenu *menu);

Возвращает GtkWidget, к которому прикреплено меню.

gtk_menu_get_for_attach_widget ()

GList *
gtk_menu_get_for_attach_widget (GtkWidget *widget);

Возвращает список меню, прикрепленных к этому виджету. Этот список принадлежит GTK+ и его нельзя изменять.

С: 2.6

Функция GtkMenuPositionFunc

void
(*GtkMenuPositionFunc) (GtkMenu *menu,
                        gint *x,
                        gint *y,
                        gboolean *push_in,
                        gpointer user_data);

Пользовательская функция, предоставляемая при вызове gtk_menu_popup(), которая управляет позиционированием меню при его отображении. Функция устанавливает параметры x и y в координаты, где должно быть отображено меню. Чтобы отобразить меню на другом мониторе, отличном от монитора указателя мыши, необходимо вызвать gtk_menu_set_monitor().

Функция GtkMenuDetachFunc

void
(*GtkMenuDetachFunc) (GtkWidget *attach_widget,
                      GtkMenu *menu);

Пользовательская функция, предоставляемая при вызове gtk_menu_attach_to_widget(), которая будет вызвана, когда меню будет позже отделено от виджета.