如何在PyGObject中滚动Gtk.TreeView内容而不滚动表头

你说得对，直接把Gtk.TreeView放进Gtk.ScrolledWindow会导致表头跟着内容一起滚动，这确实不是我们想要的效果。利用Gtk.Adjustment当然可以实现，但更直观且易维护的方式是把表头和TreeView的内容区域分离——让表头固定在上方，TreeView隐藏自带表头后单独放在滚动窗口里，同时同步列宽保持对齐。

下面是基于你的代码修改后的完整示例：

#!/usr/bin/env python3
import gi
gi.require_version('Gtk', '3.0')
from gi.repository import Gtk, Gdk

class FixedHeaderTreeViewDemo(Gtk.Window):
    def __init__(self):
        super().__init__(title="固定表头的TreeView")
        self.set_default_size(300, 400)
        
        # 主垂直容器：上方表头，下方滚动内容
        main_box = Gtk.Box(orientation=Gtk.Orientation.VERTICAL, spacing=0)
        self.add(main_box)
        
        # 1. 创建自定义表头（替代TreeView自带的表头）
        header_grid = Gtk.Grid()
        main_box.pack_start(header_grid, False, False, 0)
        
        # 2. 创建TreeView并隐藏自带表头
        self.model = Gtk.ListStore(int, str)
        for i in range(30):
            self.model.append([i, f"条目 {i}"])
        
        self.tree_view = Gtk.TreeView(model=self.model)
        self.tree_view.set_headers_visible(False)  # 隐藏自带表头
        
        # 添加列到TreeView
        col1 = Gtk.TreeViewColumn("序号", Gtk.CellRendererText(), text=0)
        col2 = Gtk.TreeViewColumn("内容", Gtk.CellRendererText(), text=1)
        self.tree_view.append_column(col1)
        self.tree_view.append_column(col2)
        
        # 3. 同步表头与TreeView列的宽度
        # 为表头添加对应Label
        header_labels = []
        for col in self.tree_view.get_columns():
            label = Gtk.Label(label=col.get_title())
            label.set_xalign(0)  # 左对齐，和TreeView内容一致
            label.set_padding(6, 6)  # 模拟默认表头的内边距
            header_grid.attach(label, len(header_labels), 0, 1, 1)
            header_labels.append(label)
            
            # 绑定列宽变化信号，同步表头宽度
            col.connect("notify::width", self.on_column_width_change, label)
        
        # 4. 将TreeView放入滚动窗口
        scrolled_window = Gtk.ScrolledWindow()
        scrolled_window.set_policy(Gtk.PolicyType.AUTOMATIC, Gtk.PolicyType.AUTOMATIC)
        scrolled_window.add(self.tree_view)
        main_box.pack_start(scrolled_window, True, True, 0)
        
        # 初始化表头宽度（避免初始状态对齐问题）
        for idx, col in enumerate(self.tree_view.get_columns()):
            header_labels[idx].set_size_request(col.get_width(), -1)

    def on_column_width_change(self, column, param_spec, label):
        # 同步列宽到表头Label
        label.set_size_request(column.get_width(), -1)

if __name__ == "__main__":
    win = FixedHeaderTreeViewDemo()
    win.connect("destroy", Gtk.main_quit)
    win.show_all()
    Gtk.main()

关键部分解释： #

• 分离表头与内容：我们用一个垂直Box分别放置自定义表头和滚动窗口里的TreeView，TreeView通过set_headers_visible(False)隐藏自带表头。
• 列宽同步：通过监听TreeView列的notify::width信号，实时更新表头Label的宽度，保证表头和内容列始终对齐。
• 模拟默认表头样式：给表头Label设置内边距和对齐方式，让它看起来和原生表头一致。

如果你一定要用Gtk.Adjustment来实现，本质上是直接控制TreeView内部内容视口的滚动。你可以通过tree_view.get_vadjustment()获取内容的垂直调整对象，然后手动绑定到滚动控件，但这种方式需要直接操作TreeView的底层组件，不如分离表头的方式直观。

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