桌面应用 / 系统课时

用 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 或自定义标题区域,让字段名称与数据区域分离。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 TableView 展示二维数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通