GtkActionable

gtk_actionable_get_action_name ()

const char *
gtk_actionable_get_action_name (GtkActionable *actionable);

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

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

gtk_actionable_set_action_name ()

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

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

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

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

gtk_actionable_get_action_target_value ()

GVariant *
gtk_actionable_get_action_target_value
                               (GtkActionable *actionable);

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

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

gtk_actionable_set_action_target_value ()

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

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

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

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

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

gtk_actionable_set_action_target ()

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

Устанавливает целевой виджет.

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

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

gtk_actionable_set_detailed_action_name ()

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

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

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

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

GtkActionable

typedef struct _GtkActionable GtkActionable;

Тип указателя.

struct GtkActionableInterface

struct GtkActionableInterface {
  const char * (* get_action_name)             (GtkActionable *actionable);
  void          (* set_action_name)             (GtkActionable *actionable,
                                                 const char    *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