Graphics.DrawArc Method (Pen, Rectangle, Single, Single)
Draws an arc representing a portion of an ellipse specified by a Rectangle structure.
Assembly: System.Drawing (in System.Drawing.dll)
Parameters
- pen
-
Type:
System.Drawing.Pen
Pen that determines the color, width, and style of the arc.
- rect
-
Type:
System.Drawing.Rectangle
RectangleF structure that defines the boundaries of 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.
| Exception | Condition |
|---|---|
| ArgumentNullException | 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 void DrawArcRectangle(PaintEventArgs e) { // Create pen. Pen blackPen= new Pen(Color.Black, 3); // Create rectangle to bound ellipse. Rectangle rect = new Rectangle(0, 0, 100, 200); // Create start and sweep angles on ellipse. float startAngle = 45.0F; float sweepAngle = 270.0F; // Draw arc to screen. e.Graphics.DrawArc(blackPen, rect, startAngle, sweepAngle); }
Available since 1.1