GraphicsPath.AddArc(const RectF, REAL, REAL) method

Article
03/07/2012

Applies to: desktop apps only

The GraphicsPath::AddArc method adds an elliptical arc to the current figure of this path.

Syntax

Status AddArc(
  [in, ref]  const RectF &rect,
  [in]       REAL startAngle,
  [in]       REAL sweepAngle
);

Parameters

rect [in, ref]
Type: const RectF

Reference to a rectangle that bounds the ellipse that contains the arc.
startAngle [in]
Type: REAL

Real number that specifies the clockwise angle, in degrees, between the horizontal axis of the ellipse and the starting point of the arc.
sweepAngle [in]
Type: REAL

Real number that specifies the clockwise angle, in degrees, between the starting point (startAngle) and the ending point of the arc.

Return value

Type:

Type: Status****

If the method succeeds, it returns Ok, which is an element of the Status enumeration.

If the method fails, it returns one of the other elements of the Status enumeration.

Examples

The following example creates a GraphicsPath object path, adds an arc to path, closes the arc, and then draws path.

VOID AddArcExample(HDC hdc)
{
   Graphics graphics(hdc);
   RectF rect(20.0f, 20.0f, 50.0f, 100.0f);

   GraphicsPath path;
   path.AddArc(rect, 0.0f, 180.0f);
   path.CloseFigure();
   
   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

Requirements

Minimum supported client	Windows XP, Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Product	GDI+ 1.0
Header	Gdipluspath.h (include Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll