QTreeView Class

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

Dokumentation zu den Member-Funktionen

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

Erstellt eine Baumansicht mit einem „ parent “, um die Daten eines Modells darzustellen. Verwenden Sie „ setModel()“, um das Modell festzulegen.

Siehe auch ` QAbstractItemModel`.

[virtual noexcept] QTreeView::~QTreeView()

Löscht die Baumansicht.

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

Umsetzt: ` QFrame::changeEvent(QEvent *ev)`.

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

Faltet das durch „ index “ angegebene Modellelement zusammen.

Siehe auch ` collapsed()`.

[slot] void QTreeView::collapseAll()

Faltet alle aufgeklappten Elemente zusammen.

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

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

Dieses Signal wird ausgelöst, wenn das durch „ index “ angegebene Element ausgeblendet wird.

int QTreeView::columnAt(int x) const

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

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

Teilt der Baumansicht mit, dass sich die Anzahl der Spalten in der Baumansicht von oldCount auf newCount geändert hat.

[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 im Header 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 des „ column “ im Ansichtsbereich zurück.

int QTreeView::columnWidth(int column) const

Gibt die Breite des „ column “ zurück.

Siehe auch „ resizeColumnToContents()“ und „ setColumnWidth()“.

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

Implementiert: ` 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>())

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

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

Umsetzt: ` 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 “ festgelegten Rechteck gezeichnet.

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

Zeichnet die Zeile in der Baumansicht, die das Modellelement „ index “ enthält, unter Verwendung des angegebenen „ painter “. Der „ 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 den angegebenen „ region “ schneidet, unter Verwendung des angegebenen „ painter “.

Siehe auch paintEvent().

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

Erweitert das durch die „ 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 an der angegebenen Position „ index “ sowie alle seine untergeordneten Elemente auf die angegebene Position „ depth “. Die Position „ depth “ ist relativ zur angegebenen Position „ index “. Ein Wert von -1 für „ depth “ erweitert alle untergeordneten Elemente, ein Wert von 0 für „ depth “ erweitert nur das angegebene Element „ index “.

Siehe auch „ expandAll()“.

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

Erweitert alle erweiterbaren Elemente auf die angegebene Breite depth.

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

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

Dieses Signal wird ausgelöst, wenn das durch „ index “ angegebene Element erweitert wird.

Siehe auch setExpanded().

QHeaderView *QTreeView::header() const

Gibt den Header 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

Implementiert: QAbstractItemView::horizontalOffset() const.

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

Beachten Sie, dass die Baumansicht die Positionen der horizontalen Kopfzeilenabschnitte 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 oberhalb von „ index “ zurück.

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

Implementiert neu: 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 die „ 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 der angegebenen „ row “ der „ parent “ sich über alle Spalten erstreckt; andernfalls wird „ false “ zurückgegeben.

Siehe auch setFirstColumnSpanned().

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

Implementiert neu: ` QAbstractItemView::isIndexHidden(const QModelIndex &index) const`.

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

Gibt „ true “ zurück, wenn das Element im angegebenen „ row “ des „ parent “ ausgeblendet ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch setRowHidden() und isColumnHidden().

[since 6.12] QRect QTreeView::itemDecorationRect(const QModelIndex &index) const

Gibt das Rechteck zurück, das von der Ein- und Ausklappanzeige des Elements unter index eingenommen wird. Verfügt das Element nicht über eine solche Anzeige – beispielsweise, weil es keine untergeordneten Elemente hat oder weil die Root-Dekoration deaktiviert ist –, ist das zurückgegebene Rechteck ungültig. Ein ungültiges index liefert ebenfalls ein ungültiges Rechteck zurück.

Diese Funktion wurde in Qt 6.12 eingeführt.

Siehe auch visualRect() und QStyle::SE_TreeViewDisclosureItem.

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

Implementiert: ` QAbstractItemView::keyPressEvent(QKeyEvent *event)`.

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

Implementiert neu: ` QAbstractItemView::keyboardSearch(const QString &search)`.

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

Implementiert: ` QAbstractItemView::mouseDoubleClickEvent` (`QMouseEvent *event`).

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

Implementiert: ` QAbstractItemView::mouseMoveEvent(QMouseEvent *event)`.

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

Implementiert: ` QAbstractItemView::mousePressEvent` (`QMouseEvent *event`).

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

Implementiert: ` QAbstractItemView::mouseReleaseEvent` (`QMouseEvent *event`).

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

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

Bewegt den Cursor gemäß der in ` cursorAction` beschriebenen Vorgehensweise unter Verwendung der vom Button bereitgestellten Informationen ` modifiers`.

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

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

[override virtual] void QTreeView::reset()

Implementiert: QAbstractItemView::reset().

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

Passen die Größe des angegebenen „ column “ an die Größe seines Inhalts an.

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

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

Gibt die Höhe der Zeile zurück, auf die der angegebene ` index` verweist.

Siehe auch ` indexRowSizeHint()`.

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

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

Teilt der Ansicht mit, 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)

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

