getRandomRgn 函式 (wingdi.h)
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 |