GtkRadioAction
GtkRadioAction — Действие, из которого только одно может быть активным в группе
Функции
Свойства
| gint | current-value | Чтение / Запись |
| GtkRadioAction * | группа | Запись |
| gint | значение | Чтение / Запись |
Сигналы
| void | изменён | Без рекурсии |
Типы и значения
| 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 | Метка, отображаемая в пунктах меню и на кнопках, или | [allow-none] |
tooltip | Подсказка для этого действия, или | [allow-none] |
stock_id | Иконка для отображения в виджетах, представляющих это действие, или | [allow-none] |
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 | список, представляющий группу радиокнопок, или | [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 | объект радиодействия, к группе которого мы присоединяемся, или | [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 |
Возвращаемое значение
Значение текущего активного элемента группы
С: 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 | ||
current_value | новое значение |
С: 2.10
Типы и значения
struct GtkRadioAction
struct GtkRadioAction;
Подробности свойств
Свойство “current-value”
“current-value” gint
Значение свойства текущего активного элемента группы, к которой принадлежит это действие.
GtkRadioAction:current-value устарело с версии 3.10 и не должно использоваться в новом коде.
Флаги: Чтение / Запись
Значение по умолчанию: 0
С: 2.10
Свойство “group”
“group” GtkRadioAction *
Устанавливает новую группу для действия радиокнопки.
GtkRadioAction:group устарело с версии 3.10 и не должно использоваться в новом коде.
Флаги: Запись
С: 2.4
Свойство “value”
“value” gint
Значение — произвольное целое число, которое можно использовать в качестве удобного способа определения, какое действие в группе в настоящее время активно в обработчике сигнала ::activate или ::changed. См. gtk_radio_action_get_current_value() и GtkRadioActionEntry для удобных способов получения и установки этого свойства.
GtkRadioAction:value устарело с версии 3.10 и не должно использоваться в новом коде.
Флаги: Чтение / Запись
Значение по умолчанию: 0
С: 2.4
Подробности сигнала
Сигнал “changed”
void user_function (GtkRadioAction *action, GtkRadioAction *current, gpointer user_data)
Сигнал ::changed генерируется для каждого элемента группы радиокнопок при изменении активного элемента. Сигнал генерируется после сигналов ::activate для предыдущего и текущего активных элементов.
GtkRadioAction::changed устарел начиная с версии 3.10 и не должен использоваться в новом коде.
Параметры
action | действие, в котором генерируется сигнал | |
current | элемент группы | |
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.22/GtkRadioAction.html
