Graphics.DrawCurve Method (Pen, Point[])
Draws a cardinal spline through a specified array of Point structures.
Assembly: System.Drawing (in System.Drawing.dll)
Parameters
- pen
-
Type:
System.Drawing.Pen
Pen that determines the color, width, and height of the curve.
- points
-
Type:
System.Drawing.Point[]
Array of Point structures that define the spline.
| Exception | Condition |
|---|---|
| ArgumentNullException | pen is null. -or- points is null. |
This method draws a cardinal spline that passes through each point in the array.
The array of points must contain at least three Point structures for a curve to be drawn.
This method uses a default tension of 0.5.
The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. The code performs the following actions:
Creates red and green pens.
Creates seven points to define a curve.
Draws six red straight lines between the seven points to form an incomplete polygon.
Draws an open green curve through the seven points.
The method uses a default tension of 0.5.
private void DrawCurvePoint(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); // Draw curve to screen. e.Graphics.DrawCurve(greenPen, curvePoints); }
Available since 1.1