GtkAction

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

Функции

GtkAction *	gtk_action_new ()
const gchar *	gtk_action_get_name ()
gboolean	gtk_action_is_sensitive ()
gboolean	gtk_action_get_sensitive ()
void	gtk_action_set_sensitive ()
gboolean	gtk_action_is_visible ()
gboolean	gtk_action_get_visible ()
void	gtk_action_set_visible ()
void	gtk_action_activate ()
GtkWidget *	gtk_action_create_icon ()
GtkWidget *	gtk_action_create_menu_item ()
GtkWidget *	gtk_action_create_tool_item ()
GtkWidget *	gtk_action_create_menu ()
GSList *	gtk_action_get_proxies ()
void	gtk_action_connect_accelerator ()
void	gtk_action_disconnect_accelerator ()
void	gtk_action_block_activate ()
void	gtk_action_unblock_activate ()
gboolean	gtk_action_get_always_show_image ()
void	gtk_action_set_always_show_image ()
const gchar *	gtk_action_get_accel_path ()
void	gtk_action_set_accel_path ()
GClosure *	gtk_action_get_accel_closure ()
void	gtk_action_set_accel_group ()
void	gtk_action_set_label ()
const gchar *	gtk_action_get_label ()
void	gtk_action_set_short_label ()
const gchar *	gtk_action_get_short_label ()
void	gtk_action_set_tooltip ()
const gchar *	gtk_action_get_tooltip ()
void	gtk_action_set_stock_id ()
const gchar *	gtk_action_get_stock_id ()
void	gtk_action_set_gicon ()
GIcon *	gtk_action_get_gicon ()
void	gtk_action_set_icon_name ()
const gchar *	gtk_action_get_icon_name ()
void	gtk_action_set_visible_horizontal ()
gboolean	gtk_action_get_visible_horizontal ()
void	gtk_action_set_visible_vertical ()
gboolean	gtk_action_get_visible_vertical ()
void	gtk_action_set_is_important ()

gboolean

gtk_action_get_is_important ()

Свойства

GtkActionGroup *	action-group	Чтение / Запись
gboolean	always-show-image	Чтение / Запись / Создание
GIcon *	gicon	Чтение / Запись
gboolean	hide-if-empty	Чтение / Запись
char *	icon-name	Чтение / Запись
gboolean	важность	Чтение / Запись
char *	метка	Чтение / Запись
char *	имя	Чтение / Запись / Только для создания
gboolean	активен	Чтение / Запись
char *	короткая метка	Чтение / Запись
char *	идентификатор изображения	Чтение / Запись
char *	подсказка	Чтение / Запись
gboolean	виден	Чтение / Запись
gboolean	виден горизонтально	Чтение / Запись
gboolean	виден при переполнении	Чтение / Запись
gboolean	виден вертикально	Чтение / Запись

Сигналы

void

активация

Без рекурсии

Типы и значения

struct	GtkAction
struct	GtkActionClass

Иерархия объектов

    GObject
    ╰── GtkAction
        ├── GtkToggleAction
        ╰── GtkRecentAction

Реализованные интерфейсы

GtkAction реализует GtkBuildable.

Включенные файлы

#include <gtk/gtk.h>

Описание

В GTK+ 3.10, GtkAction устарел. Используйте GAction вместо него и связывайте действия с виджетами GtkActionable. Используйте GMenuModel для создания меню с помощью gtk_menu_new_from_model().

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

Помимо обратного вызова, который вызывается при активации действия, с ним также связаны:

имя (не переводится, для поиска по пути)
метка (переводится, для отображения)
горячая клавиша
указывает ли метка на идентификатор изображения
подсказка (необязательно, переводится)
метка панели инструментов (необязательно, короче, чем метка)

Действие также будет иметь информацию о состоянии:

виден (отображается/скрыт)
активен (включен/выключен)

Помимо обычных действий, есть переключаемые действия, которые могут быть переключены между двумя состояниями, и радио-действия, из которых только одно в группе может быть в состоянии «активно». Другие действия могут быть реализованы как подклассы GtkAction.

У каждого действия может быть один или несколько виджетов-прокси. Для того, чтобы выступать в качестве прокси действия, виджет должен реализовывать интерфейс GtkActivatable. Прокси отражают состояние действия и должны изменяться при изменении состояния действия. Свойства, которые всегда отражаются прокси, — это «активен» и «виден». Свойства «gicon», «icon-name», «метка», «короткая метка» и «идентификатор изображения» отражаются только если у виджета-прокси свойство «использовать вид действия» установлено в TRUE.

