QML-тип TextSwitch

Кнопка-переключатель с текстовой меткой. Подробнее...

Строка импорта: import Sailfish.Silica 1.0
Наследуется от: MouseArea
Наследники: IconTextSwitch

Свойства

Подробное описание

Тип TextSwitch реализует оформленную в стиле ОС Аврора кнопку-переключатель с текстовой меткой.

Ниже приведен пример кода, который реализует кнопку-переключатель с текстовой меткой:

 import QtQuick 2.2
 import Sailfish.Silica 1.0

 TextSwitch {
     id: activationSwitch
     text: "Active"
     description: "Activates the Doomsday device"
     onCheckedChanged: {
         device.setStatus(checked ? DeviceState.Armed : DeviceState.Disarmed)
     }
 }

TextSwitch наследуется от типа MouseArea. Поэтому свойства, методы и сигналы MouseArea также доступны для объектов TextSwitch. Полный список доступных свойств, сигналов и методов приведен в документации MouseArea.

См. также Switch и Label.

Описание свойств

automaticCheck : bool

При истинном значении элемент TextSwitch автоматически переключается между состояниями "нажат"/"отжат" при касании. Значение по умолчанию: true.

Если значением свойства automaticCheck является false, то пользователь должен самостоятельно реализовать обработку сигнала clicked() и соответственным образом установить значение свойства checked. Обычно такое поведение используется в ситуациях, когда переключатель связан с неким внешним состоянием, которое нельзя непосредственно привязать к свойству checked.

См. также checked.

busy : bool

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

checked : bool

Определяет, находится ли элемент TextSwitch в состоянии "включено". Если значением свойства automaticCheck является true, то касание переключателя меняет значение свойства checked между true и false.

См. также automaticCheck.

description : string

Необязательный текст для описания назначения переключателя.

down : bool

Истинно, пока кнопка нажата, и положение касания остается в области этой кнопки.

highlighted : bool

Определяет, будет ли переключатель отображаться подсвеченным. По умолчанию привязано к значению свойства down.

leftMargin : real

Отступ между левым и правым краями переключателя и его содержимым. Значение по умолчанию: Theme.horizontalPageMargin.

rightMargin : real

Отступ между левым и правым краями переключателя и его содержимым. Значение по умолчанию: Theme.horizontalPageMargin.

text : string

Текст, отображаемый рядом с индикатором состояния переключателя.