GtkAction

gtk_action_new ()

GtkAction *
gtk_action_new (const gchar *name,
                const gchar *label,
                const gchar *tooltip,
                const gchar *stock_id);

Создает новый объект GtkAction. Чтобы добавить действие в GtkActionGroup и установить акселератор для действия, вызовите gtk_action_group_add_action_with_accel(). См. раздел Определения UI для получения информации о допустимых именах действий.

С версии: 2.4

gtk_action_get_name ()

const gchar *
gtk_action_get_name (GtkAction *action);

Возвращает имя действия.

С версии: 2.4

gtk_action_is_sensitive ()

gboolean
gtk_action_is_sensitive (GtkAction *action);

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

С версии: 2.4

gtk_action_get_sensitive ()

gboolean
gtk_action_get_sensitive (GtkAction *action);

Возвращает, является ли само действие активным. Обратите внимание, что это не обязательно означает фактическую активность. См. gtk_action_is_sensitive() для этого.

С версии: 2.4

gtk_action_set_sensitive ()

void
gtk_action_set_sensitive (GtkAction *action,
                          gboolean sensitive);

Устанавливает свойство :sensitive действия в sensitive. Обратите внимание, что это не обязательно означает фактическую активность. См. gtk_action_is_sensitive() для этого.

С версии: 2.6

gtk_action_is_visible ()

gboolean
gtk_action_is_visible (GtkAction *action);

Возвращает, является ли действие видимым.

С версии: 2.4

gtk_action_get_visible ()

gboolean
gtk_action_get_visible (GtkAction *action);

Возвращает, является ли само действие видимым. Обратите внимание, что это не обязательно означает фактическую видимость. См. gtk_action_is_sensitive() для этого.

С версии: 2.4

gtk_action_set_visible ()

void
gtk_action_set_visible (GtkAction *action,
                        gboolean visible);

Устанавливает свойство :visible действия в visible. Обратите внимание, что это не обязательно означает эффективную видимость. См. gtk_action_is_visible() для этого.

С: 2.6

gtk_action_activate ()

void
gtk_action_activate (GtkAction *action);

Вызывает сигнал «activate» для указанного действия, если оно не нечувствительно. Это вызывается прокси-виджетами, когда они активируются.

Его также можно использовать для ручного активации действия.

С: 2.4

gtk_action_create_icon ()

GtkWidget *
gtk_action_create_icon (GtkAction *action,
                        GtkIconSize icon_size);

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

С: 2.4

gtk_action_create_menu_item ()

GtkWidget *
gtk_action_create_menu_item (GtkAction *action);

Создает виджет пункта меню, который является прокси для данного действия.

С: 2.4

gtk_action_create_tool_item ()

GtkWidget *
gtk_action_create_tool_item (GtkAction *action);

Создает виджет элемента панели инструментов, который является прокси для заданного действия.

С: 2.4

gtk_action_create_menu ()

GtkWidget *
gtk_action_create_menu (GtkAction *action);

Если action предоставляет виджет GtkMenu в качестве подменю для пункта меню или элемента панели инструментов, эта функция возвращает экземпляр этого меню.

С: 2.12

gtk_action_get_proxies ()

GSList *
gtk_action_get_proxies (GtkAction *action);

Возвращает прокси-виджеты для действия. См. также gtk_activatable_get_related_action().

С: 2.4

gtk_action_connect_accelerator ()

void
gtk_action_connect_accelerator (GtkAction *action);

Устанавливает акселератор для action, если у action есть путь акселератора и группа. См. gtk_action_set_accel_path() и gtk_action_set_accel_group()

Поскольку несколько прокси могут независимо вызывать установку акселератора, action подсчитывает количество вызовов этой функции и не удаляет акселератор до тех пор, пока gtk_action_disconnect_accelerator() не будет вызвано столько же раз.

С: 2.4

gtk_action_disconnect_accelerator ()

void
gtk_action_disconnect_accelerator (GtkAction *action);

Отменяет действие вызова gtk_action_connect_accelerator().

С: 2.4

gtk_action_block_activate ()

void
gtk_action_block_activate (GtkAction *action);

Отключает сигналы активации для действия

