GtkMenuItem

GtkMenuItem как GtkBuildable

Реализация GtkMenuItem интерфейса GtkBuildable поддерживает добавление подменю путем указания «submenu» в качестве атрибута «type» элемента <child>.

Пример фрагмента определения пользовательского интерфейса с подменю:

CSS-узлы

GtkWidget *menu_item = gtk_menu_item_new_with_label ("Example Menu Item");

GtkWidget *child = gtk_bin_get_child (GTK_BIN (menu_item));
gtk_label_set_markup (GTK_LABEL (child), "<i>new label</i> with <b>markup</b>");
gtk_accel_label_set_accel (GTK_ACCEL_LABEL (child), GDK_KEY_1, 0);

GtkMenuItem имеет единственный CSS-узел с именем menuitem. Если у menuitem есть подменю, он получает ещё один CSS-узел с именем arrow, который имеет класс стиля .left или .right.

Структура GtkMenuItem

struct GtkMenuItem;

Структура GtkMenuItemClass

struct GtkMenuItemClass {
  GtkBinClass parent_class;

  /* If the following flag is true, then we should always
   * hide the menu when the MenuItem is activated. Otherwise,
   * it is up to the caller. For instance, when navigating
   * a menu with the keyboard, <Space> doesn't hide, but
   * <Return> does.
   */
  guint hide_on_activate : 1;

  void (* activate)             (GtkMenuItem *menu_item);
  void (* activate_item)        (GtkMenuItem *menu_item);
  void (* toggle_size_request)  (GtkMenuItem *menu_item,
                                 gint        *requisition);
  void (* toggle_size_allocate) (GtkMenuItem *menu_item,
                                 gint         allocation);
  void (* set_label)            (GtkMenuItem *menu_item,
                                 const gchar *label);
  const gchar * (* get_label)   (GtkMenuItem *menu_item);

  void (* select)               (GtkMenuItem *menu_item);
  void (* deselect)             (GtkMenuItem *menu_item);
};

Свойство “accel-path”

  “accel-path”               char *

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

Владелец: GtkMenuItem

Флаги: Чтение / Запись

Значение по умолчанию: NULL

С версии: 2.14

Свойство “label”

  “label”                    char *

Текст для метки дочернего элемента.

Владелец: GtkMenuItem

Флаги: Чтение / Запись

Значение по умолчанию: ""

С версии: 2.16

Свойство “right-justified”

  “right-justified”          gboolean

Определяет, выравнивается ли элемент меню по правому краю панели меню.

Владелец: GtkMenuItem

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

С версии: 2.14

Свойство “submenu”

  “submenu”                  GtkMenu *

Подменю, прикреплённое к элементу меню, или NULL, если его нет.

Владелец: GtkMenuItem

Флаги: Чтение / Запись

С версии: 2.12

Свойство “use-underline”

  “use-underline”            gboolean

TRUE если подчеркивания в тексте указывают на мнемоники.

Владелец: GtkMenuItem

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

С версии: 2.16

Свойство стиля “arrow-scaling”

  “arrow-scaling”            float

Количество места, занимаемого стрелкой, относительно размера шрифта элемента меню.

Владелец: GtkMenuItem

Флаги: Чтение

Допустимые значения: [0,2]

Значение по умолчанию: 0.8

Свойство стиля “arrow-spacing”

  “arrow-spacing”            int

Отступ между меткой элемента меню и стрелкой подменю.

Владелец: GtkMenuItem

Флаги: Чтение

Допустимые значения: ≥ 0

Значение по умолчанию: 10

Свойство стиля “horizontal-padding”

  “horizontal-padding”       int

Отступ слева и справа от элемента меню.

Владелец: GtkMenuItem

Флаги: Чтение

Допустимые значения: ≥ 0

Значение по умолчанию: 0

Свойство стиля “selected-shadow-type”

  “selected-shadow-type”     GtkShadowType

Тип тени при выборе элемента.

Владелец: GtkMenuItem

Флаги: Чтение

Значение по умолчанию: GTK_SHADOW_NONE

Свойство стиля “toggle-spacing”

  “toggle-spacing”           int

Отступ между иконкой и меткой элемента переключателя.

Владелец: GtkMenuItem

Флаги: Чтение

Допустимые значения: ≥ 0

Значение по умолчанию: 5

Свойство стиля “width-chars”

  “width-chars”              int

Минимальная желаемая ширина элемента меню в символах.

Владелец: GtkMenuItem

Флаги: Чтение

Допустимые значения: ≥ 0

Значение по умолчанию: 12

С версии: 2.14

Сигнал “activate”

void
user_function (GtkMenuItem *menuitem,
               gpointer     user_data)

Генерируется при активации элемента.

Флаги: Действие

Сигнал “activate-item”

void
user_function (GtkMenuItem *menuitem,
               gpointer     user_data)

Генерируется при активации элемента, а также если у элемента-меню есть подменю. Для обычных приложений, соответствующий сигнал — «activate».

Флаги: Выполняется первым

Сигнал “deselect”

void
user_function (GtkMenuItem *menuitem,
               gpointer     user_data)

Флаги: Выполняется первым

Сигнал “select”

void
user_function (GtkMenuItem *menuitem,
               gpointer     user_data)

Флаги: Выполняется первым

Сигнал “toggle-size-allocate”

void
user_function (GtkMenuItem *menuitem,
               int          arg1,
               gpointer     user_data)

Флаги: Выполняется первым

Сигнал “toggle-size-request”

void
user_function (GtkMenuItem *menuitem,
               gpointer     arg1,
               gpointer     user_data)

Флаги: Выполняется первым