1.tableView导出到excel
点击导出函数按钮、发送sendMessage信号(信号名称,对象,数据)
void HydroelectricPowerPluginImpl::exportTableViewSelectedRows(QTableView* tableView, QWidget* parent)
{if (!tableView || !tableView->model())return;QString fileName = QFileDialog::getSaveFileName(parent, "导出选中行为CSV", "", "CSV文件 (*.csv)");if (fileName.isEmpty())return;QFile file(fileName);if (!file.open(QIODevice::WriteOnly | QIODevice::Text))return;QTextStream out(&file);QAbstractItemModel* model = tableView->model();// 写表头QStringList headers;for (int col = 0; col < model->columnCount(); ++col) {headers << model->headerData(col, Qt::Horizontal).toString();}out << headers.join(",") << "\n";// 写选中行数据for (int row = 0; row < model->rowCount(); ++row) {QStringList rowData;for (int col = 0; col < model->columnCount(); ++col) {if (model->data(model->index(row, col)) != QVariant()) {rowData << model->data(model->index(row, col)).toString();}if (model->data(model->index(row, col), Qt::UserRole) != QVariant()) {rowData << F0(model->data(model->index(row, col), Qt::UserRole).toInt());}}out << rowData.join(",") << "\n";}file.close();
}
2.点击button导出tableview
bool Utils::Gui::ExportVisibleColumnsToCSV(QTableView* tableView, const QString& filename, bool delegate, std::function<QString(const QVariant&)> v2s)
{QAbstractItemModel* model = tableView->model();if (model == nullptr) {return false;}QFile file(filename);if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {return false;}QTextStream ts(&file);
#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)QTextCodec* codec = QTextCodec::codecForName("UTF-8");if (codec) {ts.setCodec(codec);} else {ts.setCodec(QTextCodec::codecForLocale());}ts.setGenerateByteOrderMark(true);
#elsets.setEncoding(QStringConverter::System);
#endifQHeaderView* header = tableView->horizontalHeader();QList<int> visibleCols;for (int col = 0; col < model->columnCount(); ++col) {if (delegate || (!header->isSectionHidden(col) && !IsColumnUsingCustomDelegate(tableView, col))) {visibleCols.append(col);}}// 按视觉顺序排序std::sort(visibleCols.begin(), visibleCols.end(), [header](int a, int b) {return header->visualIndex(a) < header->visualIndex(b);});QStringList headerList;for (int col : visibleCols) {headerList << EscapeCSV(model->headerData(col, Qt::Horizontal).toString());}ts << headerList.join(',') << '\n';// 写入数据行for (int row = 0; row < model->rowCount(); ++row) {QStringList rowData;for (int col : visibleCols) {QModelIndex index = model->index(row, col);auto&& v = model->data(index);rowData << EscapeCSV(v2s == nullptr ? v.toString() : v2s(index));}ts << rowData.join(',') << '\n';}file.close();return true;
}QString Utils::Gui::EscapeCSV(const QString& value)
{if (value.contains('"') || value.contains(',') || value.contains('\n') || value.contains('\r')) {QString escaped = value;escaped.replace("\"", "\"\"");return "\"" + escaped + "\"";}return value;
}
代码分析:
#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)QTextCodec* codec = QTextCodec::codecForName("UTF-8");if (codec) {ts.setCodec(codec);} else {ts.setCodec(QTextCodec::codecForLocale());}ts.setGenerateByteOrderMark(true);
#elsets.setEncoding(QStringConverter::System);
#endif详细解释
1. #if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
• 这部分代码只在 Qt 5 及以下版本编译时生效。
• Qt 5 及以下用 QTextCodec 设置编码。
代码含义:
• QTextCodec* codec = QTextCodec::codecForName("UTF-8");
尝试获取 UTF-8 编码的 QTextCodec。
• if (codec) { ts.setCodec(codec); }
如果获取成功,设置 QTextStream 使用 UTF-8 编码。
• else { ts.setCodec(QTextCodec::codecForLocale()); }
如果失败,则使用系统默认编码。
• ts.setGenerateByteOrderMark(true);
让输出流在文件开头写入 UTF-8 的 BOM(字节顺序标记),有些软件(如 Excel)读取 CSV 时需要 BOM 才能正确识别为 UTF-8。
2. #else
• 这部分代码只在 Qt 6 及以上版本编译时生效。
• Qt 6 移除了 QTextCodec,改用 QStringConverter。
代码含义:
• ts.setEncoding(QStringConverter::System);
设置 QTextStream 使用系统默认编码(通常是 UTF-8)。总结
• 目的:保证导出的 CSV 文件编码为 UTF-8,兼容不同 Qt 版本。
• “坑”提示:如果编码设置不对,中文等非 ASCII 字符在 Excel 等软件中可能会乱码。简要记忆:
Qt 5 用 QTextCodec,Qt 6 用 QStringConverter,都为了让文件编码正确。
// 按视觉顺序排序std::sort(visibleCols.begin(), visibleCols.end(), [header](int a, int b) {return header->visualIndex(a) < header->visualIndex(b);});这行代码的作用是:按照表头的视觉顺序对 visibleCols 进行排序。
详细解释
• visibleCols 是一个存储可见列索引(int)的列表。
• header 是 QTableView 的水平表头(QHeaderView*)。
• header->visualIndex(a) 返回列 a 在界面上显示的位置(比如用户拖动列顺序后,物理列索引和视觉顺序可能不同)。
• std::sort(..., [header](int a, int b) { ... })
使用 lambda 表达式自定义排序规则:如果 a 的视觉索引小于 b,则 a 排在前面。
举例说明
假设表格有 4 列,物理顺序是 0,1,2,3,但用户把第2列拖到最前面,视觉顺序变成 2,0,1,3。
此时 header->visualIndex(2) 返回 0,header->visualIndex(0) 返回 1,依此类推。
排序后,visibleCols 就会按照用户看到的顺序排列,而不是物理顺序。常见“坑”提示:
如果你直接用物理顺序导出数据,用户看到的列顺序和导出的顺序可能不一致。用这段代码可以保证导出顺序和界面一致,体验更好