GetClipRgn 関数 (wingdi.h)

GetClipRgn 関数は、指定されたデバイスコンテキストの現在のアプリケーション定義クリッピング領域を識別するハンドルを取得します。

構文

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

[in] hdc

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

[in] hrgn

関数が呼び出される前の既存のリージョンへのハンドル。関数が戻った後、このパラメーターは現在のクリッピング領域のコピーへのハンドルです。

関数が成功し、指定されたデバイスコンテキストにクリッピング領域がない場合、戻り値は 0 になります。関数が成功し、指定されたデバイスコンテキストのクリッピング領域がある場合、戻り値は 1 です。エラーが発生した場合、戻り値は -1 です。

アプリケーション定義のクリッピング領域は、 SelectClipRgn 関数によって識別されるクリッピング領域です。アプリケーションが BeginPaint 関数を呼び出したときに作成されるクリッピング領域ではありません。

関数が成功した場合、 hrgn パラメーターは現在のクリッピング領域のコピーへのハンドルです。このコピーに対する後続の変更は、現在のクリッピング領域には影響しません。

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