Gtk3技术问询：ScrolledWindow内TextView无法随鼠标/光标滚动

嘿，我来帮你搞定这个TextView滚动的问题！你说的情况我太熟悉了——文本内容多了之后，光标或者选中的内容跑到视图外面，控件却不自动滚动，根本看不到内容对吧？下面给你具体的解决方案和修改后的代码：

核心解决思路 #

• 自动跟随光标位置：监听光标的位置变化事件，一旦光标移动到视图外，就触发滚动把光标位置带到可见区域
• 确保鼠标选中时的滚动生效：正确配置ScrolledWindow的滚动策略，TextView本身支持拖动选中时的自动滚动，只要设置正确就能生效

修改后的完整代码 #

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

class ScrolledWindowDemo(Gtk.Window):
    def __init__(self):
        Gtk.Window.__init__(self, title="TextView Scroll Demo")
        self.set_default_size(200, 200)
        self.connect("destroy", Gtk.main_quit)

        # 创建ScrolledWindow，设置滚动策略为自动（需要时显示滚动条）
        self.scrolledwindow = Gtk.ScrolledWindow()
        self.scrolledwindow.set_policy(Gtk.PolicyType.AUTOMATIC, Gtk.PolicyType.AUTOMATIC)
        self.add(self.scrolledwindow)

        # 创建TextView和对应的TextBuffer
        self.textview = Gtk.TextView()
        self.textbuffer = self.textview.get_buffer()

        # 先添加一些测试文本，模拟内容超出视图的情况
        test_text = "\n".join([f"这是第{i}行测试文本" for i in range(50)])
        self.textbuffer.set_text(test_text)

        # 监听光标位置变化信号，触发滚动
        self.textbuffer.connect("notify::cursor-position", self.on_cursor_changed)

        # 将TextView添加到ScrolledWindow
        self.scrolledwindow.add(self.textview)

    def on_cursor_changed(self, buffer, param):
        # 获取插入标记（光标位置）
        insert_mark = buffer.get_insert()
        # 滚动到光标位置，设置垂直对齐为0.5（居中显示），use_align=True启用对齐
        self.textview.scroll_to_mark(
            insert_mark,
            0.0,  # 滚动偏移量
            True, # use_align：是否使用对齐设置
            0.0,  # xalign：水平对齐，0左1右
            0.5   # yalign：垂直对齐，0上1下，0.5居中
        )

if __name__ == "__main__":
    win = ScrolledWindowDemo()
    win.show_all()
    Gtk.main()

关键代码解释 #

1. ScrolledWindow配置：set_policy(Gtk.PolicyType.AUTOMATIC, Gtk.PolicyType.AUTOMATIC)会让滚动条在内容超出视图时自动显示，不需要时隐藏，这是基础配置。
2. 光标滚动触发：通过监听textbuffer的notify::cursor-position信号，每次光标位置变化时，调用scroll_to_mark方法把光标所在位置滚动到视图内。
3. scroll_to_mark参数：
   • insert_mark：就是当前光标对应的标记
   • use_align=True：启用对齐设置，让光标按照指定的垂直/水平位置显示
   • yalign=0.5：让光标垂直居中在视图里，这样不管光标在顶部还是底部，都能保证它在可见区域中间，方便查看

另外，关于鼠标拖动选中文本的滚动，Gtk.TextView默认就支持这个功能——当你拖动鼠标到TextView边缘时，控件会自动滚动内容。如果你的代码里没生效，大概率是因为没有正确把TextView添加到ScrolledWindow，或者ScrolledWindow的滚动策略设成了Gtk.PolicyType.NEVER，只要按照上面的代码配置，这个功能就会正常工作。

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