QtC++与QListView详解

介绍

在 Qt 中，QListView 是一个用于显示项目列表的控件，通常与数据模型一起使用。它是 Qt 框架中的标准视图控件之一，用于创建具有项目的可滚动列表视图。以下是关于 QListView 的详细讲解和其作用：

QListView 的作用：

1. 项目列表显示： QListView 主要用于在用户界面中显示项目列表，这些项目可以是文本、图像或自定义的数据项。

2. 数据模型支持： 通常，QListView 与数据模型（例如 QAbstractItemModel 的子类）一起使用，以提供项目数据和管理。数据模型负责提供项目的数据，而 QListView 用于显示和交互。

3. 选择和交互： 用户可以与项目进行交互，选择项目并执行相应的操作。QListView 支持单选和多选模式，使用户可以选择一个或多个项目。

4. 自定义视图： QListView 允许开发人员自定义项目的外观和布局。您可以使用自定义委托来实现个性化的项目视图，包括项目文本、图标、背景颜色等。

5. 布局选项： 您可以根据需要设置 QListView 的布局选项，包括排列方向（垂直或水平）、图标大小、网格视图等。

6. 排序和过滤： QListView 允许对项目进行排序和过滤，以提供更好的用户体验。用户可以根据需要重新排列项目。

7. 拖放操作： QListView 支持拖放操作，允许用户拖动项目并将其放置在其他位置，实现项目的重新排列或数据交换。

8. 快捷键支持： 用户可以使用键盘快捷键进行导航和选择，提高了可访问性。

常用方法和信号：

以下是一些常用的 QListView 方法和相关信号：

• setModel(QAbstractItemModel *model): 设置与 QListView 关联的数据模型。
• setSelectionMode(QAbstractItemView::SelectionMode mode): 设置选择模式，可以是单选、多选或无选择。
• setViewMode(QListView::ViewMode mode): 设置视图的布局模式，如图标模式、列表模式、网格模式等。
• setUniformItemSizes(bool enable): 如果启用，所有项目将具有相同的大小。
• setIconSize(QSize size): 设置图标的大小。
• setItemDelegate(QAbstractItemDelegate *delegate): 设置自定义委托以自定义项目的外观。
• doubleClicked(const QModelIndex &index): 双击项目时触发的信号，可用于处理双击事件。

示例应用：

QListView 可以用于各种应用，包括但不限于：

• 文件浏览器：用于显示文件和文件夹列表。
• 任务列表：用于显示待办事项或任务列表。
• 图像浏览器：用于显示图像缩略图和浏览图片集。
• 数据浏览：用于显示数据库查询结果或其他数据集。

QListView 提供了强大的功能，以满足不同应用程序的需求，并且可以根据需要进行定制。希望这个详细讲解有助于您更好地理解 QListView 的作用和用法。

示例

#include <QApplication>
#include <QListView>
#include <QStringListModel>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    // 示例1: 创建基本的 QListView
    QListView basicListView;
    QStringListModel basicModel;
    QStringList basicList;
    basicList << "Item 1" << "Item 2" << "Item 3";
    basicModel.setStringList(basicList);
    basicListView.setModel(&basicModel);
    basicListView.show();

    // 示例2: 创建带选择模式的 QListView
    QListView selectionListView;
    QStringListModel selectionModel;
    QStringList selectionList;
    selectionList << "Option A" << "Option B" << "Option C" << "Option D";
    selectionModel.setStringList(selectionList);
    selectionListView.setModel(&selectionModel);
    selectionListView.setSelectionMode(QAbstractItemView::MultiSelection); // 多选模式
    selectionListView.show();

    return app.exec();
}

#include <QApplication>
#include <QListView>
#include <QStringListModel>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    // 示例3: 创建水平列表
    QListView horizontalListView;
    QStringListModel horizontalModel;
    QStringList horizontalList;
    horizontalList << "Apple" << "Banana" << "Cherry" << "Date";
    horizontalModel.setStringList(horizontalList);
    horizontalListView.setModel(&horizontalModel);
    horizontalListView.setFlow(QListView::LeftToRight);
    horizontalListView.show();

    // 示例4: 使用自定义委托
    QListView customDelegateListView;
    QStringListModel customDelegateModel;
    QStringList customDelegateList;
    customDelegateList << "Red" << "Green" << "Blue" << "Yellow";
    customDelegateModel.setStringList(customDelegateList);
    customDelegateListView.setModel(&customDelegateModel);
    customDelegateListView.setItemDelegate(new QStyledItemDelegate); // 使用默认委托
    customDelegateListView.show();

    // 示例5: 排序和过滤
    QListView sortAndFilterListView;
    QStringListModel sortAndFilterModel;
    QStringList sortAndFilterList;
    sortAndFilterList << "Cat" << "Dog" << "Elephant" << "Horse";
    sortAndFilterModel.setStringList(sortAndFilterList);
    sortAndFilterListView.setModel(&sortAndFilterModel);
    sortAndFilterListView.setSortingEnabled(true);
    sortAndFilterListView.show();

    return app.exec();
}

#include <QApplication>
#include <QListView>
#include <QStringListModel>
#include <QSortFilterProxyModel>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    // 示例6: 拖放操作
    QListView dragDropListView;
    QStringListModel dragDropModel;
    QStringList dragDropList;
    dragDropList << "Item 1" << "Item 2" << "Item 3" << "Item 4";
    dragDropModel.setStringList(dragDropList);
    dragDropListView.setModel(&dragDropModel);
    dragDropListView.setDragEnabled(true);
    dragDropListView.setAcceptDrops(true);
    dragDropListView.setDropIndicatorShown(true);
    dragDropListView.show();

    // 示例7: 使用排序和过滤代理模型
    QListView proxyListView;
    QStringListModel proxyModel;
    QStringList proxyList;
    proxyList << "Apple" << "Banana" << "Cherry" << "Date";
    proxyModel.setStringList(proxyList);

    QSortFilterProxyModel proxy;
    proxy.setSourceModel(&proxyModel);
    proxy.setFilterCaseSensitivity(Qt::CaseInsensitive);
    proxy.setFilterWildcard("B*"); // 仅显示以 "B" 开头的项目
    proxyListView.setModel(&proxy);
    proxyListView.show();

    return app.exec();
}

#include <QApplication>
#include <QListView>
#include <QStringListModel>
#include <QStandardItemModel>
#include <QStandardItem>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    // 示例8: 使用 QStandardItemModel
    QListView standardItemListView;
    QStandardItemModel standardItemModel;
    QStandardItem *item1 = new QStandardItem("Item 1");
    QStandardItem *item2 = new QStandardItem("Item 2");
    QStandardItem *item3 = new QStandardItem("Item 3");
    standardItemModel.appendRow(item1);
    standardItemModel.appendRow(item2);
    standardItemModel.appendRow(item3);
    standardItemListView.setModel(&standardItemModel);
    standardItemListView.show();

    // 示例9: 使用图标和文本
    QListView iconTextListView;
    QStringListModel iconTextModel;
    QStringList iconTextList;
    iconTextList << "File" << "Folder" << "Document" << "Image";
    iconTextModel.setStringList(iconTextList);
    iconTextListView.setModel(&iconTextModel);
    iconTextListView.setViewMode(QListView::IconMode);
    iconTextListView.setIconSize(QSize(64, 64)); // 设置图标大小
    iconTextListView.show();

    // 示例10: 响应双击事件
    QListView doubleClickListView;
    QStringListModel doubleClickModel;
    QStringList doubleClickList;
    doubleClickList << "Option 1" << "Option 2" << "Option 3";
    doubleClickModel.setStringList(doubleClickList);
    doubleClickListView.setModel(&doubleClickModel);
    QObject::connect(&doubleClickListView, &QListView::doubleClicked, [&doubleClickListView](const QModelIndex &index) {
        // 处理双击事件
        qDebug() << "双击了：" << index.data().toString();
    });
    doubleClickListView.show();

    return app.exec();
}