GetClipRgn

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

GetClipRgn hdc, hrgn

hdc : [intptr] デバイスコンテキストのハンドル。
hrgn : [intptr] 関数呼び出し前は既存のリージョンのハンドル。関数から戻ると、このパラメータは現在のクリッピングリージョンのコピーのハンドルとなる。

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

解説

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

[戻り値]
関数が成功し、指定デバイスコンテキストにクリッピングリージョンが存在しない場合、戻り値は 0
である。関数が成功し、クリッピングリージョンが存在する場合、戻り値は 1 である。エラーが発生した場合、戻り値は -1 である。

[備考]
アプリケーション定義のクリッピングリージョンとは、SelectClipRgn
関数で指定されたクリッピングリージョンのことである。アプリケーションが BeginPaint
関数を呼び出したときに作成されるクリッピングリージョンではない。関数が成功した場合、hrgn
は現在のクリッピングリージョンのコピーのハンドルとなる。このコピーに対するその後の変更は、現在のクリッピングリージョンには影響しない。

情報