指定されたデバイスコンテキストで選択されているパスから、リージョンを作成します。作成されたリージョンは、デバイス座標を使います。

HRGN PathToRegion(
  HDC hdc   // デバイスコンテキストのハンドル
);

パラメータ

hdc

デバイスコンテキストのハンドルを指定します。このデバイスコンテキストは、閉じたパスを保持していなければなりません。

戻り値

関数が成功すると、有効なリージョンのハンドルが返ります。

関数が失敗すると、0 が返ります。

Windows NT/2000：拡張エラー情報を取得するには、 関数を使います。GetLastError は、次のエラーコードのいずれかを返すことがあります。

ERROR_CAN_NOT_COMPLETE
ERROR_INVALID_PARAMETER
ERROR_NOT_ENOUGH_MEMORY

解説

hdc パラメータで指定されたデバイスコンテキストは、閉じたパスを保持していなければなりません。

パスからリージョンへの変換が終わると、そのデバイスコンテキストのパスは破棄されます。

対応情報

Windows NT/2000：Windows NT 3.1 以降
Windows 95/98：Windows 95 以降
ヘッダー：Wingdi.h 内で宣言、Windows.h をインクルード
インポートライブラリ：Gdi32.lib を使用

参照

BeginPath, EndPath, SetPolyFillMode