Teilt der Ansicht mit, 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)

Gibt an, 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)

Implementiert: ` QAbstractScrollArea::scrollContentsBy(int dx, int dy)`.

Blättert den Inhalt der Baumansicht um (dx, dy).

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

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

Blättert den Inhalt der Baumansicht so lange durch, bis das angegebene Modellelement index sichtbar ist. Der Parameter „ hint “ gibt genauer an, wo sich das Element nach der Operation befinden soll. Sind einige der übergeordneten Elemente des Modellelements ausgeblendet, werden sie erweitert, um sicherzustellen, dass das Modellelement sichtbar ist.

[override virtual] void QTreeView::selectAll()

Implementiert: QAbstractItemView::selectAll().

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

Implementiert neu: ` QAbstractItemView::selectedIndexes()` const.

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

Implementiert: ` 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)

Legt die Breite des angegebenen „ column “ auf den angegebenen Wert „ width “ fest.

Siehe auch „ columnWidth()“ und „ resizeColumnToContents()“.

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

Setzt das Element, auf das „ index “ verweist, je nach dem Wert von „ expanded “ entweder auf „zusammengeklappt“ oder „aufgeklappt“.

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 des „ row “ mit der angegebenen „ parent “ so eingestellt, dass es sich über alle Spalten erstreckt; andernfalls werden alle Elemente auf der „ row “ angezeigt.

Siehe auch isFirstColumnSpanned().

void QTreeView::setHeader(QHeaderView *header)

Setzt die Kopfzeile der Baumansicht auf die angegebene Adresse header.

Die Ansicht übernimmt die Eigentumsrechte an dem angegebenen „ header “ und löscht diesen, sobald eine neue Kopfzeile festgelegt wird.

Siehe auch ` QAbstractItemModel::headerData()`.

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

Implementiert: ` QAbstractItemView::setModel(QAbstractItemModel *model)`.

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

Implementiert: ` QAbstractItemView::setRootIndex(const QModelIndex &index)`.

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

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

Siehe auch isRowHidden() und setColumnHidden().

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

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

Wendet die Auswahlfunktion ` command ` auf die Elemente an, die sich innerhalb des Rechtecks befinden oder von diesem berührt werden: ` rect`.

Siehe auch selectionCommand().

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

Implementiert: ` QAbstractItemView::setSelectionModel` (`QItemSelectionModel *selectionModel`).

void QTreeView::setTreePosition(int index)

Dies legt fest, dass die Baumstruktur am logischen Index index platziert werden soll. Wenn auf -1 gesetzt ist, folgt der Baum immer dem visuellen Index 0.

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

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

Zeigt die angegebene „ column “ in der Baumansicht an.

Siehe auch „ hideColumn()“ und „ setColumnHidden()“.

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

Implementiert: ` QAbstractItemView::sizeHintForColumn(int column) const`.

Gibt den Größenhinweis für die Breite des „ column “ zurück oder -1, wenn kein Modell vorhanden ist.

Wenn Sie die Breite einer bestimmten Spalte auf einen festen Wert festlegen möchten, rufen Sie ` QHeaderView::resizeSection()` für die Kopfzeile der Ansicht auf.

Wenn Sie diese Funktion in einer Unterklasse neu implementieren, beachten Sie, dass der von Ihnen zurückgegebene Wert nur verwendet wird, wenn ` resizeColumnToContents()` aufgerufen wird. In diesem Fall wird stattdessen die Breite verwendet, die entweder von der Kopfzeile der Ansicht oder vom Element-Delegaten gefordert wird, falls diese größer ist.

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 Feldern „ column “ und „ order “.

column Kann den Wert -1 annehmen; 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)

Umsetzt: ` QAbstractItemView::timerEvent(QTimerEvent *event)`.

int QTreeView::treePosition() const

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

Siehe auch ` setTreePosition()`.

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

Implementiert: QAbstractItemView::updateGeometries().

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

Implementiert neu: ` 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)

Umsetzt: QAbstractItemView::viewportEvent(QEvent *event).

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

Implementiert: QAbstractItemView::viewportSizeHint() const.

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

Implementiert: ` QAbstractItemView::visualRect(const QModelIndex &index) const`.

Gibt das Rechteck im Ansichtsbereich zurück, das das Element unter index einnimmt. Wenn der Index nicht sichtbar oder explizit ausgeblendet ist, ist das zurückgegebene Rechteck ungültig.

Siehe auch ` itemDecorationRect()`.

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

Implementiert: ` QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const`.

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

Seit Version 4.7 enthält der zurückgegebene Bereich nur noch Rechtecke, die den Ansichtsbereich schneiden (oder darin enthalten sind).