getClipRgn 函式 (wingdi.h)

GetClipRgn 函式會擷取句柄，識別指定裝置內容的目前應用程式定義裁剪區域。

語法

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

[in] hdc

裝置內容的句柄。

[in] hrgn

呼叫函式之前，現有區域的句柄。函式傳回之後，這個參數是目前裁剪區域複本的句柄。

如果函式成功，而且指定的裝置內容沒有裁剪區域，則傳回值為零。如果函式成功，且給定裝置內容有裁剪區域，則傳回值為 1。如果發生錯誤，則傳回值為 -1。

應用程式定義的裁剪區域是由 SelectClipRgn 函式所識別的裁剪區域。它不是應用程式呼叫 BeginPaint 函式時所建立的裁剪區域。

如果函式成功， hrgn 參數是目前裁剪區域複本的句柄。此復本的後續變更不會影響目前的裁剪區域。

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