C++Builder 大尺寸影像顯示兩大技巧：ScrollBox 自動捲軸與滑鼠拖曳漫遊

TImage 本身無捲軸、無焦點、無法直接浏覽超出視窗的大圖。本文提供兩種零程式碼/極少程式碼的增強方案，滿足不同互動需求。

方法一：TScrollBox 容器 —— 自動捲軸，最省事

1. 工具箱拖放 TScrollBox 至表單，調整大小
2. 屬性 AutoScroll = True
3. 在 ScrollBox 內拖放 TImage
4. Image 屬性：AutoSize = True、Left = 0、Top = 0
5. 載入圖片後：圖大於視窗 → 自動出現捲軸；圖小於視窗 → 捲軸隱藏

優點：零程式碼、標準 UI 慣例、支援鍵盤方向鍵/滑鼠滾輪。
缺點：捲軸佔用邊界空間、不適合全螢幕沉浸式檢視。

方法二：TPanel + 滑鼠拖曳 —— 漫遊模式，沉浸體驗

1. 放置 TPanel（或直接用表單客戶區）
2. Panel 內放置 TImage，屬性：AutoSize = True、Left = 0、Top = 0
3. 表單私有變數：int iX0, iY0;
4. Image 事件處理：

void __fastcall TForm1::Image1MouseDown(TObject*, TMouseButton, TShiftState, int X, int Y) {
    iX0 = X; iY0 = Y; // 記錄按下座標
}

void __fastcall TForm1::Image1MouseMove(TObject*, TShiftState Shift, int X, int Y) {
    if (Shift.Contains(ssLeft)) {
        int dx = X - iX0;
        int dy = Y - iY0;
        Image1->Left += dx;
        Image1->Top  += dy;
    }
}

5. 執行：按住左鍵拖曳即可漫遊
6. 進階：加入邊界限制，防止圖片被拖出可視區

// 邊界限制範例
int minLeft = Panel1->Width - Image1->Width;
int minTop  = Panel1->Height - Image1->Height;
if (Image1->Left > 0) Image1->Left = 0;
if (Image1->Left < minLeft) Image1->Left = minLeft;
if (Image1->Top > 0) Image1->Top = 0;
if (Image1->Top < minTop) Image1->Top = minTop;

鍵盤漫遊擴充

void __fastcall TForm1::FormKeyDown(TObject*, WORD& Key, TShiftState) {
    const int STEP = 20;
    switch (Key) {
        case VK_LEFT:  Image1->Left += STEP; break;
        case VK_RIGHT: Image1->Left -= STEP; break;
        case VK_UP:    Image1->Top  += STEP; break;
        case VK_DOWN:  Image1->Top  -= STEP; break;
    }
    // 同步套用邊界限制
}

方案選擇指南

總結

C++Builder 內建元件組合即可輕鬆解決大圖浏覽：ScrollBox 適合傳統 WIMP 介面，Panel+拖曳 適合現代沉浸式互動。兩者程式碼量極少、穩定可靠，實務專案中屢試不爽。