QTreeView Class

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

Dokumentation der Mitgliedsfunktionen

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

Konstruiert eine Baumansicht mit einem parent, um die Daten eines Modells darzustellen. Verwenden Sie setModel(), um das Modell zu setzen.

Siehe auch QAbstractItemModel.

[virtual noexcept] QTreeView::~QTreeView()

Zerstört die Baumansicht.

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

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

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

Klappt das durch index angegebene Modellelement zusammen.

Siehe auch collapsed().

[slot] void QTreeView::collapseAll()

Klappt alle erweiterten Elemente zusammen.

Siehe auch expandAll(), expand(), collapse(), und setExpanded().

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

Dieses Signal wird ausgegeben, wenn das durch index angegebene Element zusammengeklappt wird.

int QTreeView::columnAt(int x) const

Gibt die Spalte in der Strukturansicht zurück, deren Kopfzeile die angegebene x Koordinate abdeckt.

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

Informiert die Baumansicht, dass die Anzahl der Spalten in der Baumansicht von oldCount auf newCount geändert wurde.

[protected slot] void QTreeView::columnMoved()

Dieser Slot wird immer dann aufgerufen, wenn eine Spalte verschoben wurde.

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

Diese Funktion wird immer dann aufgerufen, wenn die Größe von column in der Kopfzeile geändert wird. oldSize und newSize geben die vorherige Größe und die neue Größe in Pixeln an.

Siehe auch setColumnWidth().

int QTreeView::columnViewportPosition(int column) const

Gibt die horizontale Position von column im Ansichtsfenster zurück.

int QTreeView::columnWidth(int column) const

Gibt die Breite von column zurück.

Siehe auch resizeColumnToContents() und setColumnWidth().

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

Reimplements: 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>())

Reimplements: QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles).

[override virtual protected] void QTreeView::dragMoveEvent(QDragMoveEvent *event)

Reimplements: QAbstractItemView::dragMoveEvent(QDragMoveEvent *event).

[virtual protected] void QTreeView::drawBranches(QPainter *painter, const QRect &rect, const QModelIndex &index) const

Zeichnet die Zweige in der Baumansicht in derselben Zeile wie das Modellelement index, unter Verwendung der angegebenen painter. Die Zweige werden in dem durch rect angegebenen Rechteck gezeichnet.

[virtual protected] void QTreeView::drawRow(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

Zeichnet die Zeile in der Strukturansicht, die das Modellelement index enthält, unter Verwendung der angegebenen painter. Die option steuert, wie das Element angezeigt wird.

Siehe auch setAlternatingRowColors().

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

Zeichnet den Teil des Baums, der die angegebene region schneidet, unter Verwendung der angegebenen painter.

Siehe auch paintEvent().

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

Erweitert das durch index angegebene Modellelement.

Siehe auch expanded().

[slot] void QTreeView::expandAll()

Erweitert alle erweiterbaren Elemente.

Siehe auch collapseAll(), expand(), collapse(), und setExpanded().

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

Erweitert das Element am angegebenen index und alle seine Kinder bis zum angegebenen depth. Die Angabe depth ist relativ zum angegebenen index. Ein depth von -1 erweitert alle Kinder, ein depth von 0 erweitert nur das angegebene index.

Siehe auch expandAll().

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

Erweitert alle erweiterbaren Elemente auf die angegebene depth.

Siehe auch expandAll(), collapseAll(), expand(), collapse(), und setExpanded().

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

Dieses Signal wird ausgegeben, wenn das durch index angegebene Element erweitert wird.

Siehe auch setExpanded().

QHeaderView *QTreeView::header() const

Gibt die Überschrift für die Baumansicht zurück.

Siehe auch setHeader() und QAbstractItemModel::headerData().

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

Blendet die angegebene column aus.

Siehe auch showColumn() und setColumnHidden().

[override virtual protected] int QTreeView::horizontalOffset() const

Reimplements: QAbstractItemView::horizontalOffset() const.

Gibt den horizontalen Versatz der Elemente in der Baumansicht zurück.

Beachten Sie, dass die Baumansicht die Positionen der horizontalen Kopfabschnitte verwendet, um die Positionen der Spalten in der Ansicht zu bestimmen.

Siehe auch verticalOffset().

QModelIndex QTreeView::indexAbove(const QModelIndex &index) const

Gibt den Modellindex des Elements über index zurück.

[override virtual] QModelIndex QTreeView::indexAt(const QPoint &point) const

Reimplements: QAbstractItemView::indexAt(const QPoint &point) const.

QModelIndex QTreeView::indexBelow(const QModelIndex &index) const

Gibt den Modellindex des Elements unter index zurück.

[protected] int QTreeView::indexRowSizeHint(const QModelIndex &index) const

Gibt den Größenhinweis für die durch index angegebene Zeile zurück.

Siehe auch sizeHintForColumn() und uniformRowHeights().

bool QTreeView::isColumnHidden(int column) const

Gibt true zurück, wenn column ausgeblendet ist; andernfalls wird false zurückgegeben.

Siehe auch hideColumn() und isRowHidden().

bool QTreeView::isExpanded(const QModelIndex &index) const

Gibt true zurück, wenn das Modellelement index erweitert ist; andernfalls wird false zurückgegeben.

Siehe auch expand(), expanded(), und setExpanded().

bool QTreeView::isFirstColumnSpanned(int row, const QModelIndex &parent) const

Gibt true zurück, wenn das Element in der ersten Spalte in der angegebenen row der parent alle Spalten umfasst; andernfalls gibt false zurück.

Siehe auch setFirstColumnSpanned().

[override virtual protected] bool QTreeView::isIndexHidden(const QModelIndex &index) const

Reimplements: QAbstractItemView::isIndexHidden(const QModelIndex &index) const.

bool QTreeView::isRowHidden(int row, const QModelIndex &parent) const

Gibt true zurück, wenn das Element in der angegebenen row der parent ausgeblendet ist; andernfalls gibt false zurück.

Siehe auch setRowHidden() und isColumnHidden().

[override virtual protected] void QTreeView::keyPressEvent(QKeyEvent *event)

Reimplements: QAbstractItemView::keyPressEvent(QKeyEvent *event).

[override virtual] void QTreeView::keyboardSearch(const QString &search)

Reimplements: QAbstractItemView::keyboardSearch(const QString &search).

[override virtual protected] void QTreeView::mouseDoubleClickEvent(QMouseEvent *event)

Reimplements: QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event).

[override virtual protected] void QTreeView::mouseMoveEvent(QMouseEvent *event)

Reimplements: QAbstractItemView::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QTreeView::mousePressEvent(QMouseEvent *event)

Reimplements: QAbstractItemView::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QTreeView::mouseReleaseEvent(QMouseEvent *event)

Reimplements: QAbstractItemView::mouseReleaseEvent(QMouseEvent *event).

[override virtual protected] QModelIndex QTreeView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

Reimplements: QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers).

Bewegt den Cursor auf die durch cursorAction beschriebene Art und Weise, unter Verwendung der von der Schaltfläche modifiers bereitgestellten Informationen.

[override virtual protected] void QTreeView::paintEvent(QPaintEvent *event)

Reimplements: QAbstractScrollArea::paintEvent(QPaintEvent *event).

[override virtual] void QTreeView::reset()

Reimplements: QAbstractItemView::reset().

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

Verändert die Größe der angegebenen column auf die Größe ihres Inhalts.

Siehe auch columnWidth(), setColumnWidth(), sizeHintForColumn(), und QHeaderView::resizeContentsPrecision().

[protected] int QTreeView::rowHeight(const QModelIndex &index) const

Gibt die Höhe der durch die angegebene index angegebenen Zeile zurück.

Siehe auch indexRowSizeHint().

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

Reimplements: QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end).

Informiert die Ansicht, dass die Zeilen von der Zeile start bis einschließlich der Zeile end aus dem angegebenen Modellelement parent entfernt werden sollen.

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

Reimplements: QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end).

Informiert die Ansicht, dass die Zeilen von der Zeile start bis einschließlich der Zeile end in das Modellelement parent eingefügt wurden.

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

Informiert die Ansicht, dass die Zeilen von der Zeile start bis einschließlich der Zeile end aus dem angegebenen Modellelement parent entfernt wurden.

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

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

Scrollt den Inhalt der Baumansicht um (dx, dy).

[override virtual] void QTreeView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

Reimplements: QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint).

Scrollt den Inhalt der Baumansicht, bis das angegebene Modellelement index sichtbar ist. Der Parameter hint gibt genauer an, wo sich das Element nach der Operation befinden soll. Sind die übergeordneten Elemente des Modellelements kollabiert, werden sie erweitert, um sicherzustellen, dass das Modellelement sichtbar ist.

[override virtual] void QTreeView::selectAll()

Reimplements: QAbstractItemView::selectAll().

[override virtual protected] QModelIndexList QTreeView::selectedIndexes() const

Reimplements: QAbstractItemView::selectedIndexes() const.

[override virtual protected] void QTreeView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Reimplements: QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected).

void QTreeView::setColumnHidden(int column, bool hide)

Wenn hide wahr ist, wird column ausgeblendet, andernfalls wird column angezeigt.

Siehe auch isColumnHidden(), hideColumn(), und setRowHidden().

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

Setzt die Breite des angegebenen column auf die angegebene width.

Siehe auch columnWidth() und resizeColumnToContents().

void QTreeView::setExpanded(const QModelIndex &index, bool expanded)

Stellt das Element, auf das index verweist, je nach dem Wert von expanded entweder ein oder aus.

Siehe auch expanded(), expand(), und isExpanded().

void QTreeView::setFirstColumnSpanned(int row, const QModelIndex &parent, bool span)

