En esta página

SwitchDelegate QML Type

Delegado de elemento con un indicador de interruptor que puede activarse o desactivarse. Más...

Import Statement: import QtQuick.Controls
Inherits:

ItemDelegate

Propiedades

Descripción detallada

SwitchDelegate presenta un elemento delegado que puede activarse (marcado) o desactivarse (desmarcado). Los delegados de conmutación se utilizan normalmente para seleccionar una o más opciones de un conjunto de opciones. Para conjuntos de opciones más pequeños, o para opciones que necesitan ser identificables de forma única, considere el uso de Switch en su lugar.

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

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

Véase también Personalización de SwitchDelegate y Controles delegados.

Documentación de propiedades

position : real [read-only]

Esta propiedad contiene la posición lógica del indicador de pulgar.

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 pulgar ha sido arrastrado más allá de la mitad del recorrido. Para visualizar un indicador de pulgar, debe utilizarse en su lugar el consciente de derecha a izquierda visualPosition.

Véase también visualPosition.

visualPosition : real [read-only]

Esta propiedad contiene la posición visual del indicador del pulgar.

La posición se expresa como una fracción del tamaño del indicador, en el rango 0.0 - 1.0. Cuando el control es mirrored, el valor es igual a 1.0 - position. Esto hace que el valor sea adecuado para visualizar el indicador del pulgar teniendo en cuenta el soporte de derecha a izquierda. Para determinar, por ejemplo, si el pulgar ha sido arrastrado más allá de la mitad del recorrido, debería utilizarse 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.