En esta página

TableViewDelegate QML Type

Un delegado que se puede asignar a un TableView. Más...

Import Statement: import QtQuick.Controls
Since: Qt 6.9
Inherits:

ItemDelegate

Inherited By:

HorizontalHeaderViewDelegate and VerticalHeaderViewDelegate

Propiedades

Descripción detallada

Vista de tabla que muestra direcciones mediante un delegado de vista de tabla

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.