QML-тип TextSwitch

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

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

Список всех членов класса, включая унаследованные

Свойства

automaticCheck : bool
busy : bool
checked : bool
description : string
down : bool
highlighted : bool
leftMargin : real
rightMargin : real
text : string

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

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

Ниже приведён пример кода TextSwitch:

import QtQuick 2.2
import Sailfish.Silica 1.0

TextSwitch {
    id: activationSwitch
    text: "Активировать"
    description: "Активирует устройство Судного дня"
    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

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