Pie
The Pie
function draws a pie-shaped wedge bounded by the intersection of an ellipse and
two radials. The pie is outlined by using the current pen and filled by using
the current brush.
BOOL Pie(
|
HDC hdc, |
// handle to device
context |
|
int nLeftRect, |
// x-coord. of
bounding rectangle s upper-left corner |
|
int nTopRect, |
// y-coord. of
bounding rectangle s upper-left corner |
|
int nRightRect, |
// x-coord. of
bounding rectangle s lower-right corner
|
|
int nBottomRect, |
// y-coord. of
bounding rectangle s lower-right corner
|
|
int nXRadial1, |
// x-coord. of
first radial s endpoint |
|
int nYRadial1, |
// y-coord. of
first radial s endpoint |
|
int nXRadial2, |
// x-coord. of
second radial s endpoint |
|
int nYRadial2 |
// y-coord. of
second radial s endpoint |
|
); |
|
Parameters
hdc
Identifies
the device context.
nLeftRect
Specifies the
x-coordinate of the upper-left corner of the bounding rectangle.
nTopRect
Specifies the
y-coordinate of the upper-left corner of the bounding rectangle.
nRightRect
Specifies the
x-coordinate of the lower-right corner of the bounding rectangle.
nBottomRect
Specifies the
y-coordinate of the lower-right corner of the bounding rectangle.
nXRadial1
Specifies the
x-coordinate of the endpoint of the first radial.
nYRadial1
Specifies the
y-coordinate of the endpoint of the first radial.
nXRadial2
Specifies the
x-coordinate of the endpoint of the second radial.
nYRadial2
Specifies the
y-coordinate of the endpoint of the second radial.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
The curve of
the pie is defined by an ellipse that fits the specified bounding rectangle.
The curve begins at the point where the ellipse intersects the first radial and
extends counterclockwise to the point where the ellipse intersects the second
radial. (A radial is a line drawn from the center of the ellipse to the
specified endpoint on the ellipse.)
The current
position is neither used nor updated by the Pie function.
Windows
95: The sum of the coordinates of the
bounding rectangle cannot exceed 32,767. The sum of nLeftRect and nRightRect
or nTopRect and nBottomRect parameters cannot exceed 32,767.
See Also