qt QColumnView详解

1、概述

QColumnView 是 Qt 框架中的一个类，它提供了一种基于列的视图布局，用于显示和管理一系列项目。与 QTreeView 或 QListView 不同，QColumnView 不是简单地以列表或树状结构显示项目，而是将它们组织成多个列，每列可以包含多个项目。这种布局方式非常适合于需要以网格形式展示数据的场景，如文件管理器中的图标视图或图像浏览器的缩略图视图。

QColumnView 通常与 QAbstractItemModel 或其子类（如 QStandardItemModel）一起使用，以提供数据模型。此外，QColumnView 还允许自定义委托（QStyledItemDelegate 或其子类）来绘制和编辑项目。

2、重要方法

QColumnView 提供了一系列方法来管理其列和项目的显示：

• setModel：设置用于提供数据的模型。
• model：返回当前设置的模型。
• setRootIndex：设置模型中要显示的根索引，通常用于在树状模型中显示特定的子树。
• rootIndex：返回当前设置的根索引。
• setResizeMode：设置列的自动调整大小模式，如固定宽度、根据内容调整等。
• setFlow：设置项目的流动方向，可以是水平或垂直。
• setGridSize：设置网格单元的大小，这会影响项目中图标或缩略图的大小。
• gridSize：返回当前网格单元的大小。
• setSpacing：设置列之间或项目之间的间距。
• spacing：返回当前间距。
• setColumnWidth：手动设置指定列的宽度。
• columnWidth：返回指定列的宽度。
• update：强制重新绘制视图。

3、常用信号

以下是QColumnView类中一些常用的信号及其简要介绍:

• void updatePreviewWidget(const QModelIndex &index):当需要更新预览区域时发出信号。

MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent)
{
   setWindowTitle("QColumnView Example");
   resize(800, 600);

   // 创建目录模型
   QDirModel *dirModel = new QDirModel;

   // 创建列视图
   QColumnView *columnView = new QColumnView;
   columnView->setModel(dirModel);

   // 设置预览小部件
   QListView *previewListView = new QListView;
   columnView->setPreviewWidget(previewListView);

   connect(columnView, &QColumnView::updatePreviewWidget, [previewListView, dirModel](const QModelIndex &index) {
       previewListView->setModel(dirModel);
       previewListView->setRootIndex(index);
   });

   // 布局管理
   QVBoxLayout *layout = new QVBoxLayout;
   layout->addWidget(columnView);
   QWidget *centralWidget = new QWidget;
   centralWidget->setLayout(layout);

   setCentralWidget(centralWidget);
}

觉得有帮助的话，打赏一下呗。。