createRectRgn 函式 (wingdi.h)

CreateRectRgn 函式會建立矩形區域。

語法

HRGN CreateRectRgn(
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2
);

[in] x1

以邏輯單位指定區域左上角的 X 座標。

[in] y1

以邏輯單位指定區域左上角的 Y 座標。

[in] x2

以邏輯單位指定區域右下角的 X 座標。

[in] y2

以邏輯單位指定區域右下角的 Y 座標。

如果函式成功，傳回值就是區域的句柄。

如果函式失敗，傳回值為 NULL。

當您不再需要 HRGN 物件時，請呼叫 DeleteObject 函式加以刪除。

區域座標會以27位帶正負號的整數表示。

建立<圖形>Rgn 方法所建立的區域 (，例如 CreateRectRgn 和 CreatePolygonRgn) 只包含圖形的內部;圖形的外框會從區域排除。這表示兩個循序頂點之間的某一行上任何點都不會包含在區域中。如果您要針對這類點呼叫 PtInRegion ，它會傳回零作為結果。

如需範例，請參閱繪圖示記。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll