Auf dieser Seite

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

Ö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 &current, 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.

Adressdaten in einer Spaltenansicht

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 &current, const QModelIndex &previous)

Implementiert: ` QAbstractItemView::currentChanged` (`const QModelIndex &current, 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.