Export (0) Print
Expand All

GraphicsPath.AddArc Method (Rectangle, Single, Single)

Appends an elliptical arc to the current figure.

Namespace: System.Drawing.Drawing2D
Assembly: System.Drawing (in system.drawing.dll)

public void AddArc (
	Rectangle rect,
	float startAngle,
	float sweepAngle
)
public void AddArc (
	Rectangle rect, 
	float startAngle, 
	float sweepAngle
)
public function AddArc (
	rect : Rectangle, 
	startAngle : float, 
	sweepAngle : float
)
Not applicable.

Parameters

rect

A Rectangle that represents the rectangular bounds of the ellipse from which the arc is taken.

startAngle

The starting angle of the arc, measured in degrees clockwise from the x-axis.

sweepAngle

The angle between startAngle and the end of the arc.

If there are previous lines or curves in the figure, a line is added to connect the endpoint of the previous segment to the beginning of the arc.

The arc is traced along the perimeter of the ellipse bounded by the specified rectangle. The starting point of the arc is determined by measuring clockwise from the x-axis of the ellipse (at the 0-degree angle) by the number of degrees in the start angle. The endpoint is similarly located by measuring clockwise from the starting point by the number of degrees in the sweep angle. If the sweep angle is greater than 360 degrees or less than -360 degrees, the arc is swept by exactly 360 degrees or -360 degrees, respectively.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, an OnPaint event object. The code performs the following actions:

  • Creates a rectangle, from which the arc is defined.

  • Creates a path, myPath.

  • Defines a 180-degree elliptical arc that sweeps from 0 degrees to 180 degrees and appends it to a path.

  • Draws the path to screen.

private void AddArcExample(PaintEventArgs e)
{
             
    // Create a GraphicsPath object.
    GraphicsPath myPath = new GraphicsPath();
             
    // Set up and call AddArc, and close the figure.
    Rectangle rect = new Rectangle(20, 20, 50, 100);
    myPath.StartFigure();
    myPath.AddArc(rect, 0, 180);
    myPath.CloseFigure();
             
    // Draw the path to screen.
    e.Graphics.DrawPath(new Pen(Color.Red, 3), myPath);
}

private void AddArcExample(PaintEventArgs e)
{
    // Create a GraphicsPath object.
    GraphicsPath myPath = new GraphicsPath();

    // Set up and call AddArc, and close the figure.
    Rectangle rect = new Rectangle(20, 20, 50, 100);

    myPath.StartFigure();
    myPath.AddArc(rect, 0, 180);
    myPath.CloseFigure();

    // Draw the path to screen.
    e.get_Graphics().DrawPath(new Pen(Color.get_Red(), 3), myPath);
} //AddArcExample

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft