GtkActionable

gtk_actionable_get_action_name ()

const gchar *
gtk_actionable_get_action_name (GtkActionable *actionable);

Получает имя действия для actionable .

См. gtk_actionable_set_action_name() для получения дополнительной информации.

С: 3.4

gtk_actionable_set_action_name ()

void
gtk_actionable_set_action_name (GtkActionable *actionable,
                                const gchar *action_name);

Устанавливает имя действия, с которым должен быть связан этот виджет. Если action_name равно NULL, виджет будет отключен от любого предыдущего действия.

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

Имена имеют вид «win.save» или «app.quit» для действий в содержащем GtkApplicationWindow или связанном GtkApplication соответственно. Это тот же формат, который используется для действий в GMenu, связанном с окном.

С: 3.4

gtk_actionable_get_action_target_value ()

GVariant *
gtk_actionable_get_action_target_value
                               (GtkActionable *actionable);

Получает текущее целевое значение actionable .

См. gtk_actionable_set_action_target_value() для получения дополнительной информации.

С: 3.4

gtk_actionable_set_action_target_value ()

void
gtk_actionable_set_action_target_value
                               (GtkActionable *actionable,
                                GVariant *target_value);

Устанавливает целевое значение виджета actionable.

Если target_value равно NULL, целевое значение сбрасывается.

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

Рассмотрим пример связывания набора кнопок с GAction со строковым состоянием в типичной ситуации с «кнопками радио». Каждая кнопка будет связана с одним и тем же действием, но с разным целевым значением для этого действия. Нажатие на конкретную кнопку активирует действие с целевым значением этой кнопки, что обычно приведет к изменению состояния действия на это значение. Поскольку состояние действия теперь равно целевому значению кнопки, кнопка теперь будет отображаться как активная (и другие кнопки с другими целями будут отображаться как неактивные).

С: 3.4

gtk_actionable_set_action_target ()

void
gtk_actionable_set_action_target (GtkActionable *actionable,
                                  const gchar *format_string,
                                  ...);

Устанавливает цель виджета actionable.

Это вспомогательная функция, которая вызывает g_variant_new() для format_string и использует результат для вызова gtk_actionable_set_action_target_value().

Если вы устанавливаете целевое значение типа строка и хотите одновременно установить имя действия, вы можете использовать gtk_actionable_set_detailed_action_name().

С: 3.4

gtk_actionable_set_detailed_action_name ()

void
gtk_actionable_set_detailed_action_name
                               (GtkActionable *actionable,
                                const gchar *detailed_action_name);

Устанавливает имя действия и связанное строковое целевое значение виджета actionable.

detailed_action_name — это строка в формате, принимаемом g_action_parse_detailed_name().

(Обратите внимание, что до версии 3.22.25 эта функция может использоваться только для действий с простым целевым значением «s», и detailed_action_name должно быть в формате "action::target", где action — имя действия, а target — строка, используемая в качестве цели.)

С: 3.4

GtkActionable

typedef struct _GtkActionable GtkActionable;

Тип указателя непрозрачного типа.

struct GtkActionableInterface

struct GtkActionableInterface {
  const gchar * (* get_action_name)             (GtkActionable *actionable);
  void          (* set_action_name)             (GtkActionable *actionable,
                                                 const gchar   *action_name);
  GVariant *    (* get_action_target_value)     (GtkActionable *actionable);
  void          (* set_action_target_value)     (GtkActionable *actionable,
                                                 GVariant      *target_value);
};

Интерфейсная таблица виртуальных функций для GtkActionable.

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

  “action-name”              char *

Имя связанного действия, например, 'app.quit'.

Владелец: GtkActionable

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

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

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

  “action-target”            GVariant *

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

Владелец: GtkActionable

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

Разрешенные значения: GVariant<*>

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