次の方法で共有

Graphics.DrawCurve メソッド (Pen, Point , Int32, Int32, Single)

  • [アーティクル]

指定したテンションを使用して、指定した Point 構造体の配列を通過するカーディナル スプラインを描画します。

Overloads Public Sub DrawCurve( _
   ByVal pen As Pen, _   ByVal points() As Point, _   ByVal offset As Integer, _   ByVal numberOfSegments As Integer, _   ByVal tension As Single _)
[C#]
public void DrawCurve(Penpen,Point[] points,intoffset,intnumberOfSegments,floattension);
[C++]
public: void DrawCurve(Pen* pen,Pointpoints[],intoffset,intnumberOfSegments,floattension);
[JScript]
public function DrawCurve(
   pen : Pen,points : Point[],offset : int,numberOfSegments : int,tension : float);

パラメータ

  • pen
    曲線の色、幅、および高さを決定する Pen オブジェクト。
  • points
    スプラインを定義する Point 構造体の配列。
  • offset
    points パラメータの配列の最初の要素から曲線の開始点までのオフセット。
  • numberOfSegments
    曲線に含める開始点以降のセグメント数。
  • tension
    曲線のテンションを指定する 0.0F 以上の値。

戻り値

このメソッドは値を返しません。

解説

このメソッドは、配列の各点を通過するカーディナル スプラインを描画します。

点の配列には、4 つ以上の Point 構造体を含める必要があります。

offset でスキップする要素数が指定されます。スキップされた要素以降の最初の要素は、曲線の開始点を表します。

numberOfSegments パラメータの値では、曲線を描画するための開始点以降のセグメント数が指定されます。 numberOfSegments パラメータの値は 1 以上にしてください。offset パラメータの値と numberOfSegments パラメータの値の合計は、points パラメータの配列内の要素数よりも小さい必要があります。

tension パラメータは、スプラインの形を決定します。 tension パラメータの値が 0.0F の場合、このメソッドは点をつなぐ直線セグメントを描画します。通常、 tension パラメータは 1.0F 以下です。値が 1.0F を超える場合は、予期しない結果になります。

使用例

[Visual Basic, C#] 次の例は、Windows フォームでの使用を意図してデザインされており、 Paint イベント ハンドラのパラメータである PaintEventArgs e が必要です。このコードは次のアクションを実行します。

  • 赤と緑のペンを作成します。
  • 曲線を定義する 7 つの点を作成します。
  • 7 つの点の間に 6 本の赤い直線を描画して、不完全な多角形を形成します。
  • 開始点のオフセットとセグメント数を定義します。
  • テンションを定義します。
  • 最後の 5 つの点を通過する (3 番目の点から開始)、開いた緑の曲線を描画します。

[Visual Basic, C#] このメソッドは、テンションを 1.0 に設定します。

 
Public Sub DrawCurvePointSegmentTension(e As PaintEventArgs)
' Create pens.
Dim redPen As New Pen(Color.Red, 3)
Dim greenPen As New Pen(Color.Green, 3)
' Create points that define curve.
Dim point1 As New Point(50, 50)
Dim point2 As New Point(100, 25)
Dim point3 As New Point(200, 5)
Dim point4 As New Point(250, 50)
Dim point5 As New Point(300, 100)
Dim point6 As New Point(350, 200)
Dim point7 As New Point(250, 250)
Dim curvePoints As Point() =  {point1, point2, point3, point4, _
point5, point6, point7}
' Draw lines between original points to screen.
e.Graphics.DrawLines(redPen, curvePoints)
' Create offset, number of segments, and tension.
Dim offset As Integer = 2
Dim numSegments As Integer = 4
Dim tension As Single = 1F
' Draw curve to screen.
e.Graphics.DrawCurve(greenPen, curvePoints, offset, numSegments, _
tension)
End Sub
        
[C#] 
public void DrawCurvePointSegmentTension(PaintEventArgs e)
{
// Create pens.
Pen redPen   = new Pen(Color.Red, 3);
Pen greenPen = new Pen(Color.Green, 3);
// Create points that define curve.
Point point1 = new Point( 50,  50);
Point point2 = new Point(100,  25);
Point point3 = new Point(200,   5);
Point point4 = new Point(250,  50);
Point point5 = new Point(300, 100);
Point point6 = new Point(350, 200);
Point point7 = new Point(250, 250);
Point[] curvePoints =
{
point1,
point2,
point3,
point4,
point5,
point6,
point7
};
// Draw lines between original points to screen.
e.Graphics.DrawLines(redPen, curvePoints);
// Create offset, number of segments, and tension.
int offset = 2;
int numSegments = 4;
float tension = 1.0F;
// Draw curve to screen.
e.Graphics.DrawCurve(greenPen, curvePoints, offset, numSegments, tension);
}

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Graphics クラス | Graphics メンバ | System.Drawing 名前空間 | Graphics.DrawCurve オーバーロードの一覧