次の方法で共有


GetRegionData 関数 (wingdi.h)

GetRegionData 関数は、指定されたバッファーに領域を記述するデータを格納します。 このデータには、領域を構成する四角形のディメンションが含まれます。

構文

DWORD GetRegionData(
  [in]  HRGN      hrgn,
  [in]  DWORD     nCount,
  [out] LPRGNDATA lpRgnData
);

パラメーター

[in] hrgn

リージョンへのハンドル。

[in] nCount

lpRgnData バッファーのサイズ (バイト単位)。

[out] lpRgnData

情報を受け取る RGNDATA 構造体へのポインター。 リージョンのディメンションは論理単位です。 このパラメーターが NULL の場合、戻り値にはリージョン データに必要なバイト数が含まれます。

戻り値

関数が成功し、 nCount で 適切なバイト数が指定されている場合、戻り値は実際に使用されたバイト数 ( nCount 以下) と等しくなります。

lpRgnDataNULL の場合、戻り値は必要なバイト数になります。

関数が失敗した場合、戻り値は 0 になります。

hrgn が無効であることが原因でエラーが発生した場合、GetLastError はERROR_INVALID_HANDLEを返します。 それ以外の場合、 GetLastError はERROR_INVALID_PARAMETER を返します。

nCount が小さすぎると、関数は失敗します。

注釈

GetRegionData 関数は、ExtCreateRegion 関数と組み合わせて使用されます。

要件

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

こちらもご覧ください

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

ExtCreateRegion

RGNDATA

リージョン関数

リージョンの概要