QTreeWidget Class

auto *treeWidget = new QTreeWidget();
treeWidget->setColumnCount(1);
for (int i = 0; i < 10; ++i)
    new QTreeWidgetItem(treeWidget, { tr("item: %1").arg(i) });

Dokumentation zu den Member-Funktionen

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

Erstellt ein Baum-Widget mit dem angegebenen „ parent “.

[virtual noexcept] QTreeWidget::~QTreeWidget()

Löst das Baum-Widget und alle darin enthaltenen Elemente auf.

void QTreeWidget::addTopLevelItem(QTreeWidgetItem *item)

Fügt die „ item “ als Element der obersten Ebene in das Widget ein.

Siehe auch „ insertTopLevelItem()“.

void QTreeWidget::addTopLevelItems(const QList<QTreeWidgetItem *> &items)

Fügt die Liste von items als Elemente der obersten Ebene in das Widget ein.

Siehe auch „ insertTopLevelItems()“.

[slot] void QTreeWidget::clear()

Löscht das Baum-Widget, indem alle Elemente und Markierungen entfernt werden.

Hinweis: Da jedes Element vor dem Löschen aus dem Baum-Widget entfernt wird, ist der Rückgabewert von ` QTreeWidgetItem::treeWidget()` ungültig, wenn die Funktion vom Destruktor eines Elements aufgerufen wird.

Siehe auch ` takeTopLevelItem()`, ` topLevelItemCount()` und ` columnCount()`.

void QTreeWidget::closePersistentEditor(QTreeWidgetItem *item, int column = 0)

Schließt den persistenten Editor für die „ item “ in der angegebenen „ column “.

Diese Funktion hat keine Auswirkung, wenn für diese Kombination aus Element und Spalte kein persistenter Editor geöffnet ist.

Siehe auch „ openPersistentEditor()“ und „ isPersistentEditorOpen()“.

[slot] void QTreeWidget::collapseItem(const QTreeWidgetItem *item)

Schließt den „ item “. Dadurch wird der Baum, der die untergeordneten Elemente des Elements enthält, ausgeblendet.

Siehe auch „ expandItem()“, „ currentItem()“, „ itemAt()“ und „ topLevelItem()“.

int QTreeWidget::currentColumn() const

Gibt die aktuelle Spalte im Baum-Widget zurück.

Siehe auch setCurrentItem() und columnCount().

QTreeWidgetItem *QTreeWidget::currentItem() const

Gibt das aktuelle Element im Baum-Widget zurück.

Siehe auch setCurrentItem() und currentItemChanged().

[signal] void QTreeWidget::currentItemChanged(QTreeWidgetItem *current, QTreeWidgetItem *previous)

Dieses Signal wird ausgelöst, wenn sich das aktuelle Element ändert. Das aktuelle Element wird durch „ current “ festgelegt, wodurch das aktuelle Element „ previous “ ersetzt wird.

Siehe auch setCurrentItem().

[override virtual protected] void QTreeWidget::dropEvent(QDropEvent *event)

Implementiert: QAbstractItemView::dropEvent(QDropEvent *event).

[virtual protected] bool QTreeWidget::dropMimeData(QTreeWidgetItem *parent, int index, const QMimeData *data, Qt::DropAction action)

Verarbeitet den von einem Drag-and-Drop-Vorgang bereitgestellten „ data “, der mit dem angegebenen „ action “ im „ index “ des angegebenen „ parent “-Elements abgeschlossen wurde.

Die Standardimplementierung gibt ` true ` zurück, wenn das Ablegen erfolgreich verarbeitet wurde, indem die MIME-Daten dekodiert und in das Modell eingefügt wurden; andernfalls gibt sie ` false` zurück.

Siehe auch supportedDropActions() und supportedDragActions.

void QTreeWidget::editItem(QTreeWidgetItem *item, int column = 0)

Beginnt mit der Bearbeitung der Datei „ item “ im angegebenen Verzeichnis „ column “, sofern diese bearbeitbar ist.

[override virtual protected] bool QTreeWidget::event(QEvent *e)

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

[slot] void QTreeWidget::expandItem(const QTreeWidgetItem *item)

Erweitert die „ item “. Dadurch wird die Baumstruktur, die die untergeordneten Elemente des Elements enthält, erweitert.

Siehe auch collapseItem(), currentItem(), itemAt(), topLevelItem() und itemExpanded().

QList<QTreeWidgetItem *> QTreeWidget::findItems(const QString &text, Qt::MatchFlags flags, int column = 0) const

Gibt eine Liste von Elementen zurück, die dem angegebenen „ text “ entsprechen, unter Verwendung des angegebenen „ flags “ im angegebenen „ column “.

