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(). См. раздел Определения пользовательского интерфейса для информации о разрешённых именах действий.

С: 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, прокси-элементы инструмента для этого действия отображают текст в режиме 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