QtC++与QColumnView详解
介绍
在 Qt 中，QColumnView 是用于显示多列数据的控件，它提供了一种多列列表视图的方式，类似于文件资源管理器中的详细视图。QColumnView 是基于模型/视图架构的，通常与 QFileSystemModel 或自定义模型一起使用。
以下是关于 QColumnView 的详细讲解：
QColumnView 的作用：
-
多列显示：
QColumnView允许你在一个视图中同时显示多列数据，每一列可以使用不同的数据模型，以更灵活地组织和展示信息。 -
模型/视图架构： 基于 Qt 的模型/视图架构，可以使用不同的数据模型来提供数据，例如
QStandardItemModel、QFileSystemModel或自定义的模型。 -
树形结构： 支持显示树形结构的数据，每一列都可以表示树的一个层级，使得显示层次化数据非常方便。
-
定制化视图： 允许通过委托 (
QAbstractItemDelegate) 定制每一列的外观和交互效果，以满足特定的显示需求。 -
多列选择： 提供了多列选择的功能，用户可以选择一列或多列数据进行操作。
-
数据筛选： 支持通过过滤器对数据进行筛选，以显示特定条件下的数据。
QColumnView 常用方法和信号：
以下是一些常用的方法和信号，可用于控制和响应 QColumnView 的行为：
-
setModel(QAbstractItemModel *model): 设置与QColumnView关联的数据模型。 -
setSelectionModel(QItemSelectionModel *selectionModel): 设置选择模型，控制选择的行为。 -
setColumnWidths(const QList<int> &list): 设置每一列的宽度，通过传递一个QList包含每一列的宽度值。 -
setCurrentIndex(const QModelIndex &index): 设置当前选择的索引，用于定位显示的数据。 -
resizeColumnToContents(int column): 调整指定列的宽度以适应内容。 -
setRootIndex(const QModelIndex &index): 设置根索引，用于显示指定的树形结构。 -
clicked(const QModelIndex &index): 单击某个单元格时触发的信号。 -
doubleClicked(const QModelIndex &index): 双击某个单元格时触发的信号。
示例应用场景：
-
文件资源管理器：
QColumnView可以用于实现类似 Windows 资源管理器的文件浏览功能，每一列代表一个文件夹，展示文件夹内的内容。 -
项目管理工具： 在项目管理工具中，
QColumnView可以用于按照不同的项目属性组织和显示项目信息。 -
图形化配置界面： 用于创建图形化配置界面，用户可以通过多列选择方式配置软件参数和选项。
-
树形数据的展示：
QColumnView适用于展示树形数据，每一列代表树的一个层级。 -
多列数据的比对： 在需要比对多列数据的场景中，
QColumnView提供了一种直观的方式。
注意事项：
-
使用
QColumnView时，通常需要一个合适的数据模型，例如QStandardItemModel、QFileSystemModel或者自定义的模型类。 -
对于复杂的单元格外观和交互需求，可以通过自定义委托或者子类化
QColumnView来实现。 -
当列数较多或数据量较大时，注意性能问题，可以考虑使用虚拟滚动等技术进行优化。
结论：
QColumnView 提供了一种方便的方式来显示多列数据，适用于需要同时展示多个层级结构或树形结构的场景。通过灵活使用模型/视图架构和定制化视图的功能，开发者可以轻松实现各种多列数据的显示需求。
示例
```cpp
#include <QApplication>
#include <QColumnView>
#include <QStandardItemModel>
#include <QStandardItem>
#include <QFileSystemModel>
#include <QDebug>
int main(int argc, char *argv[]) {
QApplication app(argc, argv);
// 示例1: 创建简单的 QColumnView
QColumnView simpleColumnView;
QStandardItemModel simpleModel;
// 添加数据
QList<QStandardItem*> rootItems;
rootItems << new QStandardItem("Category 1") << new QStandardItem("Category 2") << new QStandardItem("Category 3");
simpleModel.appendColumn(rootItems);
QList<QStandardItem*> category1Items;
category1Items << new QStandardItem("Item 1.1") << new QStandardItem("Item 1.2") << new QStandardItem("Item 1.3");
rootItems[0]->appendColumn(category1Items);
QList<QStandardItem*> category2Items;
category2Items << new QStandardItem("Item 2.1") << new QStandardItem("Item 2.2") << new QStandardItem("Item 2.3");
rootItems[1]->appendColumn(category2Items);
QList<QStandardItem*> category3Items;
category3Items << new QStandardItem("Item 3.1") << new QStandardItem("Item 3.2") << new QStandardItem("Item 3.3");
rootItems[2]->appendColumn(category3Items);
simpleColumnView.setModel(&simpleModel);
simpleColumnView.show();
// 示例2: 使用 QFileSystemModel 显示文件系统
QColumnView fileSystemColumnView;
QFileSystemModel fileSystemModel;
fileSystemModel.setRootPath(QDir::rootPath());
fileSystemColumnView.setModel(&fileSystemModel);
fileSystemColumnView.show();
// 示例3: 自定义数据模型
QColumnView customModelColumnView;
QStandardItemModel customModel;
QList<QStandardItem*> customRootItems;
customRootItems << new QStandardItem("Custom Category 1") << new QStandardItem("Custom Category 2");
customModel.appendColumn(customRootItems);
QList<QStandardItem*> customCategory1Items;
customCategory1Items << new QStandardItem("Custom Item 1.1") << new QStandardItem("Custom Item 1.2");
customRootItems[0]->appendColumn(customCategory1Items);
QList<QStandardItem*> customCategory2Items;
customCategory2Items << new QStandardItem("Custom Item 2.1") << new QStandardItem("Custom Item 2.2");
customRootItems[1]->appendColumn(customCategory2Items);
customModelColumnView.setModel(&customModel);
customModelColumnView.show();
// 示例4: 自定义委托定制外观和交互
QColumnView customDelegateColumnView;
QStandardItemModel delegateModel;
QList<QStandardItem*> delegateRootItems;
delegateRootItems << new QStandardItem("Delegate Category 1") << new QStandardItem("Delegate Category 2");
delegateModel.appendColumn(delegateRootItems);
QList<QStandardItem*> delegateCategory1Items;
delegateCategory1Items << new QStandardItem("Delegate Item 1.1") << new QStandardItem("Delegate Item 1.2");
delegateRootItems[0]->appendColumn(delegateCategory1Items);
QList<QStandardItem*> delegateCategory2Items;
delegateCategory2Items << new QStandardItem("Delegate Item 2.1") << new QStandardItem("Delegate Item 2.2");
delegateRootItems[1]->appendColumn(delegateCategory2Items);
// 自定义委托，用于设置特定列的外观和交互
class CustomDelegate : public QAbstractItemDelegate {
public:
QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const override {
Q_UNUSED(option);
if (index.column() == 0) {
QLineEdit *editor = new QLineEdit(parent);
return editor;
}
return nullptr;
}
void setEditorData(QWidget *editor, const QModelIndex &index) const override {
if (index.column() == 0) {
QLineEdit *lineEdit = qobject_cast<QLineEdit*>(editor);
if (lineEdit) {
lineEdit->setText(index.data(Qt::DisplayRole).toString());
}
}
}
void setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const override {
if (index.column() == 0) {
QLineEdit *lineEdit = qobject_cast<QLineEdit*>(editor);
if (lineEdit) {
model->setData(index, lineEdit->text(), Qt::EditRole);
}
}
}
void updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const override {
Q_UNUSED(index);
editor->setGeometry(option.rect);
}
};
customDelegateColumnView.setItemDelegate(new CustomDelegate);
customDelegateColumnView.setModel(&delegateModel);
customDelegateColumnView.show();
return app.exec();
}