TreeViewDelegate QML Type
Un delegado que se puede asignar a un TreeView. Más...
| Import Statement: | import QtQuick.Controls |
| Since: | Qt 6.3 |
| Inherits: |
Propiedades
- current : bool
- depth : int
- editing : bool
(since 6.5) - expanded : bool
- hasChildren : bool
- indentation : real
- isTreeNode : bool
- leftMargin : real
- rightMargin : real
- selected : bool
- treeView : TreeView
Descripción detallada

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.