如何让Gtk.TextView在Gtk.Box中无需手动调窗即可正确渲染？

问题描述 #

将Gtk.TextView放入垂直方向的Gtk.Box作为窗口子控件时，窗口刚打开看不到文本视图，手动调整窗口大小后才会正常显示——调整后文本视图能根据内容自适应高度（空内容或一行内容显示一行高度，多行内容对应显示多行高度），但初始加载时无法实现这个效果。设置vexpand: true能解决显示问题，但文本视图会垂直占满容器空间，不符合自适应需求。

最小复现的Blueprint代码：

template $ExampleWindow : Adw.ApplicationWindow {
    Box {
        orientation: vertical;
        TextView { }
    }
}

原因分析 #

Gtk.Box默认布局时，不会主动要求Gtk.TextView计算并提供自然大小，导致初始状态下TextView没有分配到足够空间；而手动调整窗口会触发全局布局重计算，此时TextView的自然大小才会被正确评估并分配空间。

解决方案 #

1. 调整UI布局属性

首先在Blueprint中给TextView设置横向扩展、禁用垂直扩展，确保它横向占满容器，同时保持自然高度：

template $ExampleWindow : Adw.ApplicationWindow {
    Box {
        orientation: vertical;
        TextView {
            hexpand: true;  // 横向占满Box宽度
            vexpand: false; // 不垂直扩展，保持内容自适应高度
            wrap-mode: word; // 可选，开启按单词换行，避免单行内容过长
        }
    }
}

2. 触发初始布局重计算

仅设置属性还不够，需要在窗口显示后强制触发一次控件大小重计算，让TextView的自然大小被正确识别。以Python为例：

import gi
gi.require_version("Adw", "1")
gi.require_version("Gtk", "4.0")
from gi.repository import Adw, Gtk

class ExampleWindow(Adw.ApplicationWindow):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        # 加载Blueprint UI
        builder = Gtk.Builder.new_from_resource("/com/example/example.ui")
        self.set_child(builder.get_object("Box"))
        self.text_view = builder.get_object("TextView")
        # 绑定窗口show信号，触发重计算
        self.connect("show", self.on_show)

    def on_show(self, widget):
        # 强制TextView重新计算大小
        self.text_view.queue_resize()

class ExampleApp(Adw.Application):
    def __init__(self):
        super().__init__(application_id="com.example.Example")

    def do_activate(self):
        win = ExampleWindow(application=self)
        win.present()

if __name__ == "__main__":
    app = ExampleApp()
    app.run(None)

额外优化：内容变化时自动调整大小

如果需要TextView在内容修改后自动适配高度，可以监听文本缓冲区的changed信号，每次内容变化时触发resize：

def __init__(self, **kwargs):
    # ... 其他初始化代码 ...
    self.text_buffer = self.text_view.get_buffer()
    self.text_buffer.connect("changed", self.on_buffer_changed)

def on_buffer_changed(self, buffer):
    self.text_view.queue_resize()

这样就能实现TextView初始显示正常，且始终根据内容自适应高度的效果。

内容的提问来源于stack exchange，提问作者david-swift