桌面应用 / 系统课时
用 TableView 展示二维数据
用 TableView 展示二维数据
本篇解决 QML 中多列数据展示的问题,学习如何使用 TableView 组织行列结构、调整尺寸,并通过代理控制单元格内容显示,最终构建基础数据表格界面。
学习目标
- 理解 TableView 展示二维模型数据的方式。
- 掌握列宽、行高和 delegate 的基本配置。
- 实现带基础选择行为的数据表格。
TableView 适合解决什么问题
当应用需要展示订单列表、设备状态、用户信息等二维数据时,普通 ListView 只能自然表达单列结构。TableView 提供行和列两个维度,可以根据模型中的字段组织表格内容。
在 Qt 6 中,TableView 通过模型提供数据,通过 delegate 决定每个单元格的视觉表现。模型负责数据,代理负责界面,两者分离后更容易维护。
使用模型和代理创建表格
下面示例使用 ListModel 提供三列数据,通过 delegate 根据列索引读取不同字段。实际项目中也可以替换为 C++ 暴露的 QAbstractTableModel。
qml
import QtQuick
import QtQuick.Controls
ApplicationWindow {
width: 640
height: 360
visible: true
ListModel {
id: tableModel
ListElement { name: "Keyboard"; price: 199; stock: 20 }
ListElement { name: "Mouse"; price: 99; stock: 50 }
ListElement { name: "Monitor"; price: 1299; stock: 8 }
}
TableView {
anchors.fill: parent
model: tableModel
columnSpacing: 1
rowSpacing: 1
delegate: Rectangle {
implicitWidth: 140
implicitHeight: 40
Text {
anchors.centerIn: parent
text: column === 0 ? name : column === 1 ? price : stock
}
}
}
}预期输出
text
窗口显示一个三行三列的数据表格:
第一列显示商品名称,第二列显示价格,第三列显示库存数量。控制行列尺寸和选择行为
TableView 的尺寸通常由 delegate 的 implicitWidth 和 implicitHeight 决定。对于固定业务表格,可以让代理返回统一尺寸;对于内容长度变化明显的场景,则需要根据文本长度动态计算尺寸。
基础选择可以通过 TableView 的选择模型完成。实际开发中通常会结合 ItemSelectionModel 保存当前选中行,再由代理根据选择状态改变显示效果。
使用 TableView 时的边界
TableView 更适合结构稳定的二维数据展示。如果数据量非常大,需要关注模型的数据访问方式,避免一次性把所有数据加载到内存。
同时,表头通常不会直接由 TableView 自动生成,复杂表格一般会额外设计 HeaderView 或自定义标题区域,让字段名称与数据区域分离。
按自己的节奏,确认真正理解。