Export (0) Print
Expand All

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

Draws an arc representing a portion of an ellipse specified by a pair of coordinates, a width, and a height.

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

'Declaration
Public Sub DrawArc ( _
	pen As Pen, _
	x As Single, _
	y As Single, _
	width As Single, _
	height As Single, _
	startAngle As Single, _
	sweepAngle As Single _
)

Parameters

pen
Type: System.Drawing.Pen

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

x
Type: System.Single

The x-coordinate of the upper-left corner of the rectangle that defines the ellipse.

y
Type: System.Single

The y-coordinate of the upper-left corner of the rectangle that defines the ellipse.

width
Type: System.Single

Width of the rectangle that defines the ellipse.

height
Type: System.Single

Height of the rectangle that defines the ellipse.

startAngle
Type: System.Single

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

sweepAngle
Type: System.Single

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

ExceptionCondition
ArgumentNullException

pen is Nothing.

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 PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

  • Creates a black pen.

  • Creates the position and size of 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 DrawArcFloat(ByVal e As PaintEventArgs)

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

    ' Create coordinates of rectangle to bound ellipse. 
    Dim x As Single = 0.0F
    Dim y As Single = 0.0F
    Dim width As Single = 100.0F
    Dim height As Single = 200.0F

    ' 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, x, y, width, height, startAngle, _
    sweepAngle)
End Sub

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft