QTreeView Class

QFileSystemModel *model = new QFileSystemModel;
model->setRootPath(QDir::currentPath());
QTreeView *tree = new QTreeView(splitter);
tree->setModel(model);

Documentación de funciones miembro

[explicit] QTreeView::QTreeView(QWidget *parent = nullptr)

Construye una vista de árbol con un parent para representar los datos de un modelo. Utilice setModel() para establecer el modelo.

Véase también QAbstractItemModel.

[virtual noexcept] QTreeView::~QTreeView()

Destruye la vista en árbol.

[override virtual protected] void QTreeView::changeEvent(QEvent *event)

Reimplementa: QFrame::changeEvent(QEvent *ev).

[slot] void QTreeView::collapse(const QModelIndex &index)

Colapsa el elemento del modelo especificado por index.

Véase también collapsed().

[slot] void QTreeView::collapseAll()

Colapsa todos los elementos expandidos.

Véase también expandAll(), expand(), collapse() y setExpanded().

[signal] void QTreeView::collapsed(const QModelIndex &index)

Esta señal se emite cuando el elemento especificado por index se colapsa.

int QTreeView::columnAt(int x) const

Devuelve la columna de la vista en árbol cuya cabecera cubre la coordenada x dada.

[protected slot] void QTreeView::columnCountChanged(int oldCount, int newCount)

Informa a la vista en árbol de que el número de columnas de la vista en árbol ha cambiado de oldCount a newCount.

[protected slot] void QTreeView::columnMoved()

Esta ranura se llama cada vez que se ha movido una columna.

[protected slot] void QTreeView::columnResized(int column, int oldSize, int newSize)

Esta función es llamada cada vez que se cambia el tamaño de column en la cabecera. oldSize y newSize dan 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 de column en la ventana gráfica.

int QTreeView::columnWidth(int column) const

Devuelve la anchura de column.

Véase también resizeColumnToContents() y setColumnWidth().

[override virtual protected] void QTreeView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

Reimplementa: QAbstractItemView::currentChanged(const QModelIndex &current, 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 en árbol en la misma fila que el elemento del modelo index, utilizando el painter dado. 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 en la vista en árbol que contiene el elemento del modelo index, utilizando el painter dado. option controla cómo se muestra el elemento.

Véase también setAlternatingRowColors().

[protected] void QTreeView::drawTree(QPainter *painter, const QRegion &region) const

Dibuja la parte del árbol que interseca la dirección region utilizando la dirección painter especificada.

Véase también paintEvent().

[slot] void QTreeView::expand(const QModelIndex &index)

Amplía el elemento del modelo especificado por index.

Véase también expanded().

[slot] void QTreeView::expandAll()

Expande todos los elementos expandibles.

Véase también collapseAll(), expand(), collapse() y setExpanded().

[slot] void QTreeView::expandRecursively(const QModelIndex &index, int depth = -1)

Expande el elemento en el index dado y todos sus hijos al depth dado. El depth es relativo al index. Un depth de -1 expandirá todos los hijos, un depth de 0 sólo expandirá el index dado.

Véase también expandAll().

[slot] void QTreeView::expandToDepth(int depth)

Expande todos los elementos expandibles a la dirección depth.

Véase también expandAll(), collapseAll(), expand(), collapse(), y setExpanded().

[signal] void QTreeView::expanded(const QModelIndex &index)

Esta señal se emite cuando se expande el elemento especificado por index.

Véase también setExpanded().

QHeaderView *QTreeView::header() const

Devuelve la cabecera de la vista en árbol.

Véase también setHeader() y QAbstractItemModel::headerData().

[slot] void QTreeView::hideColumn(int column)

Oculta el column dado.

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 de la vista en árbol.

Tenga en cuenta que la vista en árbol utiliza las posiciones horizontales de la sección de cabecera 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 por 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 situado por debajo de 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 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 en el row dado del 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 en el row dado del parent está oculto; en caso contrario devuelve false.

Véase también setRowHidden() y isColumnHidden().

[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 modificadores).

Mueve el cursor de la forma descrita por cursorAction, usando 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)

Redimensiona el column dado al tamaño 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 index.

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 inicio, int fin).

Informa a la vista de que las filas desde la fila start hasta la fila end inclusive están a punto de ser eliminadas del elemento del modelo parent dado.

[override virtual protected] void QTreeView::rowsInserted(const QModelIndex &parent, int start, int end)

Reimplementa: QAbstractItemView::rowsInserted(const QModelIndex &parent, int inicio, int fin).

Informa a la vista de que las filas desde la fila start hasta la fila end inclusive se han insertado en el elemento del modelo parent.

[protected slot] void QTreeView::rowsRemoved(const QModelIndex &parent, int start, int end)

Informa a la vista de que las filas desde la fila start hasta la fila end inclusive se han eliminado del elemento del modelo parent dado.

[override virtual protected] void QTreeView::scrollContentsBy(int dx, int dy)

Reimplementa: QAbstractScrollArea::scrollContentsBy(int dx, int dy).

Desplaza el contenido de la vista en árbol por (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 en árbol hasta que el elemento del modelo dado index sea 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 padre del elemento del modelo está contraído, se expandirá para garantizar que el elemento del modelo sea 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 column, en caso contrario se muestra column.

Véase también isColumnHidden(), hideColumn() y setRowHidden().

void QTreeView::setColumnWidth(int column, int width)

Establece la anchura del column dado al width especificado.

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éase 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 en row con el parent dado se establece para abarcar todas las columnas; de lo contrario, se muestran todos los elementos en row.

Véase también isFirstColumnSpanned().

void QTreeView::setHeader(QHeaderView *header)

Establece la cabecera de la vista en árbol, en la dirección header.

La vista se apropia de la header y la borra cuando se establece una nueva cabecera.

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 dado, 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 en o tocados por el rectángulo, rect.

Véase también selectionCommand().

[override virtual] void QTreeView::setSelectionModel(QItemSelectionModel *selectionModel)

Reimplementa: QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).

void QTreeView::setTreePosition(int index)

Especifica que la estructura del árbol debe situarse en el índice lógico index. Si se establece en -1 entonces el árbol siempre seguirá el índice visual 0.

Véase también treePosition(), QHeaderView::swapSections(), y QHeaderView::moveSection().

[slot] void QTreeView::showColumn(int column)

Muestra el column dado 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 columna) const.

Devuelve la sugerencia de tamaño para la anchura de column o -1 si no hay modelo.

Si necesita establecer la anchura de una columna dada a un valor fijo, llame a QHeaderView::resizeSection() en la cabecera de la vista.

Si reimplementas esta función en una subclase, ten en cuenta que el valor que devuelves sólo se utiliza cuando se llama a resizeColumnToContents(). En ese caso, si la cabecera 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 column y order.

column puede ser -1, en cuyo caso no se mostrará ningún indicador de ordenación y el modelo volverá a su orden natural, sin ordenar. Tenga en cuenta que no todos los modelos admiten esta opción e incluso pueden bloquearse en este caso.

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 se coloca el árbol. Si el valor de retorno es -1 entonces el árbol se coloca 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 ocupado por el elemento en index. Si el índice no es visible o está explícitamente oculto, el rectángulo devuelto no es válido.

[override virtual protected] QRegion QTreeView::visualRegionForSelection(const QItemSelection &selection) const

Reimplementa: QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const.

Devuelve el rectángulo de la ventana gráfica de los elementos en el selection dado.

Desde 4.7, la región devuelta sólo contiene rectángulos que intersecan (o están incluidos en) la ventana gráfica.