DrawArc Method (Pen, Int32, Int32, Int32, Int32, Int32, Int32)

Graphics::DrawArc Method (Pen^, Int32, Int32, Int32, Int32, Int32, Int32)

 

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)

public:
void DrawArc(
	Pen^ pen,
	int x,
	int y,
	int width,
	int height,
	int startAngle,
	int sweepAngle
)

Parameters

pen
Type: System.Drawing::Pen^

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

x
Type: System::Int32

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

y
Type: System::Int32

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

width
Type: System::Int32

Width of the rectangle that defines the ellipse.

height
Type: System::Int32

Height of the rectangle that defines the ellipse.

startAngle
Type: System::Int32

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

sweepAngle
Type: System::Int32

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

Exception Condition
ArgumentNullException

pen is null.

-or-

rects is null.

ArgumentNullException

rects is a zero-length array.

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 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:
   void DrawArcInt( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );
      // Create coordinates of rectangle to bound ellipse.
      int x = 0;
      int y = 0;
      int width = 100;
      int height = 200;

      // Create start and sweep angles on ellipse.
      int startAngle = 45;
      int sweepAngle = 270;

      // Draw arc to screen.
      e->Graphics->DrawArc( blackPen, x, y, width, height, startAngle, sweepAngle );
   }

.NET Framework
Available since 1.1
Return to top
Show:
© 2016 Microsoft