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

こちらもご覧ください

BeginPaint

クリッピング関数

クリッピングの概要

SelectClipRgn