QTreeWidgetItem *QTreeWidget::headerItem() const

Gibt das Element zurück, das für die Kopfzeile des Baum-Widgets verwendet wird.

Siehe auch setHeaderItem().

QModelIndex QTreeWidget::indexFromItem(const QTreeWidgetItem *item, int column = 0) const

Gibt den „ QModelIndex “ zurück, der mit dem angegebenen „ item “ in der angegebenen „ column “ verknüpft ist.

Siehe auch itemFromIndex() und topLevelItem().

int QTreeWidget::indexOfTopLevelItem(QTreeWidgetItem *item) const

Gibt den Index des angegebenen „ item “ der obersten Ebene zurück oder -1, wenn das Element nicht gefunden werden kann.

Siehe auch ` sortItems()` und ` topLevelItemCount()`.

void QTreeWidget::insertTopLevelItem(int index, QTreeWidgetItem *item)

Fügt den Eintrag „ item “ unter „ index “ auf der obersten Ebene der Ansicht ein.

Wenn das Element bereits an anderer Stelle eingefügt wurde, wird es nicht erneut eingefügt.

Siehe auch „ addTopLevelItem()“ und „ columnCount()“.

void QTreeWidget::insertTopLevelItems(int index, const QList<QTreeWidgetItem *> &items)

Fügt die Liste unter items bei index auf der obersten Ebene in die Ansicht ein.

Elemente, die bereits an anderer Stelle eingefügt wurden, werden nicht erneut eingefügt.

Siehe auch addTopLevelItems().

QTreeWidgetItem *QTreeWidget::invisibleRootItem() const

Gibt das unsichtbare Stammelement des Baum-Widgets zurück.

Das unsichtbare Stammelement ermöglicht über die API „ QTreeWidgetItem “ den Zugriff auf die Elemente der obersten Ebene des Baum-Widgets, wodurch Funktionen geschrieben werden können, die Elemente der obersten Ebene und deren untergeordnete Elemente einheitlich behandeln – beispielsweise rekursive Funktionen.

bool QTreeWidget::isPersistentEditorOpen(QTreeWidgetItem *item, int column = 0) const

Gibt zurück, ob für das Element item in Spalte column ein persistenter Editor geöffnet ist.

Siehe auch ` openPersistentEditor()` und ` closePersistentEditor()`.

QTreeWidgetItem *QTreeWidget::itemAbove(const QTreeWidgetItem *item) const

Gibt das Element zurück, das über dem angegebenen „ item “ liegt.

[signal] void QTreeWidget::itemActivated(QTreeWidgetItem *item, int column)

Dieses Signal wird ausgelöst, wenn der Benutzer ein Element durch einen Einzel- oder Doppelklick (je nach Plattform, d. h. je nach dem Hinweis „ QStyle::SH_ItemView_ActivateItemOnSingleClick “) oder durch Drücken einer Sondertaste (z. B. „ Enter “) aktiviert.

Das angegebene ` item ` ist das Element, auf das geklickt wurde, oder ` nullptr `, wenn kein Element angeklickt wurde. Das ` column ` ist die Spalte des Elements, auf die geklickt wurde, oder -1, wenn kein Element angeklickt wurde.

QTreeWidgetItem *QTreeWidget::itemAt(const QPoint &p) const

Gibt einen Zeiger auf das Element an den Koordinaten p zurück. Die Koordinaten beziehen sich auf die viewport() des Baum-Widgets.

Siehe auch ` visualItemRect()`.

QTreeWidgetItem *QTreeWidget::itemAt(int x, int y) const

Gibt einen Zeiger auf das Element an den Koordinaten (x, y) zurück. Die Koordinaten beziehen sich auf die Funktion „ viewport()“ des Baum-Widgets.

QTreeWidgetItem *QTreeWidget::itemBelow(const QTreeWidgetItem *item) const

Gibt das Element zurück, das visuell unterhalb des angegebenen „ item “ liegt.

[signal] void QTreeWidget::itemChanged(QTreeWidgetItem *item, int column)

Dieses Signal wird ausgelöst, wenn sich der Inhalt der „ column “ in der angegebenen „ item “ ändert.

[signal] void QTreeWidget::itemClicked(QTreeWidgetItem *item, int column)

Dieses Signal wird ausgelöst, wenn der Benutzer innerhalb des Widgets klickt.

Die angegebene „ item “ ist das Element, auf das geklickt wurde. „ column “ ist die Spalte des Elements, auf die geklickt wurde. Wenn kein Element angeklickt wurde, wird kein Signal ausgelöst.

[signal] void QTreeWidget::itemCollapsed(QTreeWidgetItem *item)

