OffsetRect 函數用法詳解：矩形位置偏移

OffsetRect 是 Windows API 中常用的矩形操作函數，用於依據指定的水平與垂直位移量，產生一個新的矩形結構。

語法

NewRectangle := OffsetRect(Rectangle, X, Y);

參數與回傳值

• Rectangle：原始矩形（TRect 型別）。
• X：水平位移量。正值向右，負值向左。
• Y：垂直位移量。正值向下，負值向上。
• 回傳值：位移後的新矩形（TRect）。

運作原理

函數會複製原矩形的寬高，並根據 X、Y 計算新的左上角座標：

• 新左邊 = 原左邊 + X
• 新上邊 = 原上邊 + Y
• 新右邊 = 原右邊 + X
• 新下邊 = 原下邊 + Y

應用情境

• 繪圖時需將圖形整體平移。
• 碰撞偵測中，快速計算物件移動後的邊界框。
• UI 版面動態調整控件位置。