Windows Console 文字捲動技術：ScrollConsoleScreenBuffer 完整參數解析與實驗驗證

API 簽名

BOOL ScrollConsoleScreenBuffer(
    HANDLE hConsoleOutput,
    const SMALL_RECT *lpScrollRectangle, // 捲動區域
    const SMALL_RECT *lpClipRectangle,   // 裁剪區域（NULL=整個緩衝區）
    COORD dwDestinationOrigin,           // 目的地左上角
    const CHAR_INFO *lpFill              // 填充字元與屬性
);

核心參數關係實驗

實驗場景：主控台印出 4 行文字，設定捲動區域 Left=1, Top=1, Right=10, Bottom=2（第 2~3 行、第 2~11 欄），目的地 (0,5)（第 6 行第 1 欄）。

歸納規律

1. 裁剪區外：完全凍結，不移動、不填充、不被覆蓋
2. 裁剪區內：完全受捲動影響——移走處被填充，移入處被覆蓋

應用場景

• 終端機捲動緩衝區實現（lpClipRectangle=NULL）
• 局部 UI 更新（設定裁剪區 = UI 區域，避免影響標題列/狀態列）
• 文字動畫、進度條、選單高亮移動

範例程式碼

HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
CONSOLE_SCREEN_BUFFER_INFO csbi;
GetConsoleScreenBufferInfo(hOut, &csbi);
SMALL_RECT scroll = {1, 1, 10, 2};
COORD dest = {0, 5};
CHAR_INFO fill = {' ', csbi.wAttributes};
ScrollConsoleScreenBuffer(hOut, &scroll, NULL, dest, &fill);