CreateRectRgn 関数 (wingdi.h)

[アーティクル]
08/27/2023

CreateRectRgn 関数は、四角形の領域を作成します。

構文

HRGN CreateRectRgn(
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2
);

パラメーター

[in] x1

領域の左上隅の x 座標を論理単位で指定します。

[in] y1

領域の左上隅の y 座標を論理単位で指定します。

[in] x2

領域の右下隅の x 座標を論理単位で指定します。

[in] y2

領域の右下隅の y 座標を論理単位で指定します。

戻り値

関数が成功した場合、戻り値は領域へのハンドルです。

関数が失敗した場合は、返される値は NULL です。

注釈

HRGN オブジェクトが不要になったら、DeleteObject 関数を呼び出して削除します。

領域座標は、27 ビット符号付き整数として表されます。

Create<Shape>Rgn メソッド ( CreateRectRgn や CreatePolygonRgn など) によって作成された領域には、図形の内部のみが含まれます。図形のアウトラインは領域から除外されます。つまり、2 つの連続する頂点の間の線上の点は、領域に含まれません。このようなポイントに対して PtInRegion を呼び出すと、結果として 0 が返されます。

例

例については、「描画マーカー」を参照してください。

要件

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