GtkRadioAction

GtkRadioAction — Действие, из группы которого только одно может быть активным

Функции

GtkRadioAction *	gtk_radio_action_new ()
GSList *	gtk_radio_action_get_group ()
void	gtk_radio_action_set_group ()
void	gtk_radio_action_join_group ()
gint	gtk_radio_action_get_current_value ()
void	gtk_radio_action_set_current_value ()

Свойства

int	current-value	Чтение / Запись
GtkRadioAction *	group	Запись
int	value	Чтение / Запись

Сигналы

void

changed

Без рекурсии

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

struct

GtkRadioAction

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

    GObject
    ╰── GtkAction
        ╰── GtkToggleAction
            ╰── GtkRadioAction

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

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

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

#include <gtk/gtk.h>

Описание

A GtkRadioAction похож на GtkRadioMenuItem. Несколько радио-действий могут быть связаны вместе, так что только одно может быть активным в любой момент времени.

Функции

gtk_radio_action_new ()

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

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

Создаёт новый объект GtkRadioAction. Чтобы добавить действие в GtkActionGroup и установить его сочетание клавиш, вызовите gtk_action_group_add_action_with_accel().

Параметры

name	Уникальное имя действия
label	Метка, отображаемая в пунктах меню и на кнопках, или `NULL`.	[allow-none]
tooltip	Подсказка для этого действия, или `NULL`.	[allow-none]
stock_id	Иконка из набора стандартных иконок, отображаемая в виджетах, представляющих это действие, или `NULL`.	[allow-none]
value	Значение, которое `gtk_radio_action_get_current_value()` должно возвращать, если это действие выбрано.

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

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

С: 2.4

gtk_radio_action_get_group ()

GSList *
gtk_radio_action_get_group (GtkRadioAction *action);

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

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

Общий способ настройки группы радиокнопок:

Параметры

action

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

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

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

[element-type GtkRadioAction][transfer none]

С: 2.4

gtk_radio_action_set_group ()

void
gtk_radio_action_set_group (GtkRadioAction *action,
                            GSList *group);

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

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

Параметры

action	объект действия
group	список, представляющий группу радиокнопок, или `NULL`.	[element-type GtkRadioAction][allow-none]

С: 2.4

gtk_radio_action_join_group ()

void
gtk_radio_action_join_group (GtkRadioAction *action,
                             GtkRadioAction *group_source);

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

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

Используйте это в языковых связках вместо методов gtk_radio_action_get_group() и gtk_radio_action_set_group()

Общий способ настройки группы радиодействий:

GSList *group = NULL;
GtkRadioAction *action;
 
while ( ...more actions to add... /)
  {
     action = gtk_radio_action_new (...);
     
     gtk_radio_action_set_group (action, group);
     group = gtk_radio_action_get_group (action);
  }

Параметры

action	объект действия
group_source	объект радиодействия, к чьей группе мы присоединяемся, или `NULL` для удаления радиодействия из его группы.	[allow-none]

С: 3.0

gtk_radio_action_get_current_value ()

gint
gtk_radio_action_get_current_value (GtkRadioAction *action);

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

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

Параметры

action

объект GtkRadioAction

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

Значение текущего активного члена группы

С: 2.4

gtk_radio_action_set-current-value ()

void
gtk_radio_action_set_current_value (GtkRadioAction *action,
                                    gint current_value);

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

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

Параметры

action	объект GtkRadioAction
current_value	новое значение

С: 2.10

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

struct GtkRadioAction

struct GtkRadioAction;

Подробное описание свойств

Свойство `“current-value”`

  “current-value”            int

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

GtkRadioAction:current-value устарела начиная с версии 3.10 и не должна использоваться в новых кодах.

Владелец: GtkRadioAction

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

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

С: 2.10

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

  “group”                    GtkRadioAction *

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

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

Владелец: GtkRadioAction

Флаги: Запись

С: 2.4

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

  “value”                    int

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

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

Владелец: GtkRadioAction

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

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

С: 2.4

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

Сигнал `“changed”`

void
user_function (GtkRadioAction *action,
               GtkRadioAction *current,
               gpointer        user_data)

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

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

Параметры

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

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

С: 2.4

© 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/GtkRadioAction.html

GtkRadioAction

Функции

Свойства

Сигналы

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

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

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

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

Описание

Функции

gtk_radio_action_new ()

Параметры

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

gtk_radio_action_get_group ()

Параметры

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

gtk_radio_action_set_group ()

Параметры

gtk_radio_action_join_group ()

Параметры

gtk_radio_action_get_current_value ()

Параметры

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

gtk_radio_action_set-current-value ()

Параметры

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

struct GtkRadioAction

Подробное описание свойств

Свойство “current-value”

Свойство “group”

Свойство “value”

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

Сигнал “changed”

Параметры

Свойство `“current-value”`

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

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

Сигнал `“changed”`