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_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().

С: 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().

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_title ()

const gchar *
gtk_menu_get_title (GtkMenu *menu);

Возвращает заголовок меню. См. gtk_menu_set_title().

gtk_menu_set_monitor ()

void
gtk_menu_set_monitor (GtkMenu *menu,
                      gint monitor_num);

Сообщает GTK+, на каком мониторе должно быть отображено меню. См. gdk_screen_get_monitor_geometry().

Эта функция должна вызываться из GtkMenuPositionFunc, если меню не должно отображаться на том же мониторе, что и указатель. Эта информация не может быть надёжно определена из координат, возвращаемых функцией GtkMenuPositionFunc, так как для очень длинных меню эти координаты могут выходить за пределы монитора или даже экрана.

С: 2.4

gtk_menu_get_monitor ()

gint
gtk_menu_get_monitor (GtkMenu *menu);

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

С: 2.14

gtk_menu_get_tearoff_state ()

gboolean
gtk_menu_get_tearoff_state (GtkMenu *menu);

Возвращает, отсоединено ли меню. См. gtk_menu_set_tearoff_state().

gtk_menu_set_reserve_toggle_size ()

void
gtk_menu_set_reserve_toggle_size (GtkMenu *menu,
                                  gboolean reserve_toggle_size);

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

С: 2.18

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(), которая будет вызвана, когда меню позже будет отделено от виджета.