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
Vererbt: QAbstractItemView

Eigenschaften

Öffentliche Funktionen

QColumnView(QWidget *parent = nullptr)
virtual ~QColumnView()
QList<int> columnWidths() const
QWidget *previewWidget() const
bool resizeGripsVisible() const
void setColumnWidths(const QList<int> &list)
void setPreviewWidget(QWidget *widget)
void setResizeGripsVisible(bool visible)

Reimplementierte ö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

Reimplementierte 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

Detaillierte Beschreibung

QColumnView zeigt ein Modell in einer Reihe von QListViews an, eine für jede Hierarchie im Baum. Dies wird manchmal als eine 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 die Anzeige von Daten zu ermöglichen, die von Modellen bereitgestellt werden, die von der Klasse QAbstractItemModel abgeleitet sind.

Siehe auch Model/View Programmierung.

Dokumentation der Eigenschaften

resizeGripsVisible : bool

Mit dieser Eigenschaft kann festgelegt werden, ob die Listenansichten Griffe zur Größenänderung erhalten oder nicht

Standardmäßig ist visible auf true gesetzt.

Zugriffsfunktionen:

bool resizeGripsVisible() const
void setResizeGripsVisible(bool visible)

Siehe auch setRootIndex().

Dokumentation der Mitgliedsfunktionen

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

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

Siehe auch QAbstractItemModel.

[virtual noexcept] QColumnView::~QColumnView()

Zerstört die Spaltenansicht.

QList<int> QColumnView::columnWidths() const

Gibt eine Liste der Breite aller Spalten in dieser Ansicht zurück.

Siehe auch setColumnWidths().

[virtual protected] QAbstractItemView *QColumnView::createColumn(const QModelIndex &index)

Um ein benutzerdefiniertes Widget für die letzte Spalte zu verwenden, wenn Sie ein Element auswählen, überladen 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 den Besitz des Widgets.

Siehe auch setPreviewWidget().

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

Reimplements: QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous).

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

Reimplements: QAbstractItemView::horizontalOffset() const.

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

Reimplements: 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 column wie iconSize(), textElideMode() und alternatingRowColors() an. Dies kann bei der Neuimplementierung von createColumn() nützlich sein.

Siehe auch createColumn().

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

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

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

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

Nach links bewegen sollte zum Elternindex gehen Nach rechts bewegen sollte zum Kindindex gehen oder nach unten, wenn es kein Kind gibt

QWidget *QColumnView::previewWidget() const

Gibt das Vorschau-Widget zurück, oder nullptr, wenn es keines gibt.

Siehe auch setPreviewWidget() und updatePreviewWidget().

[override virtual protected] void QColumnView::resizeEvent(QResizeEvent *event)

Reimplements: QAbstractItemView::resizeEvent(QResizeEvent *event).

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

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

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

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

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

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

[override virtual] void QColumnView::selectAll()

Reimplements: QAbstractItemView::selectAll().

void QColumnView::setColumnWidths(const QList<int> &list)

Setzt die Spaltenbreiten auf die in list angegebenen Werte. Zusätzliche Werte in der Liste werden beibehalten und bei der Erstellung der Spalten verwendet.

Wenn die Liste zu wenige Werte enthält, wird nur die Breite der restlichen Spalten nicht geändert.

Siehe auch columnWidths() und createColumn().

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

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

void QColumnView::setPreviewWidget(QWidget *widget)

Legt die Vorschau widget fest.

widget wird ein untergeordnetes Element der Spaltenansicht und wird zerstört, wenn der Spaltenbereich gelöscht wird oder ein neues Widget gesetzt wird.

Siehe auch previewWidget() und updatePreviewWidget().

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

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

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

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

[override virtual] void QColumnView::setSelectionModel(QItemSelectionModel *newSelectionModel)

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

[override virtual] QSize QColumnView::sizeHint() const

Reimplements: QAbstractScrollArea::sizeHint() const.

[signal] void QColumnView::updatePreviewWidget(const QModelIndex &index)

Dieses Signal wird ausgegeben, wenn das Vorschau-Widget aktualisiert werden soll, um umfassende Informationen über index

Siehe auch previewWidget().

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

Reimplements: QAbstractItemView::verticalOffset() const.

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

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

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

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

© 2025 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.