getRandomRgn 函式 (wingdi.h)

發行項
03/04/2024

GetRandomRgn 函式會將指定裝置內容的系統裁剪區域複製到特定區域。

語法

int GetRandomRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] INT  i
);

參數

[in] hdc

裝置內容的句柄。

[in] hrgn

區域的句柄。呼叫函式之前，這會識別現有的區域。函式傳回之後，這會識別目前系統區域的複本。會覆寫 hrgn 所識別的舊區域。

[in] i

此參數必須是SRGN。

傳回值

如果函式成功，則傳回值為 1。如果函式失敗，則傳回值為 -1。如果要擷取的區域是 NULL，則傳回值為 0。如果函式失敗或要擷取的區域是 NULL， 則不會初始化 hrgn 。

備註

使用SRGN旗標時，請注意系統裁剪區域可能不是目前的，因為視窗移動。不過，在WM_PAINT處理期間，在 BeginPaint-EndPaint 區塊內擷取和使用系統裁剪區域是安全的。在此情況下，系統區域是更新區域與視窗目前可見區域的交集。 在 GetRandomRgn 和 EndPaint 之前傳回的任何視窗移動都會產生新的WM_PAINT訊息。任何其他使用SRGN旗標可能會導致應用程式中發生繪製錯誤。

傳回的區域是螢幕座標。

規格需求

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