En esta página

SwitchDelegate QML Type

Elemento delegado con un indicador de conmutación que se puede activar o desactivar. Más...

Import Statement: import QtQuick.Controls
Inherits:

ItemDelegate

Propiedades

Descripción detallada

SwitchDelegate presenta un delegado de elemento que se puede activar (marcado) o desactivar (desmarcado). Los delegados Switch se utilizan normalmente para seleccionar una o varias opciones de entre un conjunto de opciones. Para conjuntos de opciones más pequeños, o para opciones que deban identificarse de forma única, se recomienda utilizar en su lugar Switch.

SwitchDelegate hereda su API de ` ItemDelegate`, que a su vez la hereda de ` AbstractButton`. Por ejemplo, puede establecer ` text` y reaccionar a ` clicks ` utilizando la API ` AbstractButton `. El estado del delegado de conmutador se puede establecer con la propiedad ` checked `.

ListView {
    model: ["Option 1", "Option 2", "Option 3"]
    delegate: SwitchDelegate {
        text: modelData
    }
}

Véase también Personalización deSwitchDelegate y controles de delegado.

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 se puede utilizar, por ejemplo, para determinar si el control deslizante se ha arrastrado más allá del punto medio. Para visualizar un indicador deslizante, se debe utilizar en su lugar la propiedad visualPosition, que tiene en cuenta la dirección de 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 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 el soporte de 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.