GetRandomRgn

GetRandomRgn 関数は、指定したデバイスコンテキストのシステムクリッピングリージョンを特定のリージョンへコピーする。

GetRandomRgn hdc, hrgn, i

hdc : [intptr] デバイスコンテキストのハンドル。
hrgn : [intptr] リージョンのハンドル。関数呼び出し前は既存のリージョンを示す。関数から戻ると、現在のシステムリージョンのコピーを示す。hrgn が以前指していたリージョンは上書きされる。
i : [int] このパラメータは SYSRGN でなければならない。

(プラグイン / モジュール : gdi32.dll)

解説

GetRandomRgn 関数は、指定したデバイスコンテキストのシステムクリッピングリージョンを特定のリージョンへコピーする。

[戻り値]
関数が成功した場合、戻り値は 1 である。失敗した場合は -1 である。取得対象のリージョンが NULL の場合、戻り値は 0
である。関数が失敗するか取得対象のリージョンが NULL の場合、hrgn は初期化されない。

[備考]
SYSRGN フラグを使用する際、ウィンドウの移動によりシステムクリッピングリージョンが最新でない場合がある点に注意。それでも
WM_PAINT 処理中の BeginPaint と EndPaint
ブロック内でシステムクリッピングリージョンを取得して使用するのは安全である。この場合、システムリージョンは更新リージョンとウィンドウの現在の可視領域の交差である。GetRandomRgn
の戻りから EndPaint までの間にウィンドウが移動すると、新たな WM_PAINT メッセージが発行される。これ以外の用途で
SYSRGN フラグを使用するとアプリケーションで描画エラーが発生する可能性がある。返されるリージョンは画面座標である。

情報