Dieses Signal wird ausgelöst, wenn das angegebene „ item “ eingeklappt wird, sodass keines seiner untergeordneten Elemente mehr angezeigt wird.

Siehe auch „ QTreeWidgetItem::isExpanded()“, „ itemExpanded()“ und „ collapseItem()“.

[signal] void QTreeWidget::itemDoubleClicked(QTreeWidgetItem *item, int column)

Dieses Signal wird ausgelöst, wenn der Benutzer innerhalb des Widgets einen Doppelklick ausführt.

Das angegebene „ item “ ist das Element, auf das geklickt wurde, oder „ nullptr “, wenn kein Element angeklickt wurde. „ column “ ist die Spalte des Elements, auf die geklickt wurde. Wenn kein Element doppelt angeklickt wurde, wird kein Signal ausgelöst.

[signal] void QTreeWidget::itemEntered(QTreeWidgetItem *item, int column)

Dieses Signal wird ausgelöst, wenn der Mauszeiger in einen „ item “ über dem angegebenen „ column “ eintritt. QTreeWidget Damit diese Funktion genutzt werden kann, muss die Mausverfolgung aktiviert sein.

[signal] void QTreeWidget::itemExpanded(QTreeWidgetItem *item)

Dieses Signal wird ausgelöst, wenn der angegebene „ item “ so erweitert wird, dass alle seine untergeordneten Elemente angezeigt werden.

Siehe auch „ QTreeWidgetItem::isExpanded()“, „ itemCollapsed()“ und „ expandItem()“.

QTreeWidgetItem *QTreeWidget::itemFromIndex(const QModelIndex &index) const

Gibt einen Zeiger auf den „ QTreeWidgetItem “ zurück, der dem angegebenen „ index “ zugeordnet ist.

Siehe auch ` indexFromItem()`.

[signal] void QTreeWidget::itemPressed(QTreeWidgetItem *item, int column)

Dieses Signal wird ausgelöst, wenn der Benutzer innerhalb des Widgets eine Maustaste drückt.

Die angegebene „ item “ ist das Element, auf das geklickt wurde, oder „ nullptr “, falls kein Element angeklickt wurde. Die „ column “ ist die Spalte des Elements, auf die geklickt wurde, oder -1, falls kein Element angeklickt wurde.

[signal] void QTreeWidget::itemSelectionChanged()

Dieses Signal wird ausgelöst, wenn sich die Auswahl im Baum-Widget ändert. Die aktuelle Auswahl kann mit ` selectedItems()` abgerufen werden.

QWidget *QTreeWidget::itemWidget(QTreeWidgetItem *item, int column) const

Gibt das Widget zurück, das in der durch ` item ` angegebenen Zelle und unter der angegebenen ` column` angezeigt wird.

Siehe auch setItemWidget() und removeItemWidget().

[virtual protected] QMimeData *QTreeWidget::mimeData(const QList<QTreeWidgetItem *> &items) const

Gibt ein Objekt zurück, das eine serialisierte Beschreibung der angegebenen ` items` enthält. Das zur Beschreibung der Elemente verwendete Format wird über die Funktion ` mimeTypes()` abgerufen.

Ist die Liste der Elemente leer, wird „ nullptr “ zurückgegeben und nicht eine serialisierte leere Liste.

[virtual protected] QStringList QTreeWidget::mimeTypes() const

Gibt eine Liste von MIME-Typen zurück, mit denen eine Liste von Tree-Widget-Elementen beschrieben werden kann.

Siehe auch ` mimeData()`.

void QTreeWidget::openPersistentEditor(QTreeWidgetItem *item, int column = 0)

Öffnet einen persistenten Editor für die Datei „ item “ im angegebenen Verzeichnis „ column “.

Siehe auch „ closePersistentEditor()“ und „ isPersistentEditorOpen()“.

void QTreeWidget::removeItemWidget(QTreeWidgetItem *item, int column)

Entfernt das Widget-Set unter der angegebenen Adresse item aus dem angegebenen Ordner column.

Siehe auch itemWidget() und setItemWidget().

[slot] void QTreeWidget::scrollToItem(const QTreeWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible)

Stellt sicher, dass die „ item “ sichtbar ist, und scrollt die Ansicht bei Bedarf mithilfe der angegebenen „ hint “.

Siehe auch „ currentItem()“, „ itemAt()“ und „ topLevelItem()“.

QList<QTreeWidgetItem *> QTreeWidget::selectedItems() const

Gibt eine Liste aller ausgewählten, nicht ausgeblendeten Elemente zurück.

Siehe auch „ itemSelectionChanged()“.

void QTreeWidget::setCurrentItem(QTreeWidgetItem *item)

Legt den aktuellen „ item “ im Baum-Widget fest.

Sofern der Auswahlmodus nicht „ NoSelection “ ist, wird das Element zusätzlich ausgewählt.

Siehe auch „ currentItem()“ und „ currentItemChanged()“.

void QTreeWidget::setCurrentItem(QTreeWidgetItem *item, int column)

Setzt die aktuelle „ item “ im Baum-Widget und die aktuelle Spalte auf „ column “.

Siehe auch currentItem().

void QTreeWidget::setCurrentItem(QTreeWidgetItem *item, int column, QItemSelectionModel::SelectionFlags command)

Setzt die aktuelle Spalte „ item “ im Baum-Widget und die aktuelle Spalte auf „ column “, wobei die angegebene Spalte „ command “ verwendet wird.

Siehe auch currentItem().

void QTreeWidget::setHeaderItem(QTreeWidgetItem *item)

Legt die Kopfzeilen item n für das Baum-Widget fest. Die Beschriftung für jede Spalte in der Kopfzeile wird durch die entsprechende Beschriftung im Element bereitgestellt.

Das Baum-Widget übernimmt die Eigentümerschaft des Elements.

Siehe auch „ headerItem()“ und „ setHeaderLabels()“.

void QTreeWidget::setHeaderLabel(const QString &label)

Genau wie unter setHeaderLabels(QStringList(label)).

void QTreeWidget::setHeaderLabels(const QStringList &labels)

Fügt für jedes Element in der Liste „ labels “ eine Spalte in der Kopfzeile hinzu und legt die Beschriftung für jede Spalte fest.

Beachten Sie, dass setHeaderLabels() vorhandene Spalten nicht entfernt.

Siehe auch ` setHeaderItem()` und ` setHeaderLabel()`.

void QTreeWidget::setItemWidget(QTreeWidgetItem *item, int column, QWidget *widget)

Legt fest, dass das angegebene widget in der Zelle angezeigt wird, die durch die angegebenen Werte item und column festgelegt ist.

Die Eigenschaft „ autoFillBackground “ des angegebenen „ widget “ muss auf „true“ gesetzt sein, andernfalls ist der Hintergrund des Widgets transparent, sodass sowohl die Modelldaten als auch das Element des Baum-Widgets sichtbar sind.

Diese Funktion sollte nur verwendet werden, um statische Inhalte anstelle eines Baum-Widget-Elements anzuzeigen. Wenn Sie benutzerdefinierte dynamische Inhalte anzeigen oder ein benutzerdefiniertes Editor-Widget implementieren möchten, verwenden Sie stattdessen „ QTreeView “ und leiten Sie „ QStyledItemDelegate “ als Unterklasse ab.

Diese Funktion kann nicht aufgerufen werden, bevor die Elementhierarchie eingerichtet wurde, d. h., das ` QTreeWidgetItem `, das ` widget ` enthält, muss der Ansicht hinzugefügt worden sein, bevor ` widget ` gesetzt wird.

Siehe auch „ itemWidget()“, „ removeItemWidget()“ und „Delegate-Klassen“.

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

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

int QTreeWidget::sortColumn() const

Gibt die Spalte zurück, nach der der Inhalt des Widgets sortiert wird.

Siehe auch „ sortItems()“.

void QTreeWidget::sortItems(int column, Qt::SortOrder order)

Sortiert die Elemente im Widget in der angegebenen „ order “ nach den Werten in der angegebenen „ column “.

Siehe auch sortColumn().

[virtual protected] Qt::DropActions QTreeWidget::supportedDropActions() const

Gibt die von dieser Ansicht unterstützten Drag-and-Drop-Aktionen zurück.

Siehe auch ` Qt::DropActions`, ` supportedDragActions` und ` dropMimeData()`.

QTreeWidgetItem *QTreeWidget::takeTopLevelItem(int index)

Entfernt das oberste Element unter der angegebenen index im Baum und gibt es zurück; andernfalls wird nullptr zurückgegeben;

Siehe auch insertTopLevelItem(), topLevelItem() und topLevelItemCount().

QTreeWidgetItem *QTreeWidget::topLevelItem(int index) const

Gibt das Element der obersten Ebene unter der angegebenen Adresse „ index “ zurück oder „ nullptr “, falls das Element nicht vorhanden ist.

Siehe auch topLevelItemCount() und insertTopLevelItem().

QRect QTreeWidget::visualItemRect(const QTreeWidgetItem *item) const

Gibt das Rechteck im Ansichtsbereich zurück, das das Element unter item einnimmt.

Siehe auch itemAt().