краткое описание

#include <gtk/gtk.h>

            gtkradioaction;
gtkradioaction* gtk_radio_action_new        (const gchar *name,
                                             const gchar *label,
                                             const gchar *tooltip,
                                             const gchar *stock_id,
                                             gint value);

gslist*     gtk_radio_action_get_group      (gtkradioaction *action);
void        gtk_radio_action_set_group      (gtkradioaction *action,
                                             gslist *group);

gint        gtk_radio_action_get_current_value
                                            (gtkradioaction *action);
void        gtk_radio_action_set_current_value
                                            (gtkradioaction *action,
                                             gint current_value);

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

  gobject
   +----gtkaction
         +----gtktoggleaction

               +----gtkradioaction

свойства

  "current-value"        gint                  : read / write
  "group"                gtkradioaction        : write
  "value"                gint                  : read / write

сигналы

"changed"   void        user_function      (gtkradioaction *action,
                                            gtkradioaction *current,
                                            gpointer        user_data)      : run first / no recursion

описание

gtkradioaction похож на gtkradiomenuitem. несколько действий соединено в группу так, чтобы только одно из них могло быть активно в определенный момент времени.

детали

gtkradioaction

typedef struct _gtkradioaction gtkradioaction;

gtkradioaction структура содержит только закрытые данные к которым нет непосредственного доступа.

gtk_radio_action_new ()

gtkradioaction* gtk_radio_action_new        (const gchar *name,
                                             const gchar *label,
                                             const gchar *tooltip,
                                             const gchar *stock_id,
                                             gint value);

создаёт новый объект gtkradioaction. для добавления действия к gtkactiongroup и установки акселератора, вызовите gtk_action_group_add_action_with_accel().

начиная с версии 2.4

gtk_radio_action_get_group ()

gslist*     gtk_radio_action_get_group      (gtkradioaction *action);

возвращает список который представляет радио-группу для данного объекта. помните, возвращаемый список допустим только до следующего изменения группы.

обычный способ установки группы для радио-группы следующий:

  gslist *group = null;
  gtkradioaction *action;
 
  while (/* количество действий для добавления */)
    {
       action = gtk_radio_action_new (...);
       
       gtk_radio_action_set_group (action, group);
       group = gtk_radio_action_get_group (action);
    }

начиная с версии 2.4

gtk_radio_action_set_group ()

void        gtk_radio_action_set_group      (gtkradioaction *action,
                                             gslist *group);

устанавливает радио-группу для объекта радио-действия.

начиная с версии 2.4

gtk_radio_action_get_current_value ()

gint        gtk_radio_action_get_current_value
                                            (gtkradioaction *action);

определяет значение свойства текущемго активного объекта в группе к которому принадлежит action.

начиная с версии 2.4

gtk_radio_action_set_current_value ()

void        gtk_radio_action_set_current_value
                                            (gtkradioaction *action,
                                             gint current_value);

устанавливает текущий активный член группы в значение свойства current_value.

начиная с версии 2.10

детали свойств

свойство "current-value"

  "current-value"        gint                  : read / write

значение свойства текущемго активного члена группы к которой принадлежит определенное действие.

значение по умолчанию: 0

начиная с версии 2.10

свойство "group"

  "group"                gtkradioaction        : write

устанавливает новую группу для радио-действия.

начиная с версии 2.4

свойство "value"

  "value"                gint                  : read / write

значение произвольного целочисленного которое может использоваться как удобный способ определения какое действие в группе в текущий момент активно обработчиком сигналов ::activate или ::changed. смотрите gtk_radio_action_get_current_value() и gtkradioactionentry как удобный способ получения и установки этого свойства.

значение по умолчанию: 0

начиная с версии 2.4

детали сигналов

сигнал "changed"

void        user_function                  (gtkradioaction *action,
                                            gtkradioaction *current,
                                            gpointer        user_data)      : run first / no recursion

сигнал ::changed издаётся на каждом члене группы когда активный член радио-группы изменяется. сигнал издаётся после ::activate сигналов для предыдущих и текущих активных членов группы.

начиная с версии 2.4