Это необходимо, когда обновление состояния вашего прокси-виджета GtkActivatable может привести к вызову gtk_action_activate(). Эта функция предназначена для предотвращения рекурсии в таких случаях (например, при обновлении состояния переключателя).

С: 2.16

gtk_action_unblock_activate ()

void
gtk_action_unblock_activate (GtkAction *action);

Восстанавливает сигналы активации для действия

С: 2.16

gtk_action_get_always_show_image ()

gboolean
gtk_action_get_always_show_image (GtkAction *action);

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

С: 2.20

gtk_action_set_always_show_image ()

void
gtk_action_set_always_show_image (GtkAction *action,
                                  gboolean always_show);

Устанавливает, будут ли пункты меню прокси action игнорировать настройку “gtk-menu-images” и всегда отображать свое изображение, если оно доступно.

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

С: 2.20

gtk_action_get_accel_path ()

const gchar *
gtk_action_get_accel_path (GtkAction *action);

Возвращает путь к акселератору для этого действия.

С: 2.6

gtk_action_set_accel_path ()

void
gtk_action_set_accel_path (GtkAction *action,
                           const gchar *accel_path);

Устанавливает путь к акселератору для этого действия. Все виджеты-прокси, связанные с действием, будут иметь этот путь к акселератору, чтобы их акселераторы были согласованными.

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

С: 2.4

gtk_action_get_accel_closure ()

GClosure *
gtk_action_get_accel_closure (GtkAction *action);

Возвращает акселераторное замыкание для данного действия.

С: 2.8

gtk_action_set_accel_group ()

void
gtk_action_set_accel_group (GtkAction *action,
                            GtkAccelGroup *accel_group);

Устанавливает GtkAccelGroup, в котором будет установлен ускоритель для этого действия.

С: 2.4

gtk_action_set_label ()

void
gtk_action_set_label (GtkAction *action,
                      const gchar *label);

Устанавливает метку для action .

С: 2.16

gtk_action_get_label ()

const gchar *
gtk_action_get_label (GtkAction *action);

Возвращает текст метки для action .

С: 2.16

gtk_action_set_short_label ()

void
gtk_action_set_short_label (GtkAction *action,
                            const gchar *short_label);

Устанавливает более короткий текст метки для action .

С: 2.16

gtk_action_get_short_label ()

const gchar *
gtk_action_get_short_label (GtkAction *action);

Получает короткий текст метки для action .

С: 2.16

gtk_action_set_tooltip ()

void
gtk_action_set_tooltip (GtkAction *action,
                        const gchar *tooltip);

Устанавливает текст всплывающей подсказки для action .

С: 2.16

gtk_action_get_tooltip ()

const gchar *
gtk_action_get_tooltip (GtkAction *action);

Возвращает текст всплывающей подсказки для action .

С: 2.16

gtk_action_set_stock_id ()

void
gtk_action_set_stock_id (GtkAction *action,
                         const gchar *stock_id);

Устанавливает идентификатор запаса для action .

С: 2.16

gtk_action_get_stock_id ()

const gchar *
gtk_action_get_stock_id (GtkAction *action);

Возвращает идентификатор запаса для action .

С: 2.16

gtk_action_set_gicon ()

void
gtk_action_set_gicon (GtkAction *action,
                      GIcon *icon);

Устанавливает значок для action .

С: 2.16

gtk_action_get_gicon ()

GIcon *
gtk_action_get_gicon (GtkAction *action);

Получает значок action .

С: 2.16

gtk_action_set_icon_name ()

void
gtk_action_set_icon_name (GtkAction *action,
                          const gchar *icon_name);

Устанавливает имя значка для action

С: 2.16

gtk_action_get_icon_name ()

const gchar *
gtk_action_get_icon_name (GtkAction *action);

Получает имя значка action.

С: 2.16

gtk_action_set_visible_horizontal ()

void
gtk_action_set_visible_horizontal (GtkAction *action,
                                   gboolean visible_horizontal);

Устанавливает видимость action по горизонтали

С: 2.16

gtk_action_get_visible_horizontal ()

gboolean
gtk_action_get_visible_horizontal (GtkAction *action);

Проверяет видимость action по горизонтали

С: 2.16

gtk_action_set_visible_vertical ()

