ArcTo function (wingdi.h)

The ArcTo function draws an elliptical arc.

Syntax

BOOL ArcTo(
  [in] HDC hdc,
  [in] int left,
  [in] int top,
  [in] int right,
  [in] int bottom,
  [in] int xr1,
  [in] int yr1,
  [in] int xr2,
  [in] int yr2
);

Parameters

[in] hdc

A handle to the device context where drawing takes place.

[in] left

The x-coordinate, in logical units, of the upper-left corner of the bounding rectangle.

[in] top

The y-coordinate, in logical units, of the upper-left corner of the bounding rectangle.

[in] right

The x-coordinate, in logical units, of the lower-right corner of the bounding rectangle.

[in] bottom

The y-coordinate, in logical units, of the lower-right corner of the bounding rectangle.

[in] xr1

The x-coordinate, in logical units, of the endpoint of the radial defining the starting point of the arc.

[in] yr1

The y-coordinate, in logical units, of the endpoint of the radial defining the starting point of the arc.

[in] xr2

The x-coordinate, in logical units, of the endpoint of the radial defining the ending point of the arc.

[in] yr2

The y-coordinate, in logical units, of the endpoint of the radial defining the ending point of the arc.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

ArcTo is similar to the Arc function, except that the current position is updated.

The points (nLeftRect, nTopRect) and (nRightRect, nBottomRect) specify the bounding rectangle. An ellipse formed by the specified bounding rectangle defines the curve of the arc. The arc extends counterclockwise from the point where it intersects the radial line from the center of the bounding rectangle to the (nXRadial1, nYRadial1) point. The arc ends where it intersects the radial line from the center of the bounding rectangle to the (nXRadial2, nYRadial2) point. If the starting point and ending point are the same, a complete ellipse is drawn.

A line is drawn from the current position to the starting point of the arc. If no error occurs, the current position is set to the ending point of the arc.

The arc is drawn using the current pen; it is not filled.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See also

AngleArc

Arc

Line and Curve Functions

Lines and Curves Overview

SetArcDirection