如何设置QTextEdit仅在输入到屏幕边缘时才自动水平滚动？

默认情况下，QTextEdit会在光标移出可视区域时自动滚动，这导致输入文本还没到屏幕边缘就触发滚动。要实现仅当光标超出可视区域右边缘时才自动滚动，可以通过自定义QTextEdit子类，重写光标位置变化的处理逻辑来实现，同时保留手动滚动功能。

实现步骤 #

• 继承QTextEdit，重写cursorPositionChanged方法
• 在方法中判断光标是否超出可视区域右边界，仅当超出时执行自动滚动
• 原有的手动滚动逻辑不受此修改影响

完整代码示例 #

from PyQt5.QtWidgets import QTextEdit, QSizePolicy, QApplication
from PyQt5.QtCore import QRectF

class CustomTextEdit(QTextEdit):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 初始化原有设置
        self.setSizePolicy(QSizePolicy.Expanding, QSizePolicy.Expanding)
        self.setLineWrapMode(QTextEdit.NoWrap)
        self.setTabStopDistance(QFontMetricsF(self.font()).horizontalAdvance(' ') * 16)

    def cursorPositionChanged(self):
        # 获取可视区域边界（viewport为文本编辑的显示区域）
        viewport_rect = self.viewport().rect()
        # 获取当前光标所在的矩形区域
        cursor_rect = self.cursorRect()
        # 转换为viewport坐标系下的位置
        cursor_viewport_pos = self.viewport().mapFromParent(cursor_rect)

        # 仅当光标右边界超出可视区域右边界时，触发自动滚动
        if cursor_viewport_pos.right() > viewport_rect.right():
            self.ensureCursorVisible()
        # 其余情况不执行自动滚动，保持当前滚动位置

# 使用示例
if __name__ == "__main__":
    app = QApplication([])
    editor = CustomTextEdit()
    # 设置自定义字体（替换为你的字体对象）
    # editor.setFont(your_font)
    editor.show()
    app.exec_()

说明 #

• 该方案通过拦截光标位置变化事件，手动控制自动滚动的触发条件，完全匹配需求：只有输入到超出屏幕的长行末尾时才滚动。
• 手动滚动功能不受影响，用户拖动水平滚动条后，只要光标在可视区域内，不会触发自动滚动。
• 键盘输入、粘贴文本等所有场景下的光标位置变化，都会按照设定规则执行自动滚动逻辑。

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