在Qt的众多界面组件中，QTableWidget凭借其灵活的二维数据展示与编辑能力，成为开发桌面应用时的常用控件。它继承自QTableView，将数据模型与视图紧密结合，无需额外定义模型即可快速实现表格功能，极大降低了开发门槛。本文将从基础配置入手，带您快速掌握QTableWidget的核心使用技巧。
一、QTableWidget基础配置
1. 行列数与表头设置
创建QTableWidget时，可通过构造函数直接指定行列数，也可后续调用setRowCount()和setColumnCount()动态调整。表头作为表格的“导航栏”，清晰的表头能大幅提升用户体验。使用setHorizontalHeaderLabels()和setVerticalHeaderLabels()方法，可分别设置水平表头与垂直表头的内容。例如：
// 创建一个3行2列的表格
QTableWidget *tableWidget = new QTableWidget(3, 2, this);
// 设置水平表头
QStringList horizontalHeaders;
horizontalHeaders << "姓名" << "年龄";
tableWidget->setHorizontalHeaderLabels(horizontalHeaders);
// 设置垂直表头
QStringList verticalHeaders;
verticalHeaders << "行1" << "行2" << "行3";
tableWidget->setVerticalHeaderLabels(verticalHeaders);
若不需要显示垂直表头的行号，可调用verticalHeader()->setHidden(true)将其隐藏，让界面更加简洁。
2. 单元格内容填充
表格的核心是数据展示，QTableWidget通过QTableWidgetItem对象管理每个单元格的内容。创建QTableWidgetItem实例并设置文本后，调用setItem()方法将其添加到指定行列位置。例如：
// 向0行0列添加内容
QTableWidgetItem *nameItem = new QTableWidgetItem("张三");
tableWidget->setItem(0, 0, nameItem);
// 向0行1列添加内容
QTableWidgetItem *ageItem = new QTableWidgetItem("25");
tableWidget->setItem(0, 1, ageItem);
需要注意的是，QTableWidgetItem支持丰富的属性设置，如字体颜色、背景色、对齐方式等，可通过setTextColor()、setBackgroundColor()、setTextAlignment()等方法定制单元格样式，满足不同的视觉需求。
二、交互与编辑控制
1. 编辑权限设置
默认情况下，QTableWidget的单元格处于可编辑状态，用户双击即可修改内容。若需设置表格为只读模式，可通过setEditTriggers()方法调整编辑触发策略：
// 设置表格为只读，禁止任何编辑操作
tableWidget->setEditTriggers(QAbstractItemView::NoEditTriggers);
除了完全禁止编辑，还可根据需求选择其他触发方式，如双击编辑、单击编辑等，具体可参考QAbstractItemView::EditTrigger枚举值。
2. 选择行为配置
QTableWidget支持多种选择模式，通过setSelectionBehavior()方法可设置选择单元格、整行或整列：
// 设置选择行为为选择整行
tableWidget->setSelectionBehavior(QAbstractItemView::SelectRows);
// 设置选择模式为单选
tableWidget->setSelectionMode(QAbstractItemView::SingleSelection);
合理的选择配置能让用户更高效地操作表格数据，例如在数据管理界面中，整行选择模式更便于用户对整条数据进行删除、修改等操作。
三、性能优化技巧
当表格需要加载大量数据时，频繁的界面重绘会导致程序卡顿。此时可通过setUpdatesEnabled()方法暂时关闭界面更新，待数据全部加载完成后再重新开启：
// 关闭界面更新
tableWidget->setUpdatesEnabled(false);
// 批量添加数据
for (int i = 0; i < 1000; ++i) {
tableWidget->insertRow(i);
tableWidget->setItem(i, 0, new QTableWidgetItem(QString("数据%1").arg(i)));
}
// 开启界面更新
tableWidget->setUpdatesEnabled(true);
这一技巧能有效减少界面重绘次数，将加载大量数据的时间从数秒缩短至数百毫秒，显著提升用户体验。
QTableWidget作为Qt中功能强大的表格组件，基础配置与交互控制是其使用的核心。掌握这些技巧后，您已能实现大部分常规表格需求。在下一篇笔记中，我们将深入探讨QTableWidget的高级功能，如单元格合并、自定义委托、信号槽交互等，带您进一步挖掘其潜力。