API Documentation
Documentation for developing SailfishOS applicationsTextSwitch QML Type
A toggle button with a label More...
| Import Statement: | import Sailfish.Silica 1.0 |
| Inherited By: |
Properties
- automaticCheck : bool
- busy : bool
- checked : bool
- description : string
- down : bool
- highlighted : bool
- leftMargin : real
- rightMargin : real
- text : string
Detailed Description
The TextSwitch type provides a Sailfish-styled toggle button with a textual label.
Here is a simple 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 inherits the MouseArea type, so any properties, signals and methods of MouseArea are also available to TextSwitch objects. See the MouseArea documentation for its full list of available properties, signals and methods.
Property Documentation
If true, the TextSwitch is automatically toggled between the checked and unchecked states when clicked. The default value is true.
If automaticCheck is false, the user must handle the clicked() signal and set the value of checked appropriately. This is primarily useful when the switch is connected to an external state that cannot be simply bound to the checked properly.
See also checked.
This property holds whether the TextSwitch is in a busy state. When busy the indicator will flash and the TextSwitch will be disabled. The busy state is useful when applying a change to a setting does not happen instantaneously.
This property holds whether the TextSwitch is checked. If automaticCheck is true, clicking on the switch toggles checked between true and false.
See also automaticCheck.
This property is true while the button is pressed and the touch position remains within the button area.
This property determines whether the switch is shown highlighted. By default it is bound to down.
The margins between the left and right edges of the switch and its contents. The default value is Theme.horizontalPageMargin.
The margins between the left and right edges of the switch and its contents. The default value is Theme.horizontalPageMargin.