QColumnView Class
Die Klasse „QColumnView“ bietet eine Model-View-Implementierung einer Spaltenansicht. Mehr...
| Kopfzeile: | #include <QColumnView> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QAbstractItemView |
Eigenschaften
(since 6.11)previewColumnVisible : bool- resizeGripsVisible : bool
Öffentliche Funktionen
| QColumnView(QWidget *parent = nullptr) | |
| virtual | ~QColumnView() |
| QList<int> | columnWidths() const |
| bool | isPreviewColumnVisible() const |
| QWidget * | previewWidget() const |
| bool | resizeGripsVisible() const |
| void | setColumnWidths(const QList<int> &list) |
| void | setPreviewColumnVisible(bool visible) |
| void | setPreviewWidget(QWidget *widget) |
| void | setResizeGripsVisible(bool visible) |
Neu implementierte öffentliche Funktionen
| virtual QModelIndex | indexAt(const QPoint &point) const 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 *newSelectionModel) override |
| virtual QSize | sizeHint() const override |
| virtual QRect | visualRect(const QModelIndex &index) const override |
Signale
| void | updatePreviewWidget(const QModelIndex &index) |
Geschützte Funktionen
| virtual QAbstractItemView * | createColumn(const QModelIndex &index) |
| void | initializeColumn(QAbstractItemView *column) const |
Neu implementierte geschützte Funktionen
| virtual void | currentChanged(const QModelIndex ¤t, const QModelIndex &previous) override |
| virtual int | horizontalOffset() const override |
| virtual bool | isIndexHidden(const QModelIndex &index) const override |
| virtual QModelIndex | moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override |
| virtual void | resizeEvent(QResizeEvent *event) override |
| virtual void | rowsInserted(const QModelIndex &parent, int start, int end) override |
| virtual void | scrollContentsBy(int dx, int dy) override |
| virtual void | setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command) override |
| virtual int | verticalOffset() const override |
| virtual QRegion | visualRegionForSelection(const QItemSelection &selection) const override |
Ausführliche Beschreibung
QColumnView zeigt ein Modell in mehreren QListViews an, jeweils eine für jede Hierarchieebene im Baum. Dies wird manchmal als kaskadierende Liste bezeichnet.
Die Klasse `QColumnView` gehört zu den Model/View-Klassen und ist Teil des Model/View-Frameworks von Qt.
QColumnView implementiert die von der Klasse „ QAbstractItemView “ definierten Schnittstellen, um Daten anzeigen zu können, die von Modellen bereitgestellt werden, die von der Klasse „ QAbstractItemModel “ abgeleitet sind.

Siehe auch Modell-View-Programmierung.
Dokumentation zu den Eigenschaften
[since 6.11] previewColumnVisible : bool
Diese Eigenschaft legt fest, ob die Vorschauspalte sichtbar ist
Standardmäßig ist „ visible “ auf „true“ gesetzt
Diese Aufzählung wurde in Qt 6.11 eingeführt.
Zugriffsfunktionen:
| bool | isPreviewColumnVisible() const |
| void | setPreviewColumnVisible(bool visible) |
resizeGripsVisible : bool
Diese Eigenschaft legt fest, ob die Listenansichten Größenänderungsgriffe erhalten sollen oder nicht
Standardmäßig ist „ visible “ auf „true“ gesetzt
Zugriffsfunktionen:
| bool | resizeGripsVisible() const |
| void | setResizeGripsVisible(bool visible) |
Siehe auch „ setRootIndex()“.
Dokumentation zu den Member-Funktionen
[explicit] QColumnView::QColumnView(QWidget *parent = nullptr)
Erstellt eine Spaltenansicht mit einem „ parent “, um die Daten eines Modells darzustellen. Verwenden Sie „ setModel()“, um das Modell festzulegen.
Siehe auch ` QAbstractItemModel`.
[virtual noexcept] QColumnView::~QColumnView()
Löscht die Spaltenansicht.
QList<int> QColumnView::columnWidths() const
Gibt eine Liste mit den Breiten aller Spalten in dieser Ansicht zurück.
Siehe auch ` setColumnWidths()`.
[virtual protected] QAbstractItemView *QColumnView::createColumn(const QModelIndex &index)
Um bei der Auswahl eines Elements ein benutzerdefiniertes Widget für die letzte Spalte zu verwenden, überschreiben Sie diese Funktion und geben Sie ein Widget zurück. ` index ` ist der Stammindex, der der Ansicht zugewiesen wird.
Geben Sie die neue Ansicht zurück. „ QColumnView “ übernimmt automatisch die Verantwortung für das Widget.
Siehe auch setPreviewWidget().
[override virtual protected] void QColumnView::currentChanged(const QModelIndex ¤t, const QModelIndex &previous)
Implementiert: ` QAbstractItemView::currentChanged` (`const QModelIndex ¤t, const QModelIndex &previous`).
[override virtual protected] int QColumnView::horizontalOffset() const
Implementiert: ` QAbstractItemView::horizontalOffset()` const.
[override virtual] QModelIndex QColumnView::indexAt(const QPoint &point) const
Implementiert neu: ` QAbstractItemView::indexAt(const QPoint &point) const`.
[protected] void QColumnView::initializeColumn(QAbstractItemView *column) const
Kopiert das Verhalten und die Optionen der Spaltenansicht und wendet sie auf die „ column “ an, wie beispielsweise die Methoden „ iconSize()“, „ textElideMode()“ und „ alternatingRowColors()“. Dies kann bei der Neuimplementierung von „ createColumn()“ nützlich sein.
Siehe auch createColumn().
[override virtual protected] bool QColumnView::isIndexHidden(const QModelIndex &index) const
Implementiert: ` QAbstractItemView::isIndexHidden(const QModelIndex &index) const`.
[override virtual protected] QModelIndex QColumnView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)
Umsetzt: ` QAbstractItemView::moveCursor` (`QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers`).
„Nach links“ sollte zum übergeordneten Index springen, „Nach rechts“ sollte zum untergeordneten Index springen oder nach unten, wenn kein untergeordnetes Element vorhanden ist.
QWidget *QColumnView::previewWidget() const
Gibt das Vorschau-Widget zurück oder „ nullptr “, falls keines vorhanden ist.
Siehe auch „ setPreviewWidget()“ und „ updatePreviewWidget()“.
[override virtual protected] void QColumnView::resizeEvent(QResizeEvent *event)
Implementiert: ` QAbstractItemView::resizeEvent(QResizeEvent *event)`.
[override virtual protected] void QColumnView::rowsInserted(const QModelIndex &parent, int start, int end)
Implementiert: QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end).
[override virtual protected] void QColumnView::scrollContentsBy(int dx, int dy)
Implementiert: ` QAbstractScrollArea::scrollContentsBy(int dx, int dy)`.
[override virtual] void QColumnView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)
Umsetzt: ` QAbstractItemView::scrollTo` (const QModelIndex &index, QAbstractItemView::ScrollHint hint).
[override virtual] void QColumnView::selectAll()
Implementiert: QAbstractItemView::selectAll().
void QColumnView::setColumnWidths(const QList<int> &list)
Legt die Spaltenbreiten auf die in der Liste „ list “ angegebenen Werte fest. Zusätzliche Werte in der Liste werden beibehalten und beim Erstellen der Spalten verwendet.
Enthält die Liste zu wenige Werte, wird lediglich die Breite der übrigen Spalten nicht geändert.
Siehe auch ` columnWidths()` und ` createColumn()`.
[override virtual] void QColumnView::setModel(QAbstractItemModel *model)
Implementiert: QAbstractItemView::setModel(QAbstractItemModel *model).
void QColumnView::setPreviewWidget(QWidget *widget)
Legt das Vorschau- widget fest.
Das Widget „ widget “ wird zu einem untergeordneten Element der Spaltenansicht und wird zerstört, wenn der Spaltenbereich gelöscht oder ein neues Widget festgelegt wird.
Siehe auch ` previewWidget()` und ` updatePreviewWidget()`.
[override virtual] void QColumnView::setRootIndex(const QModelIndex &index)
Implementiert: ` QAbstractItemView::setRootIndex(const QModelIndex &index)`.
[override virtual protected] void QColumnView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command)
Implementiert: ` QAbstractItemView::setSelection` (const QRect &rect, QItemSelectionModel::SelectionFlags flags).
[override virtual] void QColumnView::setSelectionModel(QItemSelectionModel *newSelectionModel)
Implementiert: QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).
[override virtual] QSize QColumnView::sizeHint() const
Implementiert: ` QAbstractScrollArea::sizeHint()` const.
[signal] void QColumnView::updatePreviewWidget(const QModelIndex &index)
Dieses Signal wird ausgelöst, wenn das Vorschau-Widget aktualisiert werden soll, um detaillierte Informationen über index
Siehe auch previewWidget().
[override virtual protected] int QColumnView::verticalOffset() const
Implementiert: ` QAbstractItemView::verticalOffset()` const.
[override virtual] QRect QColumnView::visualRect(const QModelIndex &index) const
Implementiert neu: ` QAbstractItemView::visualRect(const QModelIndex &index) const`.
[override virtual protected] QRegion QColumnView::visualRegionForSelection(const QItemSelection &selection) const
Implementiert neu: ` QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const`.
© 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.