При активации прокси он должен активировать связанное действие.

Функции

gtk_action_new ()

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

gtk_action_new устарела с версии 3.10 и не должна использоваться в новых кодах.

Используйте GAction вместо этого, ассоциируя его с виджетом с помощью GtkActionable или создавая GtkMenu с помощью gtk_menu_new_from_model().

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

Параметры

name	Уникальное имя действия
label	метка, отображаемая в пунктах меню и на кнопках, или `NULL`.	[allow-none]
tooltip	подсказка для действия, или `NULL`.	[allow-none]
stock_id	иконка из набора стандартных иконок для отображения в виджетах, представляющих действие, или `NULL`.	[allow-none]

Возвращаемое значение

новый объект GtkAction

С версии: 2.4

gtk_action_get_name ()

const gchar *
gtk_action_get_name (GtkAction *action);

gtk_action_get_name устарела с версии 3.10 и не должна использоваться в новых кодах.

Используйте g_action_get_name() для GAction вместо этого

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

Параметры

action

объект действия

Возвращаемое значение

имя действия. Строка принадлежит GTK+ и не должна освобождаться.

С версии: 2.4

gtk_action_is_sensitive ()

gboolean
gtk_action_is_sensitive (GtkAction *action);

gtk_action_is_sensitive устарела с версии 3.10 и не должна использоваться в новых кодах.

Используйте g_action_get_enabled() для GAction вместо этого

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

Параметры

action

объект действия

Возвращаемое значение

значение TRUE, если и действие, и связанная группа действий оба чувствительны.

С версии: 2.4

gtk_action_get_sensitive ()

gboolean
gtk_action_get_sensitive (GtkAction *action);

gtk_action_get_sensitive устарела с версии 3.10 и не должна использоваться в новых кодах.

Используйте g_action_get_enabled() для GAction вместо этого

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

Параметры

action

объект действия

Возвращаемое значение

значение TRUE, если само действие чувствительно.

С версии: 2.4

gtk_action_set_sensitive ()

void
gtk_action_set_sensitive (GtkAction *action,
                          gboolean sensitive);

gtk_action_set_sensitive устарела с версии 3.10 и не должна использоваться в новых кодах.

Используйте g_simple_action_set_enabled() для GSimpleAction вместо этого

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

Параметры

action	объект действия
sensitive	`TRUE` для активации чувствительности действия

С версии: 2.6

gtk_action_is_visible ()

gboolean
gtk_action_is_visible (GtkAction *action);

gtk_action_is_visible устарела с версии 3.10 и не должна использоваться в новых кодах.

Используйте GAction вместо этого и контролируйте состояние виджетов GtkActionable напрямую.

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

Параметры

action

объект действия

Возвращаемое значение

TRUE если и действие, и связанная группа действий оба видны.

С версии: 2.4

gtk_action_get_visible ()

gboolean
gtk_action_get_visible (GtkAction *action);

gtk_action_get_visible устарела с версии 3.10 и не должна использоваться в новых кодах.

Используйте GAction вместо этого и контролируйте состояние виджетов GtkActionable напрямую.

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

Параметры

action

объект действия

Возвращаемое значение

TRUE если само действие видно.

С версии: 2.4

gtk_action_set_visible ()

void
gtk_action_set_visible (GtkAction *action,
                        gboolean visible);

gtk_action_set_visible устарела с версии 3.10 и не должна использоваться в новых кодах.

Используйте GAction вместо этого и контролируйте состояние виджетов GtkActionable напрямую.

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

Параметры

action	объект действия
visible	`TRUE` для отображения действия

С версии: 2.6

gtk_action_activate ()

void
gtk_action_activate (GtkAction *action);

gtk_action_activate устарела с версии 3.10 и не должна использоваться в новых кодах.

Используйте g_action_group_activate_action() для GAction вместо этого

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

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

Параметры

action

объект действия

С версии: 2.4

gtk_action_create_icon ()

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

gtk_action_create_icon устарело с версии 3.10 и не должно использоваться в новых кодах.

Используйте g_menu_item_set_icon() для установки значка на GMenuItem или gtk_container_add() для добавления GtkImage в GtkButton

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

Параметры

action	объект действия
icon_size	размер значка (GtkIconSize), который должен быть создан.	[type int]

Возвращаемое значение

виджет, отображающий значок для этого действия.

[transfer none]

С: 2.4

GtkWidget *
gtk_action_create_menu_item (GtkAction *action);

gtk_action_create_menu_item устарело с версии 3.10 и не должно использоваться в новых кодах.

Используйте g_menu_item_new() и свяжите его с GAction вместо этого.

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

Параметры

action

объект действия

Возвращаемое значение

пункт меню, подключённый к действию.

[transfer none]

С: 2.4

gtk_action_create_tool_item ()

GtkWidget *
gtk_action_create_tool_item (GtkAction *action);

gtk_action_create_tool_item устарело с версии 3.10 и не должно использоваться в новых кодах.

Используйте GtkToolItem и свяжите его с GAction с помощью gtk_actionable_set_action_name() вместо этого

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

Параметры

action

объект действия

Возвращаемое значение

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

[transfer none]

С: 2.4

GtkWidget *
gtk_action_create_menu (GtkAction *action);

gtk_action_create_menu устарело с версии 3.10 и не должно использоваться в новых кодах.

Используйте GAction и GMenuModel вместо этого, и создайте GtkMenu с помощью gtk_menu_new_from_model()

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

Параметры

action

a GtkAction

Возвращаемое значение

пункт меню, предоставленный действием, или NULL.

[transfer none]

С: 2.12

gtk_action_get_proxies ()

GSList *
gtk_action_get_proxies (GtkAction *action);

gtk_action_get_proxies устарело с версии 3.10 и не должно использоваться в новых кодах.

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

Параметры

action

объект действия

Возвращаемое значение

a GSList виджетов-прокси. Список принадлежит GTK+ и не должен быть изменён.

[element-type GtkWidget][transfer none]

С: 2.4

gtk_action_connect_accelerator ()

void
gtk_action_connect_accelerator (GtkAction *action);

gtk_action_connect_accelerator устарело с версии 3.10 и не должно использоваться в новых кодах.

Используйте GAction и группу акселераторов на ассоциированном GtkMenu вместо этого

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

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

Параметры

action

a GtkAction

С: 2.4

gtk_action_disconnect_accelerator ()

void
gtk_action_disconnect_accelerator (GtkAction *action);

gtk_action_disconnect_accelerator устарело с версии 3.10 и не должно использоваться в новых кодах.

Используйте GAction и группу акселераторов на ассоциированном GtkMenu вместо этого

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

Параметры

action

a GtkAction

С: 2.4

gtk_action_block_activate ()

void
gtk_action_block_activate (GtkAction *action);

gtk_action_block_activate устарело с версии 3.10 и не должно использоваться в новых кодах.

Используйте g_simple_action_set_enabled() для отключения GSimpleAction вместо этого

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

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

Параметры

action

a GtkAction

С: 2.16

gtk_action_unblock_activate ()

void
gtk_action_unblock_activate (GtkAction *action);

gtk_action_unblock_activate устарело с версии 3.10 и не должно использоваться в новых кодах.

Используйте g_simple_action_set_enabled() для включения GSimpleAction вместо этого

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

Параметры

action

a GtkAction

С: 2.16

gtk_action_get_always_show_image ()

gboolean
gtk_action_get_always_show_image (GtkAction *action);

gtk_action_get_always_show_image устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте g_menu_item_get_attribute_value() для GMenuItem вместо этого.

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

Параметры

action

объект GtkAction

Возвращаемое значение

TRUE если элемент меню всегда будет отображать изображение.

С: 2.20

gtk_action_set_always_show_image ()

void
gtk_action_set_always_show_image (GtkAction *action,
                                  gboolean always_show);

gtk_action_set_always_show_image устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте g_menu_item_set_icon() для GMenuItem, если элемент должен иметь изображение.

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

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

Параметры

action	объект GtkAction
always_show	`TRUE` если элемент меню должен всегда отображать своё изображение

С: 2.20

gtk_action_get_accel_path ()

const gchar *
gtk_action_get_accel_path (GtkAction *action);

gtk_action_get_accel_path устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте GAction и путь ускорителя на связанном GtkMenu вместо этого.

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

Параметры

action

объект действия

Возвращаемое значение

путь ускорителя для данного действия или NULL если не задан. Возвращаемая строка принадлежит GTK+ и не должна освобождаться или изменяться.

С: 2.6

gtk_action_set_accel_path ()

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

gtk_action_set_accel_path устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте GAction и путь ускорителя на связанном GtkMenu вместо этого.

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

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

Параметры

