PathToRegion

Declare Function Api_PathToRegion& Lib "gdi32" Alias "PathToRegion" (ByVal hDC&)

Declare Function PathToRegion Lib "gdi32" Alias "PathToRegion" (ByVal hdc As Long) As Long

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

パラメータ
hdc
    デバイスコンテキストのハンドルを指定する。このデバイスコンテキストは、閉じたパスを保持していなければならない。
　

戻り値
    関数が成功すると、有効なリージョンのハンドルが返る。
    関数が失敗すると、0 が返る。
    Windows NT/2000：拡張エラー情報を取得するには、GetLastError 関数を使う。

    GetLastError は、次のエラーコードのいずれかを返すことがある。
    ERROR_CAN_NOT_COMPLETE
    ERROR_INVALID_PARAMETER
    ERROR_NOT_ENOUGH_MEMORY

解説
    hdc パラメータで指定されたデバイスコンテキストは、閉じたパスを保持していなければならない。
    パスからリージョンへの変換が終わると、そのデバイスコンテキストのパスは破棄される。