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 |
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示