GtkSwitch

CSS-узлы

switch
├── label
├── label
╰── slider

GtkSwitch имеет четыре CSS-узла: основной узел с именем switch и подузлы для ползунка и меток включено и выключено. Ни один из них не использует никаких стилистических классов.

Удобство доступа

GtkSwitch использует роль GTK_ACCESSIBLE_ROLE_SWITCH.

gtk_switch_new ()

GtkWidget *
gtk_switch_new (void);

Создаёт новый виджет GtkSwitch.

gtk_switch_set_active ()

void
gtk_switch_set_active (GtkSwitch *self,
                       gboolean is_active);

Изменяет состояние self на желаемое.

gtk_switch_get_active ()

gboolean
gtk_switch_get_active (GtkSwitch *self);

Получает, находится ли GtkSwitch в состоянии «включено» или «выключено».

gtk_switch_set_state ()

void
gtk_switch_set_state (GtkSwitch *self,
                      gboolean state);

Устанавливает базовое состояние GtkSwitch.

Обычно это то же самое, что и “active”, за исключением случаев, когда для переключателя настроены задержки изменения состояния. Эта функция обычно вызывается из обработчика сигнала “state-set”.

См. “state-set” для получения подробной информации.

gtk_switch_get_state ()

gboolean
gtk_switch_get_state (GtkSwitch *self);

Получает базовое состояние GtkSwitch.

GtkSwitch

typedef struct _GtkSwitch GtkSwitch;

Структура GtkSwitch содержит приватные данные, и к ней следует обращаться только с помощью предоставленного API.

Свойство “active”

  “active”                   gboolean

Указывает, находится ли виджет GtkSwitch в состоянии «включено» или «выключено».

Владелец: GtkSwitch

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

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

Свойство “state”

  “state”                    gboolean

Состояние базового элемента, контролируемого переключателем. См. “state-set” для получения подробной информации.

Владелец: GtkSwitch

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

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

Сигнал “activate”

void
user_function (GtkSwitch *widget,
               gpointer   user_data)

Сигнал ::activate в GtkSwitch является сигналом действия, и его отправка приводит к анимации переключателя. Приложениям не следует подключаться к этому сигналу, но следует использовать сигнал notify::active.

Флаги: Действие

Сигнал “state-set”

gboolean
user_function (GtkSwitch *widget,
               gboolean   state,
               gpointer   user_data)

Сигнал ::state-set в GtkSwitch отправляется для изменения базового состояния. Он отправляется, когда пользователь меняет положение переключателя. Обработчик по умолчанию поддерживает синхронизацию состояния с свойством “active”.

Для реализации отложенного изменения состояния приложения могут подключиться к этому сигналу, инициировать изменение базового состояния и вызвать gtk_switch_set_state(), когда изменение базового состояния будет завершено. Обработчик сигнала должен вернуть TRUE для предотвращения запуска обработчика по умолчанию.

Визуально базовое состояние представлено цветом канавки переключателя, в то время как свойство “active” представлено положением переключателя.

Флаги: Выполнять последним