TableViewDelegate QML Type
Un delegado que se puede asignar a un TableView. Más...
| Import Statement: | import QtQuick.Controls |
| Since: | Qt 6.9 |
| Inherits: | |
| Inherited By: |
Propiedades
Descripción detallada

Un TableViewDelegate es un delegado que se puede asignar a la propiedad delegate property de un TableView. Se encarga de representar cada celda de la tabla en la vista utilizando el estilo de la aplicación.
TableView {
anchors.fill: parent
delegate: TableViewDelegate {}
// model: yourModel
}TableViewDelegate hereda de ItemDelegate, lo que significa que se compone de dos elementos: un background y un contentItem.
La posición del contentItem se controla mediante padding.
Interacción con los punteros
TableViewDelegate hereda de ItemDelegate. Esto significa que emitirá señales como clicked cuando el usuario haga clic en el delegado. Puedes conectarte a esta señal para implementar funcionalidades específicas de la aplicación.
Sin embargo, la API de ` ItemDelegate ` no proporciona información sobre la posición del clic ni sobre qué teclas modificadoras se están manteniendo pulsadas. Si esto es necesario, un enfoque más adecuado sería utilizar controladores de puntero, por ejemplo:
TableView {
id: tableView
delegate: TableViewDelegate {
TapHandler {
acceptedButtons: Qt.RightButton
onTapped: someContextMenu.open()
}
TapHandler {
acceptedModifiers: Qt.ControlModifier
onTapped: tableView.doSomethingToCell(row, column)
}
}
}Nota: Si desea desactivar el comportamiento predeterminado que se produce cuando el usuario hace clic en el delegado (como cambiar el índice actual), puede establecer pointerNavigationEnabled en false.
Edición de celdas en la tabla
TableViewDelegate tiene asignado un edit delegate por defecto. Si TableView tiene edit triggers establecido, y el model admite editing model items, el usuario podrá activar cualquiera de los desencadenantes de edición para editar el texto de la celda de la tabla current.
El delegado de edición predeterminado utilizará el Qt.EditRole para leer y escribir datos en el model. Si necesitas utilizar otra función o tienes necesidades que van más allá de lo que ofrece el delegado de edición predeterminado, siempre puedes asignar tu propio delegado a TableView.editDelegate.
Véase también Personalización deTableViewDelegate y TableView.
Documentación de propiedades
current : bool
Esta propiedad se mantiene independientemente de si el delegado representa o no a la « current index » en el « selection model ».
editing : bool
Esta propiedad se mantiene independientemente de si el delegado está siendo « edited ».
selected : bool
Esta propiedad se cumple independientemente de que el delegado represente o no a un « selected index » en el « selection model ».
tableView : TableView
Esta propiedad apunta a la propiedad « TableView », que contiene el elemento delegado.
© 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.