GetRandomRgn 関数 (wingdi.h)

[アーティクル]
03/13/2024

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

構文

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

パラメーター

[in] hdc

デバイスコンテキストへのハンドル。

[in] hrgn

リージョンへのハンドル。関数が呼び出される前に、これは既存のリージョンを識別します。関数が戻った後、これは現在のシステム領域のコピーを識別します。 hrgn によって識別される古いリージョンは上書きされます。

[in] i

このパラメーターは SYSRGN である必要があります。

戻り値

関数が成功した場合、戻り値は 1 です。関数が失敗した場合、戻り値は -1 です。取得する領域が NULL の場合、戻り値は 0 です。関数が失敗した場合、または取得する領域が NULL の場合、 hrgn は初期化されません。

注釈

SYSRGN フラグを使用する場合は、ウィンドウの移動により、システムクリッピング領域が最新ではない可能性があることに注意してください。それでも、WM_PAINT処理中に BeginPaint-EndPaint ブロック内のシステムクリッピング領域を取得して使用しても安全です。この場合、システム領域は、更新領域とウィンドウの現在の可視領域の積集合です。 GetRandomRgn が返されてから EndPaint の前にウィンドウが移動すると、新しいWM_PAINT メッセージが表示されます。 SYSRGN フラグを他に使用すると、アプリケーションで描画エラーが発生する可能性があります。

返される領域は画面座標です。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll