QVariantList 是 Qt 框架中的一个类，用于存储和操作 QVariant 对象的列表。 QVariant 是 Qt 中用于封装各种类型的通用容器类，可以存储基本类型（如 int、 double、 QString 等）以及复杂类型（如 QList、 QMap 等）。 QVariantList 实际上是 QList<QVariant> 的别名，因此你可以像使用 QList 一样使用它。

1. 基本概念

• QVariant: 一个可以存储多种数据类型的通用容器。
• QVariantList: 一个 QVariant 对象的列表，实际上是 QList<QVariant> 的别名。

2. 使用场景

QVariantList 通常用于需要存储和传递多种类型数据的场景，例如：

• 在模型/视图架构中传递数据。
• 在信号和槽之间传递复杂的数据结构。
• 存储配置项或动态数据。

3. 基本操作

3.1 创建和初始化

#include <QVariant>
#include <QVariantList>
#include <QDebug>

int main() {
    // 创建一个空的 QVariantList
    QVariantList list;

    // 添加不同类型的元素
    list.append(10);              // int
    list.append(3.14);            // double
    list.append("Hello, Qt!");    // QString
    list.append(true);            // bool

    // 输出列表内容
    for (const QVariant &item : list) {
        qDebug() << item;
    }

    return 0;
}

3.2 访问元素

#include <QVariant>
#include <QVariantList>
#include <QDebug>

int main() {
    QVariantList list;
    list.append(10);
    list.append(3.14);
    list.append("Hello, Qt!");
    list.append(true);

    // 访问元素
    int intValue = list.at(0).toInt();          // 转换为 int
    double doubleValue = list.at(1).toDouble(); // 转换为 double
    QString stringValue = list.at(2).toString(); // 转换为 QString
    bool boolValue = list.at(3).toBool();       // 转换为 bool

    qDebug() << "intValue:" << intValue;
    qDebug() << "doubleValue:" << doubleValue;
    qDebug() << "stringValue:" << stringValue;
    qDebug() << "boolValue:" << boolValue;

    return 0;
}

3.3 修改元素

#include <QVariant>
#include <QVariantList>
#include <QDebug>

int main() {
    QVariantList list;
    list.append(10);
    list.append(3.14);
    list.append("Hello, Qt!");
    list.append(true);

    // 修改元素
    list[0] = 20;                  // 修改第一个元素
    list[2] = QString("Hello, World!"); // 修改第三个元素

    // 输出修改后的列表
    for (const QVariant &item : list) {
        qDebug() << item;
    }

    return 0;
}

3.4 删除元素

#include <QVariant>
#include <QVariantList>
#include <QDebug>

int main() {
    QVariantList list;
    list.append(10);
    list.append(3.14);
    list.append("Hello, Qt!");
    list.append(true);

    // 删除第二个元素
    list.removeAt(1);

    // 输出删除后的列表
    for (const QVariant &item : list) {
        qDebug() << item;
    }

    return 0;
}

4. 实际应用示例

假设你有一个函数需要返回多个不同类型的值，可以使用 QVariantList 来封装这些值。

#include <QVariant>
#include <QVariantList>
#include <QDebug>

QVariantList getMultipleValues() {
    QVariantList result;
    result.append(42);
    result.append(3.14159);
    result.append("Qt is awesome!");
    result.append(true);
    return result;
}

int main() {
    QVariantList values = getMultipleValues();

    // 处理返回的多个值
    int intValue = values.at(0).toInt();
    double doubleValue = values.at(1).toDouble();
    QString stringValue = values.at(2).toString();
    bool boolValue = values.at(3).toBool();

    qDebug() << "intValue:" << intValue;
    qDebug() << "doubleValue:" << doubleValue;
    qDebug() << "stringValue:" << stringValue;
    qDebug() << "boolValue:" << boolValue;

    return 0;
}

5. 总结

QVariantList 是 Qt 中非常灵活的一个容器类，适用于需要存储和操作多种类型数据的场景。通过 QVariant 的封装，你可以轻松地在列表中存储不同类型的数据，并在需要时进行类型转换。在实际开发中，QVariantList 常用于信号和槽之间的数据传递、模型/视图架构中的数据存储等场景。

希望这个详细的解释和示例代码能帮助你更好地理解和使用 QVariantList。

其他QT文章推荐

1. QT开发环境安装以配置。
2. QT线段画板实战
3. 半小时玩转QT桌面系统托盘(含托盘消息)
4. QT入门开发一个时钟
5. 半小时教你做大转盘游戏（QT篇）
6. 手把手教你制作【带吸附效果的线段绘制】（QT）
7. 手把手教你开发-滚动效果号码抽奖（QT）
8. 100行代码实现贪吃蛇小游戏
9.C++实现《扫雷》游戏（入门经典）
10. svg转图片工具开发
11. Qt网路与通信(获取本机网络信息）
12. Qt网路与通信(UDP客户与服务）
13. Qt网络与通信（TCP聊天室）
14. Qt多线程以及线程池
15. Qt散点图、折线图、柱状图、盒须图、饼状图、雷达图开发实例
16. 取色器（QT）
17. MQTT客户端入门开发
18.QT文件上传带进度条实例（含源码）
19. Qt音乐播放器开发实例（可毕设含源码）