Wenn span wahr ist, wird das Element in der ersten Spalte in row mit dem angegebenen parent so eingestellt, dass es alle Spalten umfasst, andernfalls werden alle Elemente auf row angezeigt.

Siehe auch isFirstColumnSpanned().

void QTreeView::setHeader(QHeaderView *header)

Setzt die Kopfzeile für die Baumansicht auf die angegebene header.

Die Ansicht übernimmt das Eigentum an der angegebenen header und löscht sie, wenn eine neue Kopfzeile gesetzt wird.

Siehe auch QAbstractItemModel::headerData().

[override virtual] void QTreeView::setModel(QAbstractItemModel *model)

Reimplements: QAbstractItemView::setModel(QAbstractItemModel *model).

[override virtual] void QTreeView::setRootIndex(const QModelIndex &index)

Reimplements: QAbstractItemView::setRootIndex(const QModelIndex &index).

void QTreeView::setRowHidden(int row, const QModelIndex &parent, bool hide)

Wenn hide wahr ist, wird die row mit der angegebenen parent ausgeblendet, andernfalls wird die row angezeigt.

Siehe auch isRowHidden() und setColumnHidden().

[override virtual protected] void QTreeView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command)

Reimplements: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

Wendet die Auswahl command auf die Elemente an, die sich im Rechteck befinden oder von diesem berührt werden, rect.

Siehe auch selectionCommand().

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

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

void QTreeView::setTreePosition(int index)

Damit wird festgelegt, dass die Baumstruktur bei dem logischen Index index platziert werden soll. Wenn auf -1 gesetzt ist, wird der Baum immer dem visuellen Index 0 folgen.

Siehe auch treePosition(), QHeaderView::swapSections(), und QHeaderView::moveSection().

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

Zeigt die angegebene column in der Baumansicht.

Siehe auch hideColumn() und setColumnHidden().

[override virtual protected] int QTreeView::sizeHintForColumn(int column) const

Reimplements: QAbstractItemView::sizeHintForColumn(int column) const.

Gibt den Größenhinweis für die Breite von column zurück oder -1, wenn es kein Modell gibt.

Wenn Sie die Breite einer bestimmten Spalte auf einen festen Wert setzen müssen, rufen Sie QHeaderView::resizeSection() auf dem Kopf der Ansicht auf.

Wenn Sie diese Funktion in einer Unterklasse neu implementieren, beachten Sie, dass der Wert, den Sie zurückgeben, nur verwendet wird, wenn resizeColumnToContents() aufgerufen wird. Wenn in diesem Fall eine größere Spaltenbreite entweder von der Kopfzeile der Ansicht oder dem Elementdelegaten benötigt wird, wird stattdessen diese Breite verwendet.

Siehe auch QWidget::sizeHint, header(), und QHeaderView::resizeContentsPrecision().

[slot] void QTreeView::sortByColumn(int column, Qt::SortOrder order)

Sortiert das Modell nach den Werten in den angegebenen column und order.

column kann -1 sein. In diesem Fall wird kein Sortierindikator angezeigt und das Modell kehrt zu seiner natürlichen, unsortierten Reihenfolge zurück. Beachten Sie, dass nicht alle Modelle dies unterstützen und in diesem Fall sogar abstürzen können.

Siehe auch sortingEnabled.

[override virtual protected] void QTreeView::timerEvent(QTimerEvent *event)

Reimplements: QAbstractItemView::timerEvent(QTimerEvent *event).

int QTreeView::treePosition() const

Gibt den logischen Index zurück, auf den der Baum gesetzt ist. Wenn der Rückgabewert -1 ist, wird der Baum auf den visuellen Index 0 gesetzt.

Siehe auch setTreePosition().

[override virtual protected] void QTreeView::updateGeometries()

Reimplements: QAbstractItemView::updateGeometries().

[override virtual protected] int QTreeView::verticalOffset() const

Reimplements: QAbstractItemView::verticalOffset() const.

Gibt den vertikalen Versatz der Elemente in der Baumansicht zurück.

Siehe auch horizontalOffset().

[override virtual protected] bool QTreeView::viewportEvent(QEvent *event)

Reimplements: QAbstractItemView::viewportEvent(QEvent *Event).

[override virtual protected] QSize QTreeView::viewportSizeHint() const

Reimplements: QAbstractItemView::viewportSizeHint() const.

[override virtual] QRect QTreeView::visualRect(const QModelIndex &index) const

Reimplements: QAbstractItemView::visualRect(const QModelIndex &index) const.

Gibt das Rechteck auf dem Ansichtsfenster zurück, das von dem Element unter index belegt wird. Wenn der Index nicht sichtbar oder explizit ausgeblendet ist, ist das zurückgegebene Rechteck ungültig.

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

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

Gibt das Rechteck aus dem Ansichtsfenster der Elemente in der angegebenen selection zurück.

Seit 4.7 enthält die zurückgegebene Region nur Rechtecke, die das Ansichtsfenster schneiden (oder darin enthalten sind).