Switch QML Type
Botón de conmutación que se puede activar o desactivar. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- position : real
- visualPosition : real
Descripción detallada
El conmutador es un botón de opción que se puede arrastrar o activar (marcado) o desactivar (sin marcar). Los conmutadores se suelen utilizar para elegir entre dos estados. Para conjuntos de opciones más amplios, como los que aparecen en una lista, se recomienda utilizar en su lugar SwitchDelegate.
El control «Switch» hereda su API de « AbstractButton ». Por ejemplo, el estado del control «Switch» se puede establecer con la propiedad « checked ». Las señales « clicked » y « AbstractButton::toggled » se emiten cuando el usuario hace clic de forma interactiva en el control «Switch» mediante la pantalla táctil, el ratón o el teclado.
ColumnLayout {
Switch {
text: qsTr("Wi-Fi")
checked: Networking.wifiEnabled
onClicked: Networking.wifiEnabled = checked
}
Switch {
text: qsTr("Bluetooth")
checked: Networking.bluetoothEnabled
onClicked: Networking.bluetoothEnabled = checked
}
}Véase también Personalización de controles deinterruptores y botones.
Documentación de propiedades
position : real [read-only]
Esta propiedad indica la posición lógica del indicador de desplazamiento.
La posición se expresa como una fracción del tamaño del indicador, en el rango 0.0 - 1.0. La posición puede utilizarse, por ejemplo, para determinar si el cursor se ha arrastrado más allá del punto medio. Para visualizar un indicador de cursor, se debe utilizar en su lugar el indicador visualPosition, que admite la lectura de derecha a izquierda.
Véase también visualPosition.
visualPosition : real [read-only]
Esta propiedad define la posición visual del indicador de desplazamiento.
La posición se expresa como una fracción del tamaño del indicador, en el intervalo 0.0 - 1.0. Cuando el control está en modo « mirrored », el valor es igual a 1.0 - position. Esto hace que el valor sea adecuado para visualizar el indicador de desplazamiento teniendo en cuenta la compatibilidad con la lectura de derecha a izquierda. Para determinar, por ejemplo, si el control deslizante se ha arrastrado más allá del punto medio, se debe utilizar en su lugar el valor lógico position.
Véase también position.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.