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 ()

Свойства

gint	current-value	Чтение / Запись
GtkRadioAction *	group	Запись
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	Метка, отображаемая в пунктах меню и на кнопках, или `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 и не должна использоваться в новом коде.

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

Параметры

action

a 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 и не должна использоваться в новом коде.

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

Параметры

action	a GtkRadioAction
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`, который только что был активирован
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.20/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”`