Qt中集成C++模型时ListView显示为空问题排查

嘿，我一眼就发现了导致ListView为空的核心问题——你的ToDoModel::rowCount函数逻辑写反了！咱们一步步来修复，顺便把模型的其他不完善的地方也补上：

1. 修复rowCount函数（解决空列表问题） #

先看你原来的rowCount代码：

int ToDoModel::rowCount(const QModelIndex &parent) const {
    if (!parent.isValid()) return 0;
    // FIXME: Implement me!
    return 100;
}

在Qt的列表模型中，当父索引无效时（也就是ListView直接绑定这个模型的场景），我们需要返回列表的总条目数。但你现在的逻辑是：只要父索引无效就返回0，这等于告诉ListView“我这里没有数据”，自然就显示空列表了。

把逻辑反转过来：

int ToDoModel::rowCount(const QModelIndex &parent) const {
    // 列表模型中，只有父索引有效时才返回0（表示没有子项）
    if (parent.isValid()) return 0;
    return 100;
}

修改完这一步，你再运行程序，ListView就能显示出100条测试条目了。不过这只是第一步，现在的模型还没法真正保存修改的数据，咱们继续完善。

2. 添加数据存储，完善交互逻辑 #

目前你的模型只是硬返回固定值，修改复选框或文本框后，数据不会被真正保存。我们需要给模型添加一个存储结构：

第一步：在头文件中定义数据结构 #

打开todomodel.h，在private区域添加存储用的结构体和容器：

private:
    // 定义每条待办项的结构
    struct ToDoItem {
        bool done;
        QString description;
    };
    // 存储所有待办项的容器
    QVector<ToDoItem> m_items;

第二步：初始化测试数据 #

修改todomodel.cpp的构造函数，初始化100条测试数据：

ToDoModel::ToDoModel(QObject *parent) : QAbstractListModel(parent) {
    // 初始化100条带序号的测试数据
    for (int i = 0; i < 100; ++i) {
        m_items.append({false, QStringLiteral("Test %1").arg(i + 1)});
    }
}

第三步：更新data函数，从容器取数据 #

把原来硬返回固定值的data函数改成从容器中获取对应索引的数据：

QVariant ToDoModel::data(const QModelIndex &index, int role) const {
    // 先判断索引是否合法
    if (!index.isValid() || index.row() >= m_items.size()) {
        return QVariant();
    }

    const ToDoItem &item = m_items[index.row()];
    switch(role) {
    case DoneRole:
        return item.done;
    case DescriptionRole:
        return item.description;
    default:
        return QVariant();
    }
}

第四步：完善setData函数，真正修改数据 #

原来的setData只是空发信号，现在改成真正修改容器里的数据：

bool ToDoModel::setData(const QModelIndex &index, const QVariant &value, int role) {
    if (!index.isValid() || index.row() >= m_items.size()) {
        return false;
    }

    ToDoItem &item = m_items[index.row()];
    bool dataChanged = false;

    switch(role) {
    case DoneRole:
        if (item.done != value.toBool()) {
            item.done = value.toBool();
            dataChanged = true;
        }
        break;
    case DescriptionRole:
        if (item.description != value.toString()) {
            item.description = value.toString();
            dataChanged = true;
        }
        break;
    default:
        return false;
    }

    if (dataChanged) {
        emit dataChanged(index, index, QVector<int>() << role);
        return true;
    }
    return false;
}

第五步：更新rowCount用容器大小 #

把固定的100改成容器的大小，这样以后动态增删数据也更灵活：

int ToDoModel::rowCount(const QModelIndex &parent) const {
    if (parent.isValid()) return 0;
    return m_items.size();
}

3. 完善条目交互权限 #

最后，你的flags函数返回的权限不够，需要加上Qt::ItemIsSelectable和Qt::ItemIsEnabled，这样条目才能正常响应交互：

Qt::ItemFlags ToDoModel::flags(const QModelIndex &index) const {
    if (!index.isValid()) return Qt::NoItemFlags;
    return Qt::ItemIsEditable | Qt::ItemIsSelectable | Qt::ItemIsEnabled;
}

做完这些修改后，你的ListView不仅能正常显示100条条目，复选框和文本框的修改也会真正保存到模型中，交互完全正常啦！

内容的提问来源于stack exchange，提问作者Anushiya