Qt 6.3 QML中如何为TreeView组件添加列表头

Qt 6.x 版本的 Quick Controls 2 中已经移除了TableViewColumn类型，编译提示“TableViewColumn不是一个类型”属于正常情况，和版本升级无关。Qt6 提供的HorizontalHeaderView是官方原生支持的表头实现方案，直接和TreeView搭配即可实现带表头的树形列表效果，不需要额外自定义组件。

实现步骤 #

• 确保已经导入对应模块，HorizontalHeaderView属于QtQuick.Controls模块，和TreeView的导入要求一致。
• 使用纵向布局将表头放在TreeView顶部，通过syncView属性将表头和TreeView绑定，组件会自动同步列数、列宽、横向滚动位置，不需要手动计算布局参数。
• 给表头传入和TreeView列一一对应的文本模型即可。

可直接使用的修改后代码 #

import QtQuick
import QtQuick.Controls
import QtQuick.Layouts

ColumnLayout {
    anchors.fill: parent
    margins: 10
    spacing: 0

    HorizontalHeaderView {
        id: tableHeader
        Layout.fillWidth: true
        syncView: tree_view
        // 按现有列顺序填写表头文本
        model: ["文件名", "内含文件数", "文件大小"]
    }

    TreeView {
        id: tree_view
        Layout.fillWidth: true
        Layout.fillHeight: true
        clip: true
        model: FileSystemModel

        // 初始化各列默认宽度，可按需调整数值
        Component.onCompleted: {
            columnWidthProvider = function(column) {
                switch(column) {
                    case 0: return 320
                    case 1: return 120
                    default: return 150
                }
            }
        }

        delegate: TreeViewDelegate {
            contentItem: Text {
                anchors.leftMargin: leftMargin
                anchors.rightMargin: rightMargin
                text: {
                    if (column === 0)
                        file_name
                    else if (column === 1)
                        inner_files
                    else
                        file_size
                }
            }
        }
    }
}

补充说明 #

• 绑定syncView后，表头默认支持拖拽调整列宽、点击列排序的交互扩展，不需要额外写事件处理逻辑。
• 不要照搬Qt5时代Controls 1.x的TreeView写法，Qt6的TreeView继承自TableView做了全量重写，旧版本的header属性、TableViewColumn等API均已废弃删除。
• 如果需要自定义表头样式，直接修改HorizontalHeaderView的delegate属性即可，和TreeView自定义委托的写法一致。

内容的提问来源于stack exchange，提问作者no name