QTreeView Class
La clase QTreeView ofrece una implementación predeterminada del modelo-vista de una vista en árbol. Más información...
| Encabezado: | #include <QTreeView> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QAbstractItemView |
| Heredado por: |
Propiedades
|
|
Funciones públicas
| QTreeView(QWidget *parent = nullptr) | |
| virtual | ~QTreeView() |
| bool | allColumnsShowFocus() const |
| int | autoExpandDelay() const |
| int | columnAt(int x) const |
| int | columnViewportPosition(int column) const |
| int | columnWidth(int column) const |
| bool | expandsOnDoubleClick() const |
| QHeaderView * | header() const |
| int | indentation() const |
| QModelIndex | indexAbove(const QModelIndex &index) const |
| QModelIndex | indexBelow(const QModelIndex &index) const |
| bool | isAnimated() const |
| bool | isColumnHidden(int column) const |
| bool | isExpanded(const QModelIndex &index) const |
| bool | isFirstColumnSpanned(int row, const QModelIndex &parent) const |
| bool | isHeaderHidden() const |
| bool | isRowHidden(int row, const QModelIndex &parent) const |
| bool | isSortingEnabled() const |
(since 6.12) QRect | itemDecorationRect(const QModelIndex &index) const |
| bool | itemsExpandable() const |
| void | resetIndentation() |
| bool | rootIsDecorated() const |
| void | setAllColumnsShowFocus(bool enable) |
| void | setAnimated(bool enable) |
| void | setAutoExpandDelay(int delay) |
| void | setColumnHidden(int column, bool hide) |
| void | setColumnWidth(int column, int width) |
| void | setExpanded(const QModelIndex &index, bool expanded) |
| void | setExpandsOnDoubleClick(bool enable) |
| void | setFirstColumnSpanned(int row, const QModelIndex &parent, bool span) |
| void | setHeader(QHeaderView *header) |
| void | setHeaderHidden(bool hide) |
| void | setIndentation(int i) |
| void | setItemsExpandable(bool enable) |
| void | setRootIsDecorated(bool show) |
| void | setRowHidden(int row, const QModelIndex &parent, bool hide) |
| void | setSortingEnabled(bool enable) |
| void | setTreePosition(int index) |
| void | setUniformRowHeights(bool uniform) |
| void | setWordWrap(bool on) |
| int | treePosition() const |
| bool | uniformRowHeights() const |
| bool | wordWrap() const |
Funciones públicas reimplementadas
| virtual void | dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>()) override |
| virtual QModelIndex | indexAt(const QPoint &point) const override |
| virtual void | keyboardSearch(const QString &search) override |
| virtual void | reset() override |
| virtual void | scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible) override |
| virtual void | selectAll() override |
| virtual void | setModel(QAbstractItemModel *model) override |
| virtual void | setRootIndex(const QModelIndex &index) override |
| virtual void | setSelectionModel(QItemSelectionModel *selectionModel) override |
| virtual QRect | visualRect(const QModelIndex &index) const override |
Ranuras públicas
| void | collapse(const QModelIndex &index) |
| void | collapseAll() |
| void | expand(const QModelIndex &index) |
| void | expandAll() |
| void | expandRecursively(const QModelIndex &index, int depth = -1) |
| void | expandToDepth(int depth) |
| void | hideColumn(int column) |
| void | resizeColumnToContents(int column) |
| void | showColumn(int column) |
| void | sortByColumn(int column, Qt::SortOrder order) |
Señales
Funciones protegidas
| virtual void | drawBranches(QPainter *painter, const QRect &rect, const QModelIndex &index) const |
| virtual void | drawRow(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const |
| void | drawTree(QPainter *painter, const QRegion ®ion) const |
| int | indexRowSizeHint(const QModelIndex &index) const |
| int | rowHeight(const QModelIndex &index) const |
Funciones protegidas reimplementadas
| virtual void | changeEvent(QEvent *event) override |
| virtual void | currentChanged(const QModelIndex ¤t, const QModelIndex &previous) override |
| virtual void | dragMoveEvent(QDragMoveEvent *event) override |
| virtual int | horizontalOffset() const override |
| virtual bool | isIndexHidden(const QModelIndex &index) const override |
| virtual void | keyPressEvent(QKeyEvent *event) override |
| virtual void | mouseDoubleClickEvent(QMouseEvent *event) override |
| virtual void | mouseMoveEvent(QMouseEvent *event) override |
| virtual void | mousePressEvent(QMouseEvent *event) override |
| virtual void | mouseReleaseEvent(QMouseEvent *event) override |
| virtual QModelIndex | moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override |
| virtual void | paintEvent(QPaintEvent *event) override |
| virtual void | rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end) override |
| virtual void | rowsInserted(const QModelIndex &parent, int start, int end) override |
| virtual void | scrollContentsBy(int dx, int dy) override |
| virtual QModelIndexList | selectedIndexes() const override |
| virtual void | selectionChanged(const QItemSelection &selected, const QItemSelection &deselected) override |
| virtual void | setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command) override |
| virtual int | sizeHintForColumn(int column) const override |
| virtual void | timerEvent(QTimerEvent *event) override |
| virtual void | updateGeometries() override |
| virtual int | verticalOffset() const override |
| virtual bool | viewportEvent(QEvent *event) override |
| virtual QSize | viewportSizeHint() const override |
| virtual QRegion | visualRegionForSelection(const QItemSelection &selection) const override |
Ranuras protegidas
| void | columnCountChanged(int oldCount, int newCount) |
| void | columnMoved() |
| void | columnResized(int column, int oldSize, int newSize) |
| void | rowsRemoved(const QModelIndex &parent, int start, int end) |
Descripción detallada

