QColumnView类
QColumnView类提供了一列视图的模型/视图实现。 更多...
| 头文件 | #include <QColumnView> | 
| CMake | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) | 
| qmake | QT += widgets | 
| 继承 | QAbstractItemView | 
属性
- resizeGripsVisible : bool
公开函数
| 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) | 
重新实现公开函数
| 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 | 
信号
| void | updatePreviewWidget(const QModelIndex &index) | 
保护函数
| virtual QAbstractItemView * | createColumn(const QModelIndex &index) | 
| void | initializeColumn(QAbstractItemView *column) const | 
重新实现保护函数
| 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 | 
| 虚拟 QRegion | visualRegionForSelection(const QItemSelection &selection) const override | 
详细说明
QColumnView 在多个 QListViews 中显示一个模型,每个树层次一个。这有时被称为级联列表。
QColumnView 类是 模型/视图类 之一,是 Qt 的 模型/视图框架 的一部分。
QColumnView 实现了 QAbstractItemView 类定义的接口,以便它能够显示由从 QAbstractItemModel 类派生的模型提供的数据。

另请参阅模型/视图编程。
属性说明
resizeGripsVisible : bool
此属性表示是否在列表视图中获取调整大小的手柄
默认情况下,可见 设置为 true
访问函数
| bool | resizeGripsVisible() const | 
| void | setResizeGripsVisible(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 ¤t, const QModelIndex &previous)
重写: QAbstractItemView::currentChanged(const QModelIndex ¤t, 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公司及其在世界各地的子公司和分支机构的商标。所有其他商标均为其各自所有者的财产。