CreatePolygonRgn 関数 (wingdi.h)
CreatePolygonRgn 関数は、多角形領域を作成します。
構文
HRGN CreatePolygonRgn(
[in] const POINT *pptl,
[in] int cPoint,
[in] int iMode
);
パラメーター
[in] pptl
多角形の頂点を論理単位で定義する POINT 構造体の配列へのポインター。 ポリゴンは閉じていると推定されます。 各頂点は 1 回だけ指定できます。
[in] cPoint
配列内のポイントの数。
[in] iMode
領域内のピクセルを決定するために使用される塗りつぶしモード。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 説明 |
|---|---|
|
代替モードを選択します (各スキャンラインの奇数と偶数のポリゴン辺の間の領域を塗りつぶします)。 |
|
巻き取りモードを選択します (任意の領域に 0 以外の巻き取り値が設定されます)。 |
これらのモードの詳細については、「 SetPolyFillMode 関数」を参照してください。
戻り値
関数が成功した場合、戻り値は領域へのハンドルです。
関数が失敗した場合は、返される値は 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 |