东莞外贸建站及推广1元涨1000粉
1. QTableView 基础介绍
QTableView 是 Qt 中用于显示表格数据的控件，属于模型/视图架构的一部分。它提供了灵活的方式来展示和编辑二维表格数据。
主要特点：
-
基于模型/视图架构
-
支持大型数据集
-
提供排序、筛选功能
-
可自定义单元格显示和编辑方式
-
支持表头自定义
2. 基本使用
2.1 简单示例
#include <QApplication>
#include <QTableView>
#include <QStandardItemModel>int main(int argc, char *argv[]) {QApplication app(argc, argv);// 创建数据模型QStandardItemModel model(4, 3); // 4行3列// 填充数据for (int row = 0; row < 4; ++row) {for (int col = 0; col < 3; ++col) {QStandardItem *item = new QStandardItem(QString("行%1 列%2").arg(row+1).arg(col+1));model.setItem(row, col, item);}}// 设置表头model.setHorizontalHeaderLabels({"列1", "列2", "列3"});model.setVerticalHeaderLabels({"行1", "行2", "行3", "行4"});// 创建并设置TableViewQTableView tableView;tableView.setModel(&model);tableView.setWindowTitle("简单表格示例");tableView.resize(500, 300);tableView.show();return app.exec();
}2.2 常用方法
// 设置选择模式
tableView.setSelectionMode(QAbstractItemView::SingleSelection); // 单选
tableView.setSelectionMode(QAbstractItemView::MultiSelection); // 多选// 设置选择行为
tableView.setSelectionBehavior(QAbstractItemView::SelectRows); // 整行选择
tableView.setSelectionBehavior(QAbstractItemView::SelectItems); // 单个单元格选择// 设置网格线
tableView.setShowGrid(true); // 显示网格线
tableView.setGridStyle(Qt::DotLine); // 点线网格// 设置表头
tableView.horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch); // 自动拉伸
tableView.verticalHeader()->setDefaultSectionSize(30); // 设置默认行高// 排序功能
tableView.setSortingEnabled(true); // 启用排序3. 数据模型使用
3.1 使用 QStandardItemModel
QStandardItemModel *model = new QStandardItemModel(5, 3, this);// 填充数据
for (int row = 0; row < 5; ++row) {for (int col = 0; col < 3; ++col) {QStandardItem *item = new QStandardItem(QString("数据 %1-%2").arg(row).arg(col));// 设置文本颜色if (col == 1) {item->setForeground(QBrush(Qt::blue));}// 设置背景色if (row % 2 == 0) {item->setBackground(QBrush(QColor(240, 240, 240)));}// 设置文本对齐item->setTextAlignment(Qt::AlignCenter);model->setItem(row, col, item);}
}// 设置表头
model->setHorizontalHeaderLabels({"姓名", "年龄", "职业"});
ui->tableView->setModel(model);3.2 使用自定义模型
继承 QAbstractTableModel 创建自定义表格模型：
class CustomTableModel : public QAbstractTableModel {Q_OBJECTpublic:explicit CustomTableModel(QObject *parent = nullptr);// 必须重写的方法int rowCount(const QModelIndex &parent = QModelIndex()) const override;int columnCount(const QModelIndex &parent = QModelIndex()) const override;QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;QVariant headerData(int section, Qt::Orientation orientation, int role) const override;// 可选重写的方法bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override;Qt::ItemFlags flags(const QModelIndex &index) const override;// 自定义方法void addData(const QList<QStringList> &newData);private:QList<QStringList> m_data;
};// 实现示例
int CustomTableModel::rowCount(const QModelIndex &parent) const {return parent.isValid() ? 0 : m_data.size();
}int CustomTableModel::columnCount(const QModelIndex &parent) const {return parent.isValid() ? 0 : (m_data.isEmpty() ? 0 : m_data.first().size());
}QVariant CustomTableModel::data(const QModelIndex &index, int role) const {if (!index.isValid() || index.row() >= m_data.size() || index.column() >= m_data.first().size())return QVariant();switch (role) {case Qt::DisplayRole:case Qt::EditRole:return m_data[index.row()][index.column()];case Qt::TextAlignmentRole:return Qt::AlignCenter;case Qt::BackgroundRole:return index.row() % 2 == 0 ? QColor(240, 240, 240) : QColor(255, 255, 255);default:return QVariant();}
}4. 表格定制化
4.1 使用委托自定义单元格
class CustomDelegate : public QStyledItemDelegate {
public:using QStyledItemDelegate::QStyledItemDelegate;void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override {if (index.column() == 1) { // 特殊处理第二列painter->save();// 绘制背景if (option.state & QStyle::State_Selected) {painter->fillRect(option.rect, option.palette.highlight());} else {painter->fillRect(option.rect, QColor("#f8f8f8"));}// 绘制文本painter->setPen(option.state & QStyle::State_Selected ? option.palette.highlightedText().color() : Qt::darkBlue);painter->drawText(option.rect.adjusted(5, 0, -5, 0), Qt::AlignVCenter | Qt::AlignRight, index.data().toString());painter->restore();} else {QStyledItemDelegate::paint(painter, option, index);}}QSize sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const override {QSize size = QStyledItemDelegate::sizeHint(option, index);size.setHeight(35); // 固定行高return size;}
};// 使用委托
ui->tableView->setItemDelegate(new CustomDelegate(this));4.2 表头定制
// 设置表头样式
QHeaderView *header = ui->tableView->horizontalHeader();
header->setDefaultAlignment(Qt::AlignCenter);
header->setSectionResizeMode(QHeaderView::Interactive);
header->setStretchLastSection(true);
header->setSectionsClickable(true);// 自定义表头
class CustomHeader : public QHeaderView {// 实现自定义绘制等
};// 设置自定义表头
ui->tableView->setHorizontalHeader(new CustomHeader(Qt::Horizontal, ui->tableView));5. 交互功能实现
5.1 选择操作
// 获取选中单元格
QModelIndexList selected = ui->tableView->selectionModel()->selectedIndexes();// 获取选中行
QModelIndexList selectedRows;
foreach (const QModelIndex &index, ui->tableView->selectionModel()->selectedIndexes()) {if (!selectedRows.contains(index.row()))selectedRows << index.row();
}// 获取选中数据
foreach (const QModelIndex &index, selected) {qDebug() << "选中的数据:" << index.data().toString()<< "行:" << index.row() << "列:" << index.column();
}5.2 排序和筛选
// 使用代理模型实现排序和筛选
QSortFilterProxyModel *proxyModel = new QSortFilterProxyModel(this);
proxyModel->setSourceModel(sourceModel);
ui->tableView->setModel(proxyModel);// 设置筛选
proxyModel->setFilterKeyColumn(0); // 根据第一列筛选
proxyModel->setFilterRegExp(QRegExp("搜索文本", Qt::CaseInsensitive));// 动态排序
connect(ui->tableView->horizontalHeader(), &QHeaderView::sectionClicked, [proxyModel](int logicalIndex) {proxyModel->sort(logicalIndex);
});6. 高级功能
6.1 合并单元格
// 需要继承QTableView并重写paintEvent
void CustomTableView::paintEvent(QPaintEvent *event) {QTableView::paintEvent(event);QPainter painter(viewport());painter.setPen(Qt::red);// 合并第1行第1列到第3行第2列QRect rect1 = visualRect(model()->index(1, 1));QRect rect2 = visualRect(model()->index(3, 2));QRect mergedRect = rect1.united(rect2);painter.drawRect(mergedRect.adjusted(0, 0, -1, -1));painter.drawText(mergedRect, Qt::AlignCenter, "合并区域");
}6.2 拖放功能
// 启用拖放
ui->tableView->setDragEnabled(true);
ui->tableView->setAcceptDrops(true);
ui->tableView->setDropIndicatorShown(true);
ui->tableView->setDragDropMode(QAbstractItemView::InternalMove);// 在模型中实现拖放相关方法
Qt::DropActions CustomModel::supportedDropActions() const {return Qt::CopyAction | Qt::MoveAction;
}// 实现mimeData()和dropMimeData()方法7. 性能优化
-
大数据集处理：
// 使用fetchMore/canFetchMore实现懒加载 // 设置 uniformRowHeights 提高性能 ui->tableView->setUniformRowHeights(true); -
减少不必要的刷新：
-
优化委托：避免在委托中进行复杂计算
-
使用模型测试：
new QAbstractItemModelTester(model, QAbstractItemModelTester::FailureReportingMode::Warning, this);