本文主要是介绍【Qt笔记】QListView控件详解，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
目录
引言
一、QListView 基本概念
1.1 定义与功能
1.2 架构原理
二、QListView 基本使用
2.1 创建 QListView 和 Model
2.2 设置 QListView 的属性
2.3 处理用户交互
三、QListView 高级技巧
3.1 自定义委托
3.2 使用 QStandardItemModel
3.3 实现拖放功能
四、QListView 与其他 Qt 控件的对比
4.1 与 QListWidget 的对比
4.2 与 QTableView 的对比
五、整体代码示例
注意
结语
引言
QListView 是 Qt 框架中一个功能强大的控件，用于展示列表数据。它基于模型/视图/委托（Model/View/Delegate）架构，提供了灵活的数据展示和处理能力。以下是对 QListView 控件的详细解析，内容涵盖其基本概念、基本使用、高级技巧以及与其他 Qt 控件的对比等方面。
一、QListView 基本概念
1.1 定义与功能
QListView 是 Qt 中的一个视图类，专门用于展示列表数据。它支持多种视图模式，包括列表视图（List View）和图标视图（Icon View），允许开发者根据需求选择合适的展示方式。QListView 通过与数据模型（如 QStringListModel、QStandardItemModel）配合使用，实现了数据与视图的分离，提高了应用程序的灵活性和可维护性。
1.2 架构原理
QListView 遵循模型/视图/委托（MVC）架构，其中：
- Model：数据模型，负责管理数据的存储和操作。
- View：视图，负责展示数据。在 QListView 中，视图负责根据模型提供的数据进行渲染。
- Delegate：委托，负责绘制视图中的每一项内容以及处理编辑操作。QListView 允许通过自定义委托来改变项的外观和交互方式。
二、QListView 基本使用
2.1 创建 QListView 和 Model
要使用 QListView，首先需要创建一个 QListView 控件和一个数据模型。数据模型可以是 Qt 提供的标准模型（如 QStringListModel、QStandardItemModel），也可以是自定义的模型。以下是一个简单的示例代码，展示了如何创建 QListView 和 QStringListModel 并将其关联起来：
#include <QApplication>
#include <QListView>
#include <QStringListModel> int main(int argc, char *argv[]) { QApplication app(argc, argv); QListView listView; QStringListModel model; QStringList data = {"Item 1", "Item 2", "Item 3"}; model.setStringList(data); listView.setModel(&model); listView.show(); return app.exec();
}实现效果：
2.2 设置 QListView 的属性
QListView 提供了多种属性设置，用于控制其外观和行为。
以下是为QListView设置一些常用属性的代码示例。请注意，这些示例假设您已经有一个QListView的实例（比如名为listView）以及相应的模型和数据已经设置好了。
- setSelectionMode(QAbstractItemView::SelectionMode mode)：设置选择模式，如单选（SingleSelection）、多选（MultiSelection）等。
// 设置选择模式为单选
listView.setSelectionMode(QAbstractItemView::SingleSelection); // 或者设置为多选
// listView.setSelectionMode(QAbstractItemView::MultiSelection); // 或者设置为扩展选择（连续多选）
// listView.setSelectionMode(QAbstractItemView::ExtendedSelection); // 或者设置为无选择（通常不常用，但可用于某些特殊场景）
// listView.setSelectionMode(QAbstractItemView::NoSelection);- setEditTriggers(QAbstractItemView::EditTriggers triggers)：设置编辑触发器，如双击编辑（DoubleClicked）等。
// 设置双击项时触发编辑
listView.setEditTriggers(QAbstractItemView::DoubleClicked); // 也可以组合多个触发器，但通常对于QListView来说，只设置双击就足够了
// 例如，同时设置双击和选中时编辑（但通常不推荐这样设置，因为对于列表来说，选中时编辑可能不太直观）
// listView.setEditTriggers(QAbstractItemView::DoubleClicked | QAbstractItemView::SelectedClicked); // 注意：对于QListView来说，SelectedClicked可能不是很有用，因为它更适用于表格或树形视图- setViewMode(QListView::ViewMode mode)：设置视图模式，如列表模式（ListMode）、图标模式（IconMode）等。
// 设置视图模式为列表模式（这是QListView的默认模式）
listView.setViewMode(QListView::ListMode); // 注意：QListView只支持ListMode，而不支持IconMode。IconMode是QListView的父类QAbstractItemView的一个枚举值，
// 但QListView并没有实现它。如果你需要图标模式，可能需要考虑使用QListView的兄弟类QIconView（但请注意，QIconView在Qt的某些版本中可能不是标准的一部分，
// 或者你可能需要使用QListView的替代品，如QListView配合自定义委托来模拟图标模式）。 // 由于QListView不支持IconMode，以下代码是无效的，仅作为说明：
// listView.setViewMode(QListView::IconMode); // 这将不会编译或运行时不会按预期工作- setSpacing(int space)：设置项之间的间距。
//设置间距为10
_listView->setSpacing(10);2.3 处理用户交互
QListView 支持多种用户交互方式，如点击、双击、拖拽等。开发者可以通过连接信号和槽来处理这些交互。例如，可以连接clicked信号来处理项被点击的事件：
QObject::connect(&listView, &QListView::clicked, [](const QModelIndex &index) { qDebug() << "Item clicked:" << index.data().toString();
});三、QListView 高级技巧
3.1 自定义委托
QListView 允许通过自定义委托来改变项的外观和交互方式。自定义委托需要继承自 QStyledItemDelegate 或其他委托基类，并重写相关方法。以下是一个自定义委托的示例，用于改变项的背景颜色：
class CustomDelegate : public QStyledItemDelegate {
public: void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override { painter->save(); painter->setBrush(QColor(Qt::yellow)); painter->drawRect(option.rect); painter->restore(); QStyledItemDelegate::paint(painter, option, index); }
}; // 使用自定义委托
CustomDelegate *delegate = new CustomDelegate;
listView.setItemDelegate(delegate);3.2 使用 QStandardItemModel
QStandardItemModel 是一个功能强大的模型，支持复杂的数据结构。与 QStringListModel 相比，QStandardItemModel 允许创建具有任意层次结构的数据模型，并为每一项设置更多的属性。以下是如何使用 QStandardItemModel 的示例：
QStandardItemModel model;
QStandardItem *item1 = new QStandardItem("Item 1");
QStandardItem *item2 = new QStandardItem("Item 2");
model.appendRow(item1);
model.appendRow(item2);
listView.setModel(&model);3.3 实现拖放功能
QListView 支持拖放操作，可以通过设置视图的属性来启用拖放功能，并实现自定义的拖放逻辑。以下是如何启用拖放功能的示例：
listView.setDragEnabled(true);
listView.setAcceptDrops(true);
listView.setDropIndicatorShown(true);
listView.setDefaultDropAction(Qt::MoveAction);四、QListView 与其他 Qt 控件的对比
4.1 与 QListWidget 的对比
- QListWidget 是基于项的控件，它内部已经包含了默认的模型，使用起来相对简单，但灵活性较低。
- QListView 则是基于模型/视图/委托架构的控件，需要与数据模型配合使用，提供了更高的灵活性和可定制性。
4.2 与 QTableView 的对比
- QTableView 用于展示表格数据，支持行和列的显示。
- QListView 则专注于列表数据的展示，不支持列的概念。
五、整体代码示例
下面是一个包含高级功能的QListView控件的整体代码示例。这个示例将展示如何设置模型、委托（用于自定义项的显示）、选择模式、拖放功能以及如何使用样式表来美化视图。
请注意，由于QListView本身不直接支持图标模式（除了通过自定义委托模拟外），这个示例将专注于列表模式，但会展示如何通过委托来自定义项的显示。
#include <QApplication>
#include <QListView>
#include <QStringListModel>
#include <QStyledItemDelegate>
#include <QPainter>
#include <QDrag>
#include <QMimeData> // 自定义委托
class MyItemDelegate : public QStyledItemDelegate {
public: MyItemDelegate(QObject *parent = nullptr) : QStyledItemDelegate(parent) {} void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override { QStyleOptionViewItem opt = option; initStyleOption(&opt, index); // 在这里可以自定义绘制逻辑 // 例如，我们可以添加一个图标 QIcon icon(":/path/to/your/icon.png"); // 确保替换为有效的图标路径 QRect iconRect(opt.rect.left() + 5, opt.rect.top() + (opt.rect.height() - icon.actualSize(QSize(32, 32)).height()) / 2, icon.actualSize(QSize(32, 32)).width(), icon.actualSize(QSize(32, 32)).height()); icon.paint(painter, iconRect); // 绘制文本 painter->save(); painter->setPen(opt.palette.text().color()); QRect textRect = opt.rect.adjusted(iconRect.width() + 10, 0, 0, 0); painter->drawText(textRect, Qt::AlignLeft | Qt::AlignVCenter, index.data().toString()); painter->restore(); } // 如果需要处理编辑或其他交互，可以重写其他方法
}; // 拖放支持
class MyListView : public QListView { Q_OBJECT
public: MyListView(QWidget *parent = nullptr) : QListView(parent) { setDragEnabled(true); setAcceptDrops(true); setDefaultDropAction(Qt::MoveAction); setSelectionMode(QAbstractItemView::ExtendedSelection); // 设置自定义委托 setItemDelegate(new MyItemDelegate(this)); } protected: void mouseMoveEvent(QMouseEvent *event) override { if (event->buttons() != Qt::LeftButton) return; QDrag *drag = new QDrag(this); QMimeData *mimeData = new QMimeData; // 假设我们拖放的是项的索引 QList<QModelIndex> indexes = selectedIndexes(); QByteArray encodedData; QDataStream stream(&encodedData, QIODevice::WriteOnly); foreach (const QModelIndex &index, indexes) { stream << index.row(); } mimeData->setData("application/vnd.myapp.itemlist", encodedData); drag->setMimeData(mimeData); // 可以设置拖动时的图标和光标等 QPixmap pixmap(":/path/to/drag_icon.png"); // 确保替换为有效的图标路径 if (!pixmap.isNull()) drag->setPixmap(pixmap); if (drag->exec(Qt::MoveAction) == Qt::MoveAction) { // 处理移动后的逻辑（如果需要的话） } } // 实现dropEvent等方法来处理放置操作（这里省略）
}; int main(int argc, char *argv[]) { QApplication app(argc, argv); QStringList data = {"Item 1", "Item 2", "Item 3", "Item 4", "Item 5"}; QStringListModel model(data); MyListView listView; listView.setModel(&model); listView.show(); return app.exec();
} #include "main.moc" // 如果你使用的是qmake，并且自定义了QWidget子类，则需要这一行来包含moc生成的元对象代码注意
1. 自定义委托：MyItemDelegate 类重写了 paint 方法来在项旁边绘制一个图标，并调整了文本的绘制位置。
2. 拖放支持：MyListView 类继承自 QListView 并启用了拖放功能。在 mouseMoveEvent 中，我们创建了一个 QDrag 对象，并使用 QMimeData 来存储要拖动的数据（在这个例子中是选中项的索引）。你可以根据需要修改这部分代码来存储更复杂的数据。
3. 图标和样式：在示例中，我使用了 ":/path/to/your/icon.png" 和 ":/path/to/drag_icon.png" 作为图标路径。你需要将这些路径替换为实际有效的资源路径。Qt 资源系统允许你将文件嵌入到应用程序的可执行文件中，这样你就不必担心文件路径问题了。
4. 样式表：虽然示例中没有直接使用样式表，但你可以通过调用 listView.setStyleSheet(...) 来应用 CSS 样式表，以美化 QListView 的外观。
5. 编译和运行：确保你的 Qt 环境已经设置正确，并且你有一个有效的 Qt 项目文件（如 .pro 文件）来编译和运行这个示例。如果你使用的是 Qt Creator，它通常会为你处理这些设置。
结语
QListView 是 Qt 框架中一个功能强大的控件，用于展示列表数据。它基于模型/视图/委托架构，提供了灵活的数据展示和处理能力。通过自定义委托和使用不同的数据模型，QListView 可以满足各种复杂的数据展示需求。同时，QListView 还支持拖放操作等高级功能，进一步提升了其在实际应用中的价值。
以上就是关于Qt中QListView的全部介绍，如有不足与缺陷之处，欢迎评论区留言！！！
这篇关于【Qt笔记】QListView控件详解的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