void
gtk_action_set_visible_vertical (GtkAction *action,
                                 gboolean visible_vertical);

Устанавливает видимость action по вертикали

С: 2.16

gtk_action_get_visible_vertical ()

gboolean
gtk_action_get_visible_vertical (GtkAction *action);

Проверяет видимость action по вертикали

С: 2.16

gtk_action_set_is_important ()

void
gtk_action_set_is_important (GtkAction *action,
                             gboolean is_important);

Устанавливает, является ли действие важным. Этот атрибут в основном используется элементами панели инструментов для решения вопроса о том, отображать метку или нет.

С: 2.16

gtk_action_get_is_important ()

gboolean
gtk_action_get_is_important (GtkAction *action);

Проверяет, является ли action важным.

С: 2.16

Свойство “action-group”

  “action-group”             GtkActionGroup *

Группа GtkActionGroup, к которой относится этот GtkAction, или NULL (для внутреннего использования).

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

Свойство “always-show-image”

  “always-show-image”        gboolean

Если TRUE, то дочерние элементы меню действия будут игнорировать настройку “gtk-menu-images” и всегда показывать своё изображение, если оно доступно.

Используйте это свойство, если элемент меню бесполезен или сложен в использовании без его изображения.

Флаги: Чтение / Запись / Создание

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

С версии: 2.20

Свойство “gicon”

  “gicon”                    GIcon *

GIcon, отображаемый в GtkAction.

Обратите внимание, что значок по умолчанию предпочтительнее, если свойство “stock-id” содержит идентификатор существующего значка по умолчанию.

Это свойство внешнего вида, поэтому оно применяется только если “use-action-appearance” равно TRUE.

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

С версии: 2.16

Свойство “hide-if-empty”

  “hide-if-empty”            gboolean

Если TRUE, пустые дочерние элементы меню для этого действия скрываются.

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

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

Свойство “icon-name”

  “icon-name”                gchar *

Имя значка из темы значков.

Обратите внимание, что значок по умолчанию предпочтительнее, если свойство “stock-id” содержит идентификатор существующего значка по умолчанию, и значок GIcon предпочтительнее, если свойство “gicon” задано.

Это свойство внешнего вида, поэтому оно применяется только если “use-action-appearance” равно TRUE.

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

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

С версии: 2.10

Свойство “is-important”

  “is-important”             gboolean

Является ли действие важным. Если TRUE, прокси-объекты toolitem для этого действия показывают текст в режиме GTK_TOOLBAR_BOTH_HORIZ.

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

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

Свойство “label”

  “label”                    gchar *

Текст метки для элементов меню и кнопок, активирующих это действие. Если метка равна NULL, GTK+ использует метку по умолчанию, указанную через свойство stock-id.

Это свойство внешнего вида, поэтому оно применяется только если “use-action-appearance” равно TRUE.

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

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

Свойство “name”

  “name”                     gchar *

Уникальное имя действия.

Флаги: Чтение / Запись / Только создание

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

Свойство “sensitive”

  “sensitive”                gboolean

Включено ли действие.

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

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

Свойство “short-label”

  “short-label”              gchar *

Более короткая метка, которая может использоваться на кнопках панели инструментов.

Это свойство внешнего вида, поэтому оно применяется только если “use-action-appearance” равно TRUE.

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

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

Свойство “stock-id”

  “stock-id”                 gchar *

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

Это свойство внешнего вида, поэтому оно применяется только если “use-action-appearance” равно TRUE.

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

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

Свойство “tooltip”

  “tooltip”                  gchar *

Подсказка для этого действия.

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

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

Свойство “visible”

  “visible”                  gboolean

Видимость действия.

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

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

Свойство “visible-horizontal”

  “visible-horizontal”       gboolean

Видимость элемента панели инструментов в горизонтальной ориентации.

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

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

Свойство “visible-overflown”

  “visible-overflown”        gboolean

Если TRUE, плейсхолдеры элементов управления для данного действия отображаются в всплывающем меню палитры.

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

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

С версии: 2.6

Свойство “visible-vertical”

  “visible-vertical”         gboolean

Определяет, будет ли элемент управления палитры отображаться при вертикальной ориентации палитры.

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

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