GraphicsPath::AddClosedCurve(constPointF*,INT,REAL) メソッド (gdipluspath.h)
GraphicsPath::AddClosedCurve メソッドは、閉じたカーディナル スプラインをこのパスに追加します。
構文
Status AddClosedCurve(
[in] const PointF *points,
[in] INT count,
[in] REAL tension
);
パラメーター
[in] points
型: const PointF*
カーディナル スプラインを定義するポイントの配列へのポインター。 カーディナル スプラインは、配列内の各ポイントを通過する曲線です。
[in] count
型: INT
ポイント配列内の要素の数を指定する整数。
[in] tension
種類: REAL
曲線の長さと曲線の曲げ方を制御する負でない実数。 値 0 は、スプラインが直線セグメントのシーケンスであることを指定します。 値が大きくなると、曲線はより豊かになります。
戻り値
種類: 状態
メソッドが成功した場合は、 Status 列挙の要素である Ok を返します。
メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。
解説
これらのポイントが後で必要になる場合は、 points 配列のコピーを保持する必要があります。 GraphicsPath オブジェクトには、GraphicsPath::AddClosedCurve メソッドに渡されたポイントは格納されません。代わりに、カーディナル スプラインをベジエ スプラインのシーケンスに変換し、それらのベジエ スプラインを定義する点を格納します。 GraphicsPath オブジェクトからポイントの元の配列を取得することはできません。
例
次の例では、 GraphicsPath オブジェクト パスを作成し、閉じたカーディナル スプラインを パスに追加し、パスを描画 します。 テンションは 1.0 に設定されます。
VOID Example_AddClosedCurve(HDC hdc)
{
Graphics graphics(hdc);
PointF pts[] = {PointF(50.0f,50.0f),
PointF(60.0f,20.0f),
PointF(70.0f,100.0f),
PointF(80.0f,50.0f)};
GraphicsPath path;
path.AddClosedCurve(pts, 4, 1.0f);
// Draw the path.
Pen pen(Color(255, 255, 0, 0));
graphics.DrawPath(&pen, &path);
}
要件
| サポートされている最小のクライアント | Windows XP、Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | gdipluspath.h (Gdiplus.h を含む) |
| Library | Gdiplus.lib |
| [DLL] | Gdiplus.dll |