Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

AngleArc function

The AngleArc function draws a line segment and an arc. The line segment is drawn from the current position to the beginning of the arc. The arc is drawn along the perimeter of a circle with the given radius and center. The length of the arc is defined by the given start and sweep angles.

Syntax


BOOL AngleArc(
  _In_ HDC   hdc,
  _In_ int   X,
  _In_ int   Y,
  _In_ DWORD dwRadius,
  _In_ FLOAT eStartAngle,
  _In_ FLOAT eSweepAngle
);

Parameters

hdc [in]

Handle to a device context.

X [in]

Specifies the x-coordinate, in logical units, of the center of the circle.

Y [in]

Specifies the y-coordinate, in logical units, of the center of the circle.

dwRadius [in]

Specifies the radius, in logical units, of the circle. This value must be positive.

eStartAngle [in]

Specifies the start angle, in degrees, relative to the x-axis.

eSweepAngle [in]

Specifies the sweep angle, in degrees, relative to the starting angle.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

The AngleArc function moves the current position to the ending point of the arc.

The arc drawn by this function may appear to be elliptical, depending on the current transformation and mapping mode. Before drawing the arc, AngleArc draws the line segment from the current position to the beginning of the arc.

The arc is drawn by constructing an imaginary circle around the specified center point with the specified radius. The starting point of the arc is determined by measuring counterclockwise from the x-axis of the circle by the number of degrees in the start angle. The ending point is similarly located by measuring counterclockwise from the starting point by the number of degrees in the sweep angle.

If the sweep angle is greater than 360 degrees, the arc is swept multiple times.

This function draws lines by using the current pen. The figure is not filled.

Examples

For an example, see Drawing a Pie Chart.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Lines and Curves Overview
Line and Curve Functions
Arc
ArcTo
MoveToEx

 

 

Show: