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.

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

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”              gchar *

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

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

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

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

  “action-target”            GVariant *

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

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

Допустимые значения: GVariant<*>

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