ExtSelectClipRgn 函式 (wingdi.h)

ExtSelectClipRgn 函式會使用指定的模式,將指定的區域與目前的裁剪區域結合。

語法

int ExtSelectClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] int  mode
);

參數

[in] hdc

裝置內容的句柄。

[in] hrgn

要選取之區域的句柄。 除非指定RGN_COPY模式,否則此句柄不得為 NULL

[in] mode

要執行的作業。 它必須是下列其中一個值。

意義
RGN_AND
新的裁剪區域結合了目前裁剪區域的重疊區域,以及 hrgn 所識別的區域。
RGN_COPY
新的裁剪區域是 hrgn 所識別區域的複本。 這與 SelectClipRgn 相同。 如果 hrgn 所識別的區域是 NULL,則新的裁剪區域是預設裁剪區域, (預設裁剪區域是 null 區域) 。
RGN_DIFF
新的裁剪區域結合了目前裁剪區域的區域,以及 從 hrgn 所識別的區域排除的區域。
RGN_OR
新的裁剪區域結合了目前的裁剪區域,以及 hrgn 所識別的區域。
RGN_XOR
新的裁剪區域結合了目前裁剪區域和 hrgn 所識別的區域,但會排除任何重疊的區域。

傳回值

傳回值會指定新裁剪區域的複雜度;它可以是下列其中一個值。

傳回碼 Description
NULLREGION
區域是空的。
SIMPLEREGION
區域是單一矩形。
COMPLEXREGION
區域是一個以上的矩形。
ERROR
發生錯誤。

備註

如果呼叫此函式時發生錯誤,則指定裝置內容的先前裁剪區域不會受到影響。

ExtSelectClipRgn 函式會假設指定區域的座標是在裝置單位中指定。

只會使用 hrgn 參數所識別的區域複本。 區域本身可以在此呼叫之後重複使用,也可以將其刪除。

規格需求

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

另請參閱

裁剪函式

裁剪概觀

SelectClipRgn