The ArcTo function draws an elliptical arc.
BOOL ArcTo(
| HDC hdc, | // handle to device context |
| int nLeftRect, | // x-coordinate of bounding rectangle's upper-left corner |
| int nTopRect, | // y-coordinate of bounding rectangle's upper-left corner |
| int nRightRect, | // x-coordinate of bounding rectangle's lower-right corner |
| int nBottomRect, | // y-coordinate of bounding rectangle's lower-right corner |
| int nXRadial1, | // x-coordinate of the first radial ending point |
| int nYRadial1, | // y-coordinate of the first radial ending point |
| int nXRadial2, | // x-coordinate of the second radial ending point |
| int nYRadial2 | // y-coordinate of the second radial ending point |
| ); |
Parameters
hdc
Identifies the device context where drawing takes place.
nLeftRect
Specifies the logical x-coordinate of the upper-left corner of the bounding rectangle.
nTopRect
Specifies the logical y-coordinate of the upper-left corner of the bounding rectangle.
nRightRect
Specifies the logical x-coordinate of the lower-right corner of the bounding rectangle.
nBottomRect
Specifies the logical y-coordinate of the lower-right corner of the bounding rectangle.
nXRadial1
Specifies the logical x-coordinate of the endpoint of the radial defining the starting point of the arc.
nYRadial1
Specifies the logical y-coordinate of the endpoint of the radial defining the starting point of the arc.
nXRadial2
Specifies the logical x-coordinate of the endpoint of the radial defining the ending point of the arc.
nYRadial2
Specifies the logical y-coordinate of the endpoint of the radial defining the ending point of the arc.
Return Values
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.
See Also