Lanterna开发中如何实现TextBox添加文本后自动滚动到底部

我正在使用Java基于Lanterna库开发一款基础终端聊天应用，当新消息到达时，我会调用TextBox组件的addLine()方法追加新内容。TextBox默认会保持原有滚动位置，直到用户聚焦组件后手动滚动，我需要实现TextBox自动滚动到底部的效果。

目前没有找到可通过编程方式设置TextBox滚动位置的公开方法，因此我尝试继承TextBox类，自定义追加文本的方法，实现代码如下：

import com.googlecode.lanterna.TerminalSize;
import com.googlecode.lanterna.gui2.TextBox;

public class ChatWindowTextBox extends TextBox{
    public ChatWindowTextBox(TerminalSize preferredSize, Style style){
        super(preferredSize, style);
    }

    public ChatWindowTextBox addLineAndScrollDown(String line){
        addLine(line);
        setReadOnly(false); // 界面初始化时我将聊天窗口设为了只读，这里临时取消只读状态
        takeFocus();
        setCaretPosition(Integer.MAX_VALUE, Integer.MAX_VALUE);
        setReadOnly(true);
        return this;
    }
}

通过调试确认，setCaretPosition的入参会被正确截断为文本最后一行、最后一列的实际有效值，组件内部的caretPosition属性也确实更新为对应位置，但该操作并没有触发TextBox滚动。核心疑问：

• 是否对setCaretPosition()的行为存在误解
• 是否存在可行的编程方案实现TextBox自动滚动到底部

你对setCaretPosition()的基础功能理解没有偏差，代码失效的核心原因有两点：

1. 传入Integer.MAX_VALUE坐标时，内部对越界值的截断逻辑发生在光标位置赋值阶段，视口滚动的触发判断在截断逻辑执行前就已经完成，没有检测到光标实际已经移出当前可视区域
2. 调用setCaretPosition后立刻设置setReadOnly(true)，而TextBox在只读状态下会跳过所有自动调整视口的逻辑，自然不会触发滚动。

最稳定的实现方案不需要反射，也不依赖光标和滚动的联动逻辑，直接调用子类可访问的setScrollTop()方法手动设置滚动偏移即可，适配所有Lanterna 3.x版本，修正后的代码如下：

import com.googlecode.lanterna.TerminalSize;
import com.googlecode.lanterna.gui2.TextBox;

public class ChatWindowTextBox extends TextBox{
    public ChatWindowTextBox(TerminalSize preferredSize, Style style){
        super(preferredSize, style);
    }

    public ChatWindowTextBox addLineAndScrollDown(String line){
        // 暂存原始只读状态
        boolean originalReadOnlyState = isReadOnly();
        setReadOnly(false);
        addLine(line);
        // 光标移动到文本末尾
        setCaretPositionToEnd();
        // 计算滚动到底部需要的垂直偏移量
        TerminalSize visibleAreaSize = getSize();
        int totalLineCount = getLineCount();
        int targetScrollOffset = Math.max(0, totalLineCount - visibleAreaSize.getRows());
        // 直接设置滚动位置，该方法是TextBox的protected方法，子类可直接调用
        setScrollTop(targetScrollOffset);
        // 恢复原始只读状态
        setReadOnly(originalReadOnlyState);
        return this;
    }
}

如果使用的是Lanterna 3.2以上版本，还可以直接在设置光标到末尾后，调用同是protected方法的scrollToCaret()触发视口自动调整，不需要手动计算偏移量。

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