Una clase `QTreeView` implementa una representación en forma de árbol de los elementos de un modelo. Esta clase se utiliza para proporcionar listas jerárquicas estándar que antes ofrecía la clase ` QListView `, pero utilizando el enfoque más flexible que ofrece la arquitectura modelo/vista de Qt.
La clase QTreeView es una de las clases de modelo/vista y forma parte del marco de trabajo de modelo/vista de Qt.
QTreeView implementa las interfaces definidas por la clase ` QAbstractItemView ` para permitirle mostrar datos proporcionados por modelos derivados de la clase ` QAbstractItemModel `.
Es sencillo crear una vista de árbol que muestre datos de un modelo. En el siguiente ejemplo, el contenido de un directorio lo proporciona un ` QFileSystemModel ` y se muestra en forma de árbol:
QFileSystemModel *model = new QFileSystemModel;
model->setRootPath(QDir::currentPath());
QTreeView *tree = new QTreeView(splitter);
tree->setModel(model);La arquitectura modelo/vista garantiza que el contenido de la vista en árbol se actualice a medida que cambia el modelo.
Los elementos que tienen subelementos pueden estar en estado expandido (los subelementos son visibles) o contraído (los subelementos están ocultos). Cuando este estado cambia, se emite una señal collapsed() o expanded() con el índice del modelo del elemento en cuestión.
El nivel de sangría utilizado para indicar los niveles jerárquicos se controla mediante la propiedad indentation.
Los encabezados de las vistas de árbol se construyen utilizando la clase QHeaderView y pueden ocultarse mediante header()->hide(). Ten en cuenta que cada encabezado se configura con su propiedad stretchLastSection establecida en true, lo que garantiza que la vista no desperdicie nada del espacio que se le ha asignado para su encabezado. Si este valor se establece en true, esta propiedad anulará el modo de redimensionamiento establecido en la última sección del encabezado.
Por defecto, todas las columnas de una vista de árbol son desplazables, excepto la primera. Para desactivar el desplazamiento de estas columnas, utilice la función ` setSectionsMovable()` de ` QHeaderView`. Para obtener más información sobre cómo reorganizar secciones, consulte ` Moving Header Sections`.
Atajos de teclado
QTreeView admite un conjunto de atajos de teclado que permiten al usuario navegar por la vista e interactuar con el contenido de los elementos:
| Tecla | Acción |
|---|---|
| Arriba | Mueve el cursor al elemento de la misma columna en la fila anterior. Si el elemento padre del elemento actual ya no tiene más filas a las que navegar, el cursor se desplaza al elemento correspondiente en la última fila del elemento hermano que precede al padre. |
| Abajo | Mueve el cursor al elemento de la misma columna en la fila siguiente. Si el elemento padre del elemento actual ya no tiene más filas a las que navegar, el cursor se desplaza al elemento correspondiente de la primera fila del elemento hermano que sigue al padre. |
| Izquierda | Oculta los elementos secundarios del elemento actual (si los hay) colapsando una rama. |
| Menos | Igual que «Izquierda». |
| Derecha | Muestra los elementos secundarios del elemento actual (si los hay) expandiendo una rama. |
| Más | Igual que «Derecha». |
| Asterisco | Expande el elemento actual y todos sus elementos secundarios (si los hay). |
| Re Pág | Mueve el cursor una página hacia arriba. |
| Avanzar página | Mueve el cursor una página hacia abajo. |
| Inicio | Mueve el cursor a un elemento de la misma columna de la primera fila del primer elemento de nivel superior del modelo. |
| Fin | Mueve el cursor a un elemento de la misma columna de la última fila del último elemento de nivel superior del modelo. |
| F2 | En los modelos editables, abre el elemento actual para su edición. La tecla Escape se puede utilizar para cancelar el proceso de edición y revertir cualquier cambio en los datos mostrados. |
Mejora del rendimiento
Es posible proporcionar a la vista información sobre los datos que está gestionando con el fin de mejorar su rendimiento al mostrar un gran número de elementos. Un enfoque que se puede adoptar para las vistas destinadas a mostrar elementos con la misma altura es establecer la propiedad « uniformRowHeights » en «true».
Véase también QListView, QTreeWidget, Clases de vista, QAbstractItemModel y QAbstractItemView.
Documentación de la propiedad
allColumnsShowFocus : bool
Esta propiedad determina si los elementos deben mostrar el foco del teclado en todas las columnas
Si esta propiedad es « true », todas las columnas mostrarán el foco; de lo contrario, solo una columna lo mostrará.
El valor por defecto es «false».
Funciones de acceso:
| bool | allColumnsShowFocus() const |
| void | setAllColumnsShowFocus(bool enable) |
animated : bool
Esta propiedad determina si las animaciones están activadas
Si esta propiedad tiene el valor « true », la vista de árbol animará la expansión y el colapso de las ramas. Si esta propiedad tiene el valor « false », la vista de árbol expandirá o colapsará las ramas inmediatamente sin mostrar la animación.
Por defecto, esta propiedad está false.
Funciones de acceso:
| bool | isAnimated() const |
| void | setAnimated(bool enable) |
autoExpandDelay : int
Esta propiedad define el tiempo de retardo antes de que se abran los elementos de un árbol durante una operación de arrastrar y soltar.
Esta propiedad indica el tiempo, en milisegundos, que el usuario debe esperar sobre un nodo antes de que este se abra automáticamente. Si el tiempo se establece en un valor inferior a 0, la función no se activará.
Por defecto, esta propiedad tiene un valor de -1, lo que significa que la expansión automática está desactivada.
Funciones de acceso:
| int | autoExpandDelay() const |
| void | setAutoExpandDelay(int delay) |
expandsOnDoubleClick : bool
Esta propiedad indica si los elementos se pueden desplegar haciendo doble clic.
Esta propiedad indica si el usuario puede expandir y contraer elementos haciendo doble clic. El valor por defecto es «true».
Funciones de Access:
| bool | expandsOnDoubleClick() const |
| void | setExpandsOnDoubleClick(bool enable) |
Véase también itemsExpandable.
headerHidden : bool
Esta propiedad determina si se muestra o no el encabezado.
Si esta propiedad es « true », el encabezado no se muestra; en caso contrario, sí se muestra. El valor por defecto es «false».
Funciones de acceso:
| bool | isHeaderHidden() const |
| void | setHeaderHidden(bool hide) |
Véase también ` header()`.
indentation : int
sangría de los elementos en la vista de árbol.
Esta propiedad contiene la sangría, medida en píxeles, de los elementos para cada nivel de la vista de árbol. Para los elementos de nivel superior, la sangría especifica la distancia horizontal desde el borde de la ventana de visualización hasta los elementos de la primera columna; para los elementos hijos, especifica su sangría respecto a sus elementos padres.
Por defecto, el valor de esta propiedad depende del estilo. Por lo tanto, cuando el estilo cambia, esta propiedad se actualiza en función de él. Al llamar a setIndentation() se detienen las actualizaciones, mientras que al llamar a resetIndentation() se restablece el comportamiento por defecto.
Funciones de acceso:
| int | indentation() const |
| void | setIndentation(int i) |
| void | resetIndentation() |
itemsExpandable : bool
Esta propiedad indica si el usuario puede desplegar los elementos.
Esta propiedad indica si el usuario puede expandir y contraer elementos de forma interactiva.
Por defecto, esta propiedad tiene el valor « true ».
Funciones de acceso:
| bool | itemsExpandable() const |
| void | setItemsExpandable(bool enable) |
rootIsDecorated : bool
Esta propiedad determina si se muestran los controles para expandir y contraer los elementos de nivel superior
Los elementos con elementos secundarios suelen mostrarse con controles para expandirlos y contraerlos, lo que permite mostrar u ocultar sus elementos secundarios. Si esta propiedad es «false», estos controles no se muestran en los elementos de nivel superior. Esto puede utilizarse para que una estructura de árbol de un solo nivel parezca una simple lista de elementos.
De forma predeterminada, esta propiedad tiene el valor « true ».
Funciones de acceso:
| bool | rootIsDecorated() const |
| void | setRootIsDecorated(bool show) |
sortingEnabled : bool
Esta propiedad indica si la ordenación está activada
Si esta propiedad es « true », la ordenación está habilitada para el árbol; si la propiedad es «false», la ordenación no está habilitada. El valor por defecto es «false».
Nota: Para evitar problemas de rendimiento, se recomienda habilitar la ordenación después de insertar los elementos en el árbol. Como alternativa, también se pueden insertar los elementos en una lista antes de insertarlos en el árbol.
Funciones de acceso:
| bool | isSortingEnabled() const |
| void | setSortingEnabled(bool enable) |
Véase también sortByColumn().
uniformRowHeights : bool
Esta propiedad indica si todos los elementos de la vista de árbol tienen la misma altura
Esta propiedad solo debe establecerse en «true» si se garantiza que todos los elementos de la vista tienen la misma altura. Esto permite que la vista realice algunas optimizaciones.
La altura se obtiene del primer elemento de la vista. Se actualiza cuando cambian los datos de dicho elemento.
Nota: Si la indicación de tamaño del editor es mayor que la indicación de tamaño de la celda, se utilizará la indicación de tamaño del editor.
Por defecto, esta propiedad tiene el valor « false ».
Funciones de acceso:
| bool | uniformRowHeights() const |
| void | setUniformRowHeights(bool uniform) |
wordWrap : bool
Esta propiedad define la política de ajuste de texto del elemento
Si esta propiedad tiene el valor « true », el texto del elemento se ajustará en los saltos de palabra cuando sea necesario; en caso contrario, no se ajustará en absoluto. Por defecto, esta propiedad tiene el valor « false ».
Ten en cuenta que, aunque el ajuste de línea esté activado, la celda no se ampliará para que quepa todo el texto. Se insertarán puntos suspensivos según la configuración actual de « textElideMode ».
Funciones de Access:
| bool | wordWrap() const |
| void | setWordWrap(bool on) |
Documentación de las funciones de miembro
[explicit] QTreeView::QTreeView(QWidget *parent = nullptr)
Crea una vista de árbol con un objeto ` parent ` para representar los datos de un modelo. Utiliza ` setModel()` para establecer el modelo.
Véase también QAbstractItemModel.
[virtual noexcept] QTreeView::~QTreeView()
Elimina la vista en árbol.
[override virtual protected] void QTreeView::changeEvent(QEvent *event)
Reimplementa: QFrame::changeEvent(QEvent *ev).
[slot] void QTreeView::collapse(const QModelIndex &index)
Plegará el elemento del modelo especificado por el index.
Véase también ` collapsed()`.
[slot] void QTreeView::collapseAll()
Oculta todos los elementos desplegados.
Véase también expandAll(), expand(), collapse() y setExpanded().
[signal] void QTreeView::collapsed(const QModelIndex &index)
Esta señal se emite cuando se oculta el elemento especificado por « index ».
int QTreeView::columnAt(int x) const
Devuelve la columna de la vista de árbol cuyo encabezado abarca la coordenada x indicada.
[protected slot] void QTreeView::columnCountChanged(int oldCount, int newCount)
Indica a la vista de árbol que el número de columnas de la misma ha cambiado de oldCount a newCount.
[protected slot] void QTreeView::columnMoved()
Esta función se ejecuta cada vez que se mueve una columna.
[protected slot] void QTreeView::columnResized(int column, int oldSize, int newSize)
Esta función se invoca cada vez que se modifica el tamaño de column en el encabezado. oldSize y newSize proporcionan el tamaño anterior y el nuevo tamaño en píxeles.
Véase también setColumnWidth().
int QTreeView::columnViewportPosition(int column) const
Devuelve la posición horizontal del objeto « column » en la ventana gráfica.
int QTreeView::columnWidth(int column) const
Devuelve el ancho de column.
Véase también resizeColumnToContents() y setColumnWidth().
[override virtual protected] void QTreeView::currentChanged(const QModelIndex ¤t, const QModelIndex &previous)
Reimplementa: QAbstractItemView::currentChanged(const QModelIndex ¤t, const QModelIndex &previous).
[override virtual] void QTreeView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>())
Reimplementa: QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles).
[override virtual protected] void QTreeView::dragMoveEvent(QDragMoveEvent *event)
Reimplementa: ` QAbstractItemView::dragMoveEvent(QDragMoveEvent *event)`.
[virtual protected] void QTreeView::drawBranches(QPainter *painter, const QRect &rect, const QModelIndex &index) const
Dibuja las ramas en la vista de árbol en la misma fila que el elemento del modelo index, utilizando la painter proporcionada. Las ramas se dibujan en el rectángulo especificado por rect.
[virtual protected] void QTreeView::drawRow(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
Dibuja la fila de la vista de árbol que contiene el elemento del modelo index, utilizando el painter proporcionado. El option controla cómo se muestra el elemento.
Véase también setAlternatingRowColors().
[protected] void QTreeView::drawTree(QPainter *painter, const QRegion ®ion) const
Dibuja la parte del árbol que se cruza con el « region » dado utilizando el « painter » especificado.
Véase también paintEvent().
[slot] void QTreeView::expand(const QModelIndex &index)
Expande el elemento del modelo especificado por index.
Véase también expanded().
[slot] void QTreeView::expandAll()
Expande todos los elementos que se pueden expandir.
Nota: Esta función no intentará fetch more ar datos.
Advertencia: Si el modelo contiene un gran número de elementos, esta función tardará algún tiempo en ejecutarse.
Véanse también collapseAll(), expand(), collapse() y setExpanded().
[slot] void QTreeView::expandRecursively(const QModelIndex &index, int depth = -1)
Expande el elemento situado en la posición index y todos sus elementos secundarios hasta la posición depth. La posición depth es relativa a la posición index. Un valor de depth de -1 expandirá todos los elementos secundarios, mientras que un valor de depth de 0 solo expandirá el elemento index.
Nota: Esta función no intentará fetch more los datos.
Advertencia: Si el modelo contiene un gran número de elementos, esta función tardará algún tiempo en ejecutarse.
Véase también expandAll().
[slot] void QTreeView::expandToDepth(int depth)
Expande todos los elementos expandibles hasta el depth indicado.
Nota: Esta función no intentará fetch more ar datos.
Véase también expandAll(), collapseAll(), expand(), collapse() y setExpanded().
[signal] void QTreeView::expanded(const QModelIndex &index)
Esta señal se emite cuando se despliega el elemento especificado por « index ».
Véase también setExpanded().
QHeaderView *QTreeView::header() const
Devuelve el encabezado de la vista de árbol.
Véase también setHeader() y QAbstractItemModel::headerData().
[slot] void QTreeView::hideColumn(int column)
Oculta el column indicado.
Nota: Esta función solo debe llamarse después de que el modelo se haya inicializado, ya que la vista necesita conocer el número de columnas para poder ocultar column.
Véase también ` showColumn()` y ` setColumnHidden()`.
[override virtual protected] int QTreeView::horizontalOffset() const
Reimplementa: QAbstractItemView::horizontalOffset() const.
Devuelve el desplazamiento horizontal de los elementos en la vista de árbol.
Ten en cuenta que la vista de árbol utiliza las posiciones horizontales de la sección de encabezado para determinar las posiciones de las columnas en la vista.
Véase también verticalOffset().
QModelIndex QTreeView::indexAbove(const QModelIndex &index) const
Devuelve el índice del modelo del elemento situado encima de « index ».
[override virtual] QModelIndex QTreeView::indexAt(const QPoint &point) const
Reimplementa: ` QAbstractItemView::indexAt(const QPoint &point) const`.
QModelIndex QTreeView::indexBelow(const QModelIndex &index) const
Devuelve el índice del modelo del elemento que se encuentra en index.
[protected] int QTreeView::indexRowSizeHint(const QModelIndex &index) const
Devuelve la sugerencia de tamaño para la fila indicada por index.
Véase también sizeHintForColumn() y uniformRowHeights().
bool QTreeView::isColumnHidden(int column) const
Devuelve « true » si el elemento « column » está oculto; en caso contrario, devuelve « false ».
Véase también hideColumn() y isRowHidden().
bool QTreeView::isExpanded(const QModelIndex &index) const
Devuelve « true » si el elemento del modelo « index » está expandido; en caso contrario, devuelve «false».
Véase también expand(), expanded() y setExpanded().
bool QTreeView::isFirstColumnSpanned(int row, const QModelIndex &parent) const
Devuelve « true » si el elemento de la primera columna de la tabla « row » de la tabla « parent » abarca todas las columnas; en caso contrario, devuelve « false ».
Véase también setFirstColumnSpanned().
[override virtual protected] bool QTreeView::isIndexHidden(const QModelIndex &index) const
Reimplementa: ` QAbstractItemView::isIndexHidden(const QModelIndex &index) const`.
bool QTreeView::isRowHidden(int row, const QModelIndex &parent) const
Devuelve « true » si el elemento del « row » especificado del « parent » está oculto; en caso contrario, devuelve « false ».
Véase también setRowHidden() y isColumnHidden().
[since 6.12] QRect QTreeView::itemDecorationRect(const QModelIndex &index) const
Devuelve el rectángulo ocupado por el indicador de expansión/contracción del elemento en index. Si el elemento no tiene dicho indicador, por ejemplo, porque no tiene elementos secundarios o porque la decoración raíz está desactivada, el rectángulo devuelto no es válido. Un index no válido también devuelve un rectángulo no válido.
Esta función se introdujo en Qt 6.12.
Véase también visualRect() y QStyle::SE_TreeViewDisclosureItem.
[override virtual protected] void QTreeView::keyPressEvent(QKeyEvent *event)
Reimplementa: ` QAbstractItemView::keyPressEvent(QKeyEvent *event)`.
[override virtual] void QTreeView::keyboardSearch(const QString &search)
Reimplementa: QAbstractItemView::keyboardSearch(const QString &search).
[override virtual protected] void QTreeView::mouseDoubleClickEvent(QMouseEvent *event)
Reimplementa: QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event).
[override virtual protected] void QTreeView::mouseMoveEvent(QMouseEvent *event)
Reimplementa: QAbstractItemView::mouseMoveEvent(QMouseEvent *event).
[override virtual protected] void QTreeView::mousePressEvent(QMouseEvent *event)
Reimplementa: ` QAbstractItemView::mousePressEvent(QMouseEvent *event)`.
[override virtual protected] void QTreeView::mouseReleaseEvent(QMouseEvent *event)
Reimplementa: ` QAbstractItemView::mouseReleaseEvent(QMouseEvent *event)`.
[override virtual protected] QModelIndex QTreeView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)
Reimplementa: ` QAbstractItemView::moveCursor` (`QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers`).
Mueve el cursor tal y como se describe en ` cursorAction`, utilizando la información proporcionada por el botón ` modifiers`.
[override virtual protected] void QTreeView::paintEvent(QPaintEvent *event)
Reimplementa: ` QAbstractScrollArea::paintEvent` (`QPaintEvent *event)`.
[override virtual] void QTreeView::reset()
Reimplementa: QAbstractItemView::reset().
[slot] void QTreeView::resizeColumnToContents(int column)
Ajusta el tamaño del documento « column » al de su contenido.
Véase también columnWidth(), setColumnWidth(), sizeHintForColumn() y QHeaderView::resizeContentsPrecision().
[protected] int QTreeView::rowHeight(const QModelIndex &index) const
Devuelve la altura de la fila indicada por el ` index` proporcionado.
Véase también indexRowSizeHint().
[override virtual protected] void QTreeView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)
Reimplementa: QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end).
Informa a la vista de que las filas comprendidas entre la fila « start » y la fila « end », ambas incluidas, están a punto de eliminarse del elemento del modelo « parent » especificado.
[override virtual protected] void QTreeView::rowsInserted(const QModelIndex &parent, int start, int end)
Reimplementa: QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end).
Informa a la vista de que las filas comprendidas entre la fila « start » y la fila « end », ambas incluidas, se han insertado en el elemento del modelo « parent ».
[protected slot] void QTreeView::rowsRemoved(const QModelIndex &parent, int start, int end)
Indica que las filas comprendidas entre la fila « start » y la fila « end », ambas incluidas, se han eliminado del elemento del modelo parent especificado.
[override virtual protected] void QTreeView::scrollContentsBy(int dx, int dy)
Reimplementa: ` QAbstractScrollArea::scrollContentsBy(int dx, int dy)`.
Desplaza el contenido de la vista de árbol en (dx, dy).
[override virtual] void QTreeView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)
Reimplementa: QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint).
Desplaza el contenido de la vista de árbol hasta que el elemento del modelo especificado index quede visible. El parámetro hint especifica con mayor precisión dónde debe situarse el elemento tras la operación. Si alguno de los elementos padres del elemento del modelo está contraído, se expandirá para garantizar que el elemento del modelo quede visible.
[override virtual] void QTreeView::selectAll()
Reimplementa: QAbstractItemView::selectAll().
[override virtual protected] QModelIndexList QTreeView::selectedIndexes() const
Reimplementa: ` QAbstractItemView::selectedIndexes()` const.
[override virtual protected] void QTreeView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)
Reimplementa: QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected).
void QTreeView::setColumnHidden(int column, bool hide)
Si hide es verdadero, se oculta el column; en caso contrario, se muestra el column.
Véanse también isColumnHidden(), hideColumn() y setRowHidden().
void QTreeView::setColumnWidth(int column, int width)
Establece el ancho del elemento ` column ` indicado en el valor especificado ` width `.
Véase también columnWidth() y resizeColumnToContents().
void QTreeView::setExpanded(const QModelIndex &index, bool expanded)
Establece el elemento al que hace referencia index como contraído o expandido, en función del valor de expanded.
Véanse también expanded(), expand() y isExpanded().
void QTreeView::setFirstColumnSpanned(int row, const QModelIndex &parent, bool span)
Si span es verdadero, el elemento de la primera columna de row con el parent indicado se establece para abarcar todas las columnas; en caso contrario, se muestran todos los elementos de row.
Véase también isFirstColumnSpanned().
void QTreeView::setHeader(QHeaderView *header)
Establece el encabezado de la vista de árbol en el valor proporcionado: header.
La vista asume la propiedad del objeto ` header ` especificado y lo elimina cuando se establece un nuevo encabezado.
Véase también QAbstractItemModel::headerData().
[override virtual] void QTreeView::setModel(QAbstractItemModel *model)
Reimplementa: QAbstractItemView::setModel(QAbstractItemModel *model).
[override virtual] void QTreeView::setRootIndex(const QModelIndex &index)
Reimplementa: ` QAbstractItemView::setRootIndex(const QModelIndex &index)`.
void QTreeView::setRowHidden(int row, const QModelIndex &parent, bool hide)
Si hide es verdadero, se oculta el row con el parent indicado; en caso contrario, se muestra el row.
Véase también isRowHidden() y setColumnHidden().
[override virtual protected] void QTreeView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command)
Reimplementa: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).
Aplica la selección command a los elementos que se encuentran dentro del rectángulo o que son tocados por él, rect.
Véase también selectionCommand().
[override virtual] void QTreeView::setSelectionModel(QItemSelectionModel *selectionModel)
Reimplementa: QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).
void QTreeView::setTreePosition(int index)
Esto especifica que la estructura de árbol debe situarse en el índice lógico index. Si se establece en -1, el árbol seguirá siempre el índice visual 0.
Véanse también treePosition(), QHeaderView::swapSections() y QHeaderView::moveSection().
[slot] void QTreeView::showColumn(int column)
Muestra el « column » indicado en la vista de árbol.
Véase también hideColumn() y setColumnHidden().
[override virtual protected] int QTreeView::sizeHintForColumn(int column) const
Reimplementa: ` QAbstractItemView::sizeHintForColumn(int column) const`.
Devuelve la sugerencia de tamaño para el ancho de la « column » o -1 si no hay ningún modelo.
Si necesitas establecer el ancho de una columna determinada en un valor fijo, llama a ` QHeaderView::resizeSection()` en el encabezado de la vista.
Si reimplementas esta función en una subclase, ten en cuenta que el valor que devuelves solo se utiliza cuando se llama a ` resizeColumnToContents()`. En ese caso, si el encabezado de la vista o el delegado del elemento requieren un ancho de columna mayor, se utilizará ese ancho en su lugar.
Véase también QWidget::sizeHint, header() y QHeaderView::resizeContentsPrecision().
[slot] void QTreeView::sortByColumn(int column, Qt::SortOrder order)
Ordena el modelo según los valores de los parámetros « column » y « order ».
column Puede ser -1; en ese caso, no se mostrará ningún indicador de ordenación y el modelo volverá a su orden natural, sin ordenar. Ten en cuenta que no todos los modelos admiten esta función y que, en este caso, incluso podrían bloquearse.
Véase también sortingEnabled.
[override virtual protected] void QTreeView::timerEvent(QTimerEvent *event)
Reimplementa: ` QAbstractItemView::timerEvent(QTimerEvent *event)`.
int QTreeView::treePosition() const
Devuelve el índice lógico en el que está situado el árbol. Si el valor devuelto es -1, el árbol se sitúa en el índice visual 0.
Véase también setTreePosition().
[override virtual protected] void QTreeView::updateGeometries()
Reimplementa: QAbstractItemView::updateGeometries().
[override virtual protected] int QTreeView::verticalOffset() const
Reimplementa: ` QAbstractItemView::verticalOffset()` const.
Devuelve el desplazamiento vertical de los elementos en la vista de árbol.
Véase también horizontalOffset().
[override virtual protected] bool QTreeView::viewportEvent(QEvent *event)
Reimplementa: ` QAbstractItemView::viewportEvent(QEvent *event)`.
[override virtual protected] QSize QTreeView::viewportSizeHint() const
Reimplementa: ` QAbstractItemView::viewportSizeHint()` const.
[override virtual] QRect QTreeView::visualRect(const QModelIndex &index) const
Reimplementa: ` QAbstractItemView::visualRect(const QModelIndex &index) const`.
Devuelve el rectángulo de la ventana gráfica ocupado por el elemento en index. Si el índice no está visible o está oculto explícitamente, el rectángulo devuelto no es válido.
Véase también itemDecorationRect().
[override virtual protected] QRegion QTreeView::visualRegionForSelection(const QItemSelection &selection) const
Reimplementa: ` QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const`.
Devuelve el rectángulo de la ventana de visualización correspondiente a los elementos de la selection dada.
Desde la versión 4.7, la región devuelta solo contiene rectángulos que se cruzan con (o están incluidos en) el área de visualización.
© 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.