QColumnView类

QColumnView类提供了一列视图的模型/视图实现。 更多...

头文件 #include <QColumnView>
CMakefind_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmakeQT += widgets
继承 QAbstractItemView

属性

公开函数

QColumnView(QWidget *parent = nullptr)
virtual~QColumnView()
QList<int>columnWidths() const
QWidget *previewWidget() const
boolresizeGripsVisible() const
voidsetColumnWidths(const QList<int> &list)
voidsetPreviewWidget(QWidget *widget)
voidsetResizeGripsVisible(bool visible)

重新实现公开函数

virtual QModelIndexindexAt(const QPoint &point) const override
virtual voidscrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible) override
virtual voidselectAll() override
virtual voidsetModel(QAbstractItemModel *model) override
virtual voidsetRootIndex(const QModelIndex &index) override
virtual voidsetSelectionModel(QItemSelectionModel *newSelectionModel) override
virtual QSizesizeHint() const override
virtual QRectvisualRect(const QModelIndex &index) const override

信号

voidupdatePreviewWidget(const QModelIndex &index)

保护函数

virtual QAbstractItemView *createColumn(const QModelIndex &index)
voidinitializeColumn(QAbstractItemView *column) const

重新实现保护函数

virtual voidcurrentChanged(const QModelIndex &current, const QModelIndex &previous) override
virtual inthorizontalOffset() const override
virtual boolisIndexHidden(const QModelIndex &index) const override
virtual QModelIndexmoveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override
virtual voidresizeEvent(QResizeEvent *event) override
virtual voidrowsInserted(const QModelIndex &parent, int start, int end) override
virtual voidscrollContentsBy(int dx, int dy) override
virtual voidsetSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command) override
virtual intverticalOffset() const override
虚拟 QRegionvisualRegionForSelection(const QItemSelection &selection) const override

详细说明

QColumnView 在多个 QListViews 中显示一个模型,每个树层次一个。这有时被称为级联列表。

QColumnView 类是 模型/视图类 之一,是 Qt 的 模型/视图框架 的一部分。

QColumnView 实现了 QAbstractItemView 类定义的接口,以便它能够显示由从 QAbstractItemModel 类派生的模型提供的数据。

另请参阅模型/视图编程

属性说明

resizeGripsVisible : bool

此属性表示是否在列表视图中获取调整大小的手柄

默认情况下,可见 设置为 true

访问函数

boolresizeGripsVisible() const
voidsetResizeGripsVisible(bool visible)

另请参阅setRootIndex

成员函数说明

[显式] QColumnView::QColumnView(QWidget *parent = nullptr)

构建一个列视图,具有 父对象 来表示模型的用户数据。使用 setModel() 来设置模型。

另请参阅QAbstractItemModel

[虚拟 noexcept] QColumnView::~QColumnView()

销毁列视图。

QList<int> QColumnView::columnWidths() const

返回该视图中所有列宽度的列表。

另请参阅setColumnWidths

[虚拟受保护] QAbstractItemView *QColumnView::createColumn(const QModelIndex &index)

当您在选择一个项目时,为使用用于最终列的自定义小部件而重载此函数并返回一个小部件,overload this function and return a widget. index 是将要分配给视图的根索引。

返回新视图。 QColumnView 将自动获得小部件的所有权。

另请参阅setPreviewWidget

[压倒虚拟受保护] void QColumnView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

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

[重写虚保护] int QColumnView::horizontalOffset() const

重新实现: QAbstractItemView::horizontalOffset() const

[重写虚保护] QModelIndex QColumnView::indexAt(const QPoint &point) const

重新实现:QAbstractItemView::indexAt(const QPoint &point) const

[保护] void QColumnView::initializeColumn(QAbstractItemView *column) const

复制列视图的行为和选项,并将其应用到如 column 且包括 iconSize()、textElideMode() 和 alternatingRowColors 等属性。这在重新实现 createColumn() 时可能很有用。

另请参阅createColumn

[重写虚保护] bool QColumnView::isIndexHidden(const QModelIndex &index) const

重新实现:QAbstractItemView::isIndexHidden(const QModelIndex &index) const

[重写虚保护] QModelIndex QColumnView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

重新实现:QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)。

向左应移动到父索引,向右应移动到子索引或向下如果不存在子索引

QWidget *QColumnView::previewWidget() const

返回预览小部件,如果没有则返回 nullptr

另请参阅setPreviewWidget() 和 updatePreviewWidget

[重写虚保护] void QColumnView::resizeEvent(QResizeEvent *event)

重新实现:QAbstractItemView::resizeEvent(QResizeEvent *event)。

[重写虚保护] void QColumnView::rowsInserted(const QModelIndex &parent, int start, int end)

重新实现:QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end)。

[重写虚保护] void QColumnView::scrollContentsBy(int dx, int dy)

重新实现:QAbstractScrollArea::scrollContentsBy(int dx, int dy)。

[重写虚函数] void QColumnView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

重实现: QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint).

[重写虚函数] void QColumnView::selectAll()

重实现: QAbstractItemView::selectAll().

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

将列宽度设置为列表中给出的值。列表中的额外值将被保留并在创建列时使用。

如果列表中的值太少,则不会修改其余列的宽度。

另请参阅columnWidths() 和 createColumn().

[重写虚函数] void QColumnView::setModel(QAbstractItemModel *model)

重实现: QAbstractItemView::setModel(QAbstractItemModel *model).

void QColumnView::setPreviewWidget(QWidget *widget)

设置预览 小工具

小工具 成为列视图的子对象,在列区域被删除或设置新小工具时将被销毁。

另请参阅previewWidget() 和 updatePreviewWidget().

[重写虚函数] void QColumnView::setRootIndex(const QModelIndex &index)

重实现: QAbstractItemView::setRootIndex(const QModelIndex &index).

[重写虚函数] void QColumnView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command)

重实现: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

[重写虚函数] void QColumnView::setSelectionModel(QItemSelectionModel *newSelectionModel)

重实现: QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).

[重写虚函数] QSize QColumnView::sizeHint() const

重实现: QAbstractScrollArea::sizeHint() const.

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

当需要更新预览小工具以提供关于 索引 的丰富信息时,将发出此信号。

另见 previewWidget().

[重写 虚拟 受保护] int QColumnView::verticalOffset() const

重实现: QAbstractItemView::verticalOffset() const.

[重写 虚拟] QRect QColumnView::visualRect(const QModelIndex &index) const

重实现: QAbstractItemView::visualRect(const QModelIndex &index) const.

[重写 虚拟 受保护] QRegion QColumnView::visualRegionForSelection(const QItemSelection &selection) const

重实现: QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const.

© 2024 Qt公司有限公司。本文件中包含的文档贡献的版权为各自所有者的版权。本文件中提供的文档是根据自由软件基金会发布的、GNU自由文档许可(版本1.3)的条款所许可的。Qt及其相关标志是芬兰的Qt公司及其在世界各地的子公司和分支机构的商标。所有其他商标均为其各自所有者的财产。