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.
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 ); }
Available since 1.1