action	объект действия
accel_path	путь ускорителя

С: 2.4

gtk_action_get_accel_closure ()

GClosure *
gtk_action_get_accel_closure (GtkAction *action);

gtk_action_get_accel_closure устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте GAction и GtkMenu вместо этого, так как у них нет эквивалента для получения accel-закрытия.

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

Параметры

action

объект действия

Возвращаемое значение

accel-закрытие для данного действия. Возвращаемое закрытие принадлежит GTK+ и не должно быть освобождено или изменено.

[transfer none]

С: 2.8

gtk_action_set_accel_group ()

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

gtk_action_set_accel_group устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте GAction и группу ускорителей на связанном GtkMenu вместо этого.

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

Параметры

action	объект действия
accel_group	GtkAccelGroup или `NULL`.	[allow-none]

С: 2.4

gtk_action_set_label ()

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

gtk_action_set_label устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте GAction вместо этого и установите метку элемента меню с помощью g_menu_item_set_label(). Для виджетов GtkActionable используйте API, специфичное для виджета, чтобы установить метку.

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

Параметры

action	объект GtkAction
label	текст метки для установки

С: 2.16

gtk_action_get_label ()

const gchar *
gtk_action_get_label (GtkAction *action);

gtk_action_get_label устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте GAction вместо этого, и получите метку элемента меню с g_menu_item_get_attribute_value(). Для виджетов GtkActionable используйте API, специфичное для виджета, чтобы получить метку.

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

Параметры

action

объект GtkAction

Возвращаемое значение

текст метки

С: 2.16

gtk_action_set_short_label ()

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

gtk_action_set_short_label устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте GAction вместо этого, так как у него нет эквивалента коротких меток.

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

Параметры

action	объект GtkAction
short_label	текст метки для установки

С: 2.16

gtk_action_get_short_label ()

const gchar *
gtk_action_get_short_label (GtkAction *action);

gtk_action_get_short_label устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте GAction вместо этого, так как у него нет эквивалента коротких меток.

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

Параметры

action

объект GtkAction

Возвращаемое значение

текст короткой метки.

С: 2.16

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

gtk_action_set_tooltip устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте GAction вместо этого и установите подсказки для связанных виджетов GtkActionable с помощью gtk_widget_set_tooltip_text()

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

Параметры

action	a GtkAction
tooltip	текст подсказки

С версии: 2.16

const gchar *
gtk_action_get_tooltip (GtkAction *action);

gtk_action_get_tooltip устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте GAction вместо этого и получайте подсказки из связанных виджетов GtkActionable с помощью gtk_widget_get_tooltip_text()

Получает текст подсказки action .

Параметры

action

a GtkAction

Возвращает

текст подсказки

С версии: 2.16

gtk_action_set_stock_id ()

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

gtk_action_set_stock_id устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте GAction вместо этого, у которого нет эквивалента стандартных элементов

Устанавливает стандартный идентификатор для action

Параметры

action	a GtkAction
stock_id	стандартный идентификатор

С версии: 2.16

gtk_action_get_stock_id ()

const gchar *
gtk_action_get_stock_id (GtkAction *action);

gtk_action_get_stock_id устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте GAction вместо этого, у которого нет эквивалента стандартных элементов

Получает стандартный идентификатор action .

Параметры

action

a GtkAction

Возвращает

стандартный идентификатор

С версии: 2.16

gtk_action_set_gicon ()

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

gtk_action_set_gicon устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте GAction вместо этого и g_menu_item_set_icon() для установки значка в GMenuItem, связанном с GAction, или gtk_container_add() для добавления GtkImage в GtkButton

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

Параметры

action	a GtkAction
icon	устанавливаемый GIcon

С версии: 2.16

gtk_action_get_gicon ()

GIcon *
gtk_action_get_gicon (GtkAction *action);

gtk_action_get_gicon устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте GAction вместо этого и g_menu_item_get_attribute_value() для получения значка из GMenuItem, связанного с GAction

Получает gicon action .

Параметры

action

a GtkAction

Возвращает

GIcon действия, если он установлен.

[transfer none]

С версии: 2.16

gtk_action_set_icon_name ()

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

gtk_action_set_icon_name устарела начиная с версии 3.10 и не должна использоваться в новом коде.

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

Параметры

action	a GtkAction
icon_name	устанавливаемое имя значка

С версии: 2.16

gtk_action_get_icon_name ()

const gchar *
gtk_action_get_icon_name (GtkAction *action);

gtk_action_get_icon_name устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте GAction вместо этого и g_menu_item_get_attribute_value() для получения значка из GMenuItem, связанного с GAction

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

Параметры

action

a GtkAction

Возвращает

имя значка

С версии: 2.16

gtk_action_set_visible_horizontal ()

void
gtk_action_set_visible_horizontal (GtkAction *action,
                                   gboolean visible_horizontal);

gtk_action_set_visible_horizontal устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте GAction вместо этого и управляйте видимостью связанных виджетов и элементов меню напрямую

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

Параметры

action	a GtkAction
visible_horizontal	видимость действия в горизонтальном режиме

С версии: 2.16

gtk_action_get_visible_horizontal ()

gboolean
gtk_action_get_visible_horizontal (GtkAction *action);

gtk_action_get_visible_horizontal устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте GAction вместо этого и управляйте видимостью связанных виджетов и элементов меню напрямую

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

Параметры

action

a GtkAction

Возвращает

видим ли action в горизонтальном режиме

С версии: 2.16

gtk_action_set_visible_vertical ()

void
gtk_action_set_visible_vertical (GtkAction *action,
                                 gboolean visible_vertical);

gtk_action_set_visible_vertical устарело начиная с версии 3.10 и не должно использоваться в новом коде.

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

Устанавливает, отображается ли action при вертикальном отображении.

Параметры

action	a GtkAction
visible_vertical	отображается ли действие вертикально

С: 2.16

gtk_action_get_visible_vertical ()

gboolean
gtk_action_get_visible_vertical (GtkAction *action);

gtk_action_get_visible_vertical устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Проверяет, отображается ли action при горизонтальном отображении.

Параметры

action

a GtkAction

Возвращаемое значение

отображается ли action при горизонтальном отображении

С: 2.16

gtk_action_set_is_important ()

void
gtk_action_set_is_important (GtkAction *action,
                             gboolean is_important);

gtk_action_set_is_important устарело начиная с версии 3.10 и не должно использоваться в новом коде.

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

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

Параметры

action	объект действия
is_important	`TRUE` для обозначения действия как важного

С: 2.16

gtk_action_get_is_important ()

gboolean
gtk_action_get_is_important (GtkAction *action);

gtk_action_get_is_important устарело начиная с версии 3.10 и не должно использоваться в новом коде.

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

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

Параметры

action

a GtkAction

Возвращаемое значение

является ли action важным

С: 2.16

Типы и значения

struct GtkAction

struct GtkAction;

struct GtkActionClass

struct GtkActionClass {
  GObjectClass parent_class;

  /* activation signal */
  void       (* activate)           (GtkAction    *action);
};

Члены

activate ()

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

Подробные сведения о свойствах

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

  “action-group”             GtkActionGroup *

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

GtkAction:action-group устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Найдите GAction с помощью g_action_map_lookup_action() вместо этого.

Владелец: GtkAction

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

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

  “always-show-image”        gboolean

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

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

GtkAction:always-show-image устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Нет соответствующей замены при использовании GAction

Владелец: GtkAction

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

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

С версии: 2.20

Свойство `“gicon”`

  “gicon”                    GIcon *

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

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

Это свойство отображения, и оно применяется только если свойство «use-action-appearance» равно TRUE.

GtkAction:gicon устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Вместо этого используйте атрибут "icon" для GMenuItem

Владелец: GtkAction

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

С версии: 2.16

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

  “hide-if-empty”            gboolean

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

GtkAction:hide-if-empty устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Нет соответствующей замены при использовании GAction

Владелец: GtkAction

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

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

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

  “icon-name”                char *

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

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

Это свойство отображения, и оно применяется только если свойство «use-action-appearance» равно TRUE.

GtkAction:icon-name устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Вместо этого используйте атрибут "icon" для GMenuItem

Владелец: GtkAction

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

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

С версии: 2.10

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

  “is-important”             gboolean

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

GtkAction:is-important устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Нет соответствующей замены при использовании GAction

Владелец: GtkAction

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

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

Свойство `“label”`

  “label”                    char *

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

Это свойство отображения, и оно применяется только если свойство «use-action-appearance» равно TRUE.

GtkAction:label устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Вместо этого используйте атрибут "label" для GMenuItem

Владелец: GtkAction

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

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

Свойство `“name”`

  “name”                     char *

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

GtkAction:name устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Используйте «name» вместо этого.

Владелец: GtkAction

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

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

Свойство `“sensitive”`

  “sensitive”                gboolean

Указывает, активировано ли действие.

GtkAction:sensitive устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Используйте «enabled» и «enabled» вместо этого.

Владелец: GtkAction

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

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

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

  “short-label”              char *

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

Это свойство отображения, и оно применяется только если свойство «use-action-appearance» равно TRUE.

GtkAction:short-label устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Нет соответствующей замены при использовании GAction

Владелец: GtkAction

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

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

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

  “stock-id”                 char *

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

Это свойство отображения, и оно применяется только если свойство «use-action-appearance» равно TRUE.

GtkAction:stock-id устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Нет соответствующей замены при использовании GAction

Владелец: GtkAction

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

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

Свойство `“tooltip”`

  “tooltip”                  char *

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

GtkAction:tooltip устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Вместо этого используйте gtk_widget_set_tooltip_text()

Владелец: GtkAction

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

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

Свойство `“visible”`

  “visible”                  gboolean

Указывает, видно ли действие.

GtkAction:visible устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Нет соответствующей замены при использовании GAction

Владелец: GtkAction

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

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

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

  “visible-horizontal”       gboolean

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

GtkAction:visible-horizontal устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Нет соответствующей замены при использовании GAction

Владелец: GtkAction

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

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

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

  “visible-overflown”        gboolean

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

GtkAction:visible-overflown устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Нет соответствующей замены при использовании GAction

Владелец: GtkAction

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

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

С версии: 2.6

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

  “visible-vertical”         gboolean

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

GtkAction:visible-vertical устарело начиная с версии 3.10 и не должно использоваться в новом коде.

Нет соответствующей замены при использовании GAction

Владелец: GtkAction

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

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

Подробное описание сигналов

Сигнал `“activate”`

void
user_function (GtkAction *action,
               gpointer   user_data)

Сигнал «activate» генерируется, когда действие активировано.

GtkAction::activate устарел начиная с версии 3.10 и не должен использоваться в новом коде.

Используйте “activate” вместо него.

Параметры

action	действие GtkAction
user_data	данные пользователя, установленные при подключении обработчика сигнала.

Флаги: Без рекурсии

С версии: 2.4

См. также

GtkActionGroup, GtkUIManager, GtkActivatable

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkAction.html

GtkAction

Функции

Свойства

Сигналы

Типы и значения

Иерархия объектов

Реализованные интерфейсы

Включенные файлы

Описание

Функции

gtk_action_new ()

Параметры

Возвращаемое значение

gtk_action_get_name ()

Параметры

Возвращаемое значение

gtk_action_is_sensitive ()

Параметры

Возвращаемое значение

gtk_action_get_sensitive ()

Параметры

Возвращаемое значение

gtk_action_set_sensitive ()

Параметры

gtk_action_is_visible ()

Параметры

Возвращаемое значение

gtk_action_get_visible ()

Параметры

Возвращаемое значение

gtk_action_set_visible ()

Параметры

gtk_action_activate ()

Параметры

gtk_action_create_icon ()

Параметры

Возвращаемое значение

gtk_action_create_menu_item ()

Параметры

Возвращаемое значение

gtk_action_create_tool_item ()

Параметры

Возвращаемое значение

gtk_action_create_menu ()

Параметры

Возвращаемое значение

gtk_action_get_proxies ()

Параметры

Возвращаемое значение

gtk_action_connect_accelerator ()

Параметры

gtk_action_disconnect_accelerator ()

Параметры

gtk_action_block_activate ()

Параметры

gtk_action_unblock_activate ()

Параметры

gtk_action_get_always_show_image ()

Параметры

Возвращаемое значение

gtk_action_set_always_show_image ()

Параметры

gtk_action_get_accel_path ()

Параметры

Возвращаемое значение

gtk_action_set_accel_path ()

Параметры

gtk_action_get_accel_closure ()

Параметры

Возвращаемое значение

gtk_action_set_accel_group ()

Параметры

gtk_action_set_label ()

Параметры

gtk_action_get_label ()

Параметры

Возвращаемое значение

gtk_action_set_short_label ()

Параметры

gtk_action_get_short_label ()

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

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

Свойство `“gicon”`

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

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

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

Свойство `“label”`

Свойство `“name”`

Свойство `“sensitive”`

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

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

Свойство `“tooltip”`

Свойство `“visible”`

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

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

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

Сигнал `“activate”`