Graphics.DrawArc Method (Pen, Rectangle, Single, Single)


Draws an arc representing a portion of an ellipse specified by a Rectangle structure.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

Public Sub DrawArc (
	pen As Pen,
	rect As Rectangle,
	startAngle As Single,
	sweepAngle As Single


Type: System.Drawing.Pen

Pen that determines the color, width, and style of the arc.

Type: System.Drawing.Rectangle

RectangleF structure that defines the boundaries of the ellipse.

Type: System.Single

Angle in degrees measured clockwise from the x-axis to the starting point of the arc.

Type: System.Single

Angle in degrees measured clockwise from the startAngle parameter to ending point of the arc.

Exception Condition

pen is null.

This method draws an arc that is a portion of the perimeter of an ellipse. The ellipse is defined by the boundaries of a rectangle. The arc is the portion of the perimeter of the ellipse between the startAngle parameter and the startAngle + sweepAngle parameters.

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 a black pen.

  • Creates a rectangle to bound an ellipse.

  • Defines the start (45 degrees) and sweep (270 degrees) angles.

  • Draws the elliptical arc to the screen.

The result is a partial ellipse missing a segment between + and - 45 degrees of the x axis.

Private Sub DrawArcRectangle(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create rectangle to bound ellipse.
    Dim rect As New Rectangle(0, 0, 100, 200)

    ' Create start and sweep angles on ellipse.
    Dim startAngle As Single = 45.0F
    Dim sweepAngle As Single = 270.0F

    ' Draw arc to screen.
    e.Graphics.DrawArc(blackPen, rect, startAngle, sweepAngle)
End Sub

.NET Framework
Available since 1.1
Return to top