CheckDelegate QML Type
Delegado de elemento con un indicador de selección que se puede activar o desactivar. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- checkState : enumeration
- nextCheckState : function
(since QtQuick.Controls 2.4 (Qt 5.11)) - tristate : bool
Descripción detallada
CheckDelegate presenta un delegado de elemento que se puede activar (marcado) o desactivar (sin marcar). Los delegados de tipo «check» se utilizan normalmente para seleccionar una o varias opciones de entre un conjunto de opciones de una lista. Para conjuntos de opciones más pequeños, o para opciones que deban ser identificables de forma única, se recomienda utilizar en su lugar CheckBox.
CheckDelegate 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 de AbstractButton. El estado del delegado de selección se puede establecer con la propiedad « checked ».
Además de los estados «marcado» y «desmarcado», existe un tercer estado: «parcialmente marcado». El estado «parcialmente marcado» se puede habilitar mediante la propiedad tristate. Este estado indica que no se puede determinar el estado habitual de «marcado» o «desmarcado», generalmente debido a otros estados que afectan al delegado de selección. Este estado resulta útil cuando se seleccionan varios nodos hijos en una vista de árbol, por ejemplo.
ListView {
model: ["Option 1", "Option 2", "Option 3"]
delegate: CheckDelegate {
text: modelData
}
}Véase también Personalización de CheckDelegate, controles delegados y CheckBox.
Documentación de la propiedad
checkState : enumeration
Esta propiedad determina el estado de comprobación del delegado de comprobación.
Estados disponibles:
| Constante | Descripción |
|---|---|
Qt.Unchecked | El delegado no está marcado. |
Qt.PartiallyChecked | El delegado está parcialmente marcado. Este estado solo se utiliza cuando está habilitada la opción « tristate ». |
Qt.Checked | El delegado está marcado. |
Véase también tristate y checked.
nextCheckState : function [since QtQuick.Controls 2.4 (Qt 5.11)]
Esta propiedad contiene una función de llamada de retorno que se invoca para determinar el siguiente estado de la casilla de verificación cada vez que el usuario cambia de forma interactiva el delegado de la casilla de verificación mediante el tacto, el ratón o el teclado.
De forma predeterminada, un delegado de casilla de verificación normal alterna entre los estados « Qt.Unchecked » y « Qt.Checked », mientras que un delegado de casilla de verificación de tres estados alterna entre los estados « Qt.Unchecked », « Qt.PartiallyChecked » y « Qt.Checked ».
La función de llamada de retorno « nextCheckState » puede anular el comportamiento predeterminado. El siguiente ejemplo implementa un delegado de comprobación de tres estados que puede presentar un estado «parcialmente comprobado» en función de condiciones externas, pero que nunca pasa al estado «parcialmente comprobado» cuando el usuario lo activa o desactiva de forma interactiva.
CheckDelegate {
tristate: true
checkState: allChildrenChecked ? Qt.Checked :
anyChildChecked ? Qt.PartiallyChecked : Qt.Unchecked
nextCheckState: function() {
if (checkState === Qt.Checked)
return Qt.Unchecked
else
return Qt.Checked
}
}Esta propiedad se introdujo en QtQuick.Controls 2.4 (Qt 5.11).
tristate : bool
Esta propiedad determina si el delegado de comprobación tiene tres estados.
En la animación siguiente, el primer checkdelegate tiene tres estados:
El valor predeterminado es « false », es decir, el delegado solo tiene dos estados.
© 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.