En esta página

TreeViewDelegate QML Type

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

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

ItemDelegate

Propiedades

Descripción detallada

Vista de árbol que muestra datos jerárquicos mediante un delegado de vista de árbol

Un TreeViewDelegate es un delegado que se puede asignar a la propiedad delegate property de un TreeView. Se encarga de mostrar el árbol, así como el resto de columnas, en la vista utilizando el estilo de la aplicación.

TreeView {
    anchors.fill: parent
    delegate: TreeViewDelegate {}
    // The model needs to be a QAbstractItemModel
    // model: yourTreeModel
}

TreeViewDelegate hereda de ` ItemDelegate`, lo que significa que se compone de tres elementos: un ` background`, un ` contentItem` y un ` indicator`. TreeViewDelegate se encarga de ` indenting ` el `contentItem` y el indicador según su ubicación en el árbol. El indicador solo será visible si el elemento delegado se encuentra dentro del ` tree column`, y representa un elemento del modelo ` with children`.

Si cambias el indicador, este ya no aparecerá sangrado de forma predeterminada. En su lugar, deberás sangrarlo tú mismo configurando el x position del indicador, teniendo en cuenta el depth y el indentation. A continuación se muestra un ejemplo de cómo hacerlo:

TreeViewDelegate {
    indicator: Item {
        x: leftMargin + (depth * indentation)
    }
}

La posición del «contentItem» se controla mediante « padding ». Esto significa que puedes modificar el «contentItem» sin tener que preocuparte por la sangría. Pero también implica que debes evitar cambiar el «padding» a otro valor, ya que eso eliminaría la sangría. El espacio a la izquierda del indicador se controla, en cambio, con ` leftMargin`. El espacio entre el indicador y el `contentItem` se controla con ` spacing`. Y el espacio a la derecha del `contentItem` se controla con ` rightMargin`.

Interacción con los punteros

`TreeViewDelegate` hereda de ` ItemDelegate`. Esto significa que emitirá señales como ` clicked ` cuando el usuario haga clic en el delegado. Si es necesario, puedes conectarte a esa señal para implementar funcionalidades específicas de la aplicación, además del comportamiento predeterminado de expandir/contraer (e incluso establecer ` pointerNavigationEnabled ` en ` false`, para desactivar también el comportamiento predeterminado).

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:

TreeView {
    id: treeView
    delegate: TreeViewDelegate {
        TapHandler {
            acceptedButtons: Qt.RightButton
            onTapped: someContextMenu.open()
        }

        TapHandler {
            acceptedModifiers: Qt.ControlModifier
            onTapped: {
                if (treeView.isExpanded(row))
                    treeView.collapseRecursively(row)
                else
                    treeView.expandRecursively(row)
            }
        }
    }
}

Nota: Si deseas desactivar el comportamiento predeterminado que se produce cuando el usuario hace clic en el delegado (como cambiar el índice actual), puedes establecer pointerNavigationEnabled en false.

Edición de nodos en el árbol

TreeViewDelegate tiene asignado un ` edit delegate ` predeterminado. Si ` TreeView ` tiene configurado ` edit triggers ` y el ` model ` admite ` editing model items`, el usuario puede activar cualquiera de los desencadenadores de edición para editar el texto del nodo del árbol ` current `.

El delegado de edición predeterminado intentará utilizar Qt.EditRole para leer y escribir datos en model. Si QAbstractItemModel::data() devuelve una cadena vacía para esta función, se utilizará Qt.DisplayRole en su lugar.

Siempre puedes asignar tu propio delegado de edición personalizado a TableView.editDelegate si tienes necesidades que van más allá de lo que ofrece el delegado de edición predeterminado.

Véase también TreeView.

Documentación de propiedades

current : bool

Esta propiedad se cumple si el delegado representa a current index en selection model.

depth : int

Esta propiedad contiene la profundidad del elemento del modelo dibujado por el delegado. La profundidad de un elemento del modelo es igual al número de antepasados que tiene en el modelo.

editing : bool [since 6.5]

Esta propiedad se cumple si el delegado está siendo edited.

Esta propiedad se introdujo en Qt 6.5.

expanded : bool

Esta propiedad es de tipo « true » si el elemento del modelo dibujado por el delegado está expandido en la vista.

hasChildren : bool

Esta propiedad es de tipo « true » si el elemento del modelo dibujado por el delegado tiene elementos secundarios en el modelo.

indentation : real

Esta propiedad indica el espacio que ocupa un elemento hijo en horizontal con respecto a su elemento padre.

isTreeNode : bool

Esta propiedad es « true » si el elemento delegado dibuja un nodo en el árbol. Solo se utilizará una columna de la vista para dibujar el árbol y, por lo tanto, solo los elementos delegados de esa columna tendrán esta propiedad establecida en « true ».

Un nodo del árbol es « indented » según su valor de « depth », y muestra un « indicator » si « hasChildren » es « true ». Los elementos delegados de otras columnas tendrán esta propiedad establecida en « false ».

leftMargin : real

Esta propiedad define el espacio entre el borde izquierdo de la vista y el borde izquierdo del indicador (además de la sangría). Si no hay ningún indicador visible, el espacio se situará entre el borde izquierdo de la vista y el borde izquierdo del «contentItem».

Véase también rightMargin, indentation y spacing.

rightMargin : real

Esta propiedad representa el espacio entre el borde derecho de la vista y el borde derecho del elemento de contenido.

Véase también leftMargin, indentation y spacing.

selected : bool

Esta propiedad se cumple si el delegado representa un objeto de tipo « selected index » en el « selection model ».

treeView : TreeView

Esta propiedad apunta a la propiedad « TreeView », 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.