DelegateChooser QML Type
Permite que una vista utilice diferentes delegados para distintos tipos de elementos del modelo. Más...
| Import Statement: | import QtQml.Models |
| Since: | Qt 6.9 |
Propiedades
Descripción detallada
DelegateChooser es un tipo especial de « Component » destinado a aquellos casos en los que una vista requiere un «Component» y lo utiliza como delegado. DelegateChooser encapsula un conjunto de objetos ` DelegateChoice`. Estas opciones se utilizan para determinar el delegado que se instanciará para cada elemento del modelo. La selección de la opción se realiza en función del valor que tiene un elemento del modelo para ` role`, así como en función del índice.
DelegateChooser se utiliza habitualmente cuando una vista necesita mostrar un conjunto de delegados que difieren significativamente entre sí. Por ejemplo, una vista típica de ajustes de un teléfono podría incluir interruptores, controles deslizantes, botones de opción y otras visualizaciones en función del tipo de cada ajuste. En este caso, DelegateChooser podría proporcionar una forma sencilla de asociar un tipo diferente de delegado a cada ajuste:
import QtQml.Models
import QtQuick
import QtQuick.Controls
ListView {
width: 200; height: 400
ListModel {
id: listModel
ListElement { type: "info"; ... }
ListElement { type: "switch"; ... }
ListElement { type: "swipe"; ... }
ListElement { type: "switch"; ... }
}
DelegateChooser {
id: chooser
role: "type"
DelegateChoice { roleValue: "info"; ItemDelegate { ... } }
DelegateChoice { roleValue: "switch"; SwitchDelegate { ... } }
DelegateChoice { roleValue: "swipe"; SwipeDelegate { ... } }
}
model: listModel
delegate: chooser
}Nota: Este tipo está diseñado para funcionar de forma transparente únicamente con TableView y cualquier vista basada en DelegateModel. Las vistas (incluidas las definidas por el usuario) que no se basen internamente en un DelegateModel deben ser compatibles explícitamente con este tipo de componente para que funcione tal y como se describe.
Véase también DelegateChoice.
Documentación de propiedades
choices : list<DelegateChoice> [default]
La lista de opciones de delegado (DelegateChoices) para el selector.
La lista se trata como una lista ordenada, en la que el primer DelegateChoice que coincida será el utilizado por la vista.
Por lo general, no debería ser necesario hacer referencia a la propiedad « choices », ya que es la propiedad predeterminada de « DelegateChooser » y, por lo tanto, todos los elementos secundarios se asignan automáticamente a esta propiedad.
role : string
Esta propiedad contiene el rol o el nombre de la propiedad que se utiliza para determinar el delegado de un elemento del modelo determinado.
Nota: En el caso de los modelos basados en « QAbstractItemModel », incluido « ListModel », el « DelegateChooser » volverá a evaluar la elección cuando el modelo indique que el rol ha cambiado. Para cualquier otro tipo de modelo, esta elección solo se realizará una vez, al crearse el elemento correspondiente a un índice de modelo determinado.
Véase también DelegateChoice.
© 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.