[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
Pie( hDC, nLeft, nTop, nRight, nBottom,;
nxStartArc, nyStartArc, nxEndArc, nyEndArc ) -> <lSuccess>
------------------------------------------------------------------------------
PARAMETER:
<hDC> handle that identifies a device context
<nLeft> left col bounding rectangle
<nTop top row bounding rectangle
<nRight> right col bounding rectangle
<nBottom> bottom bounding rectangle
<nXStartArc> arc starting col
<nYStartArc> arc starting row
<nXEndArc> arc ending col
<nYEndArc> arc ending row
RETURNS:
<lSuccess> is TRUE if the operation was successful.
DESCRIPTION:
The Pie function draws a pie-shaped wedge by drawing an elliptical arc
whose center and two endpoints are joined by lines.
The center of the arc drawn by the Pie function is the center of the
bounding rectangle specified by the <nLeft>, <nTop>, <nRight> and <nBottom>
parameters. The starting and ending points of the arc are specified by
the <nxStartArc>, <nyStartArc>, <nxEndArc>, and <nyEndArc> parameters.
The function draws the arc by using the selected pen, moving in a
counter-clockwise direction. It then draws two additional lines from each
endpoint to the arc's center.
Finally, it fills the pie-shaped area by using the current brush.
If nxStartArc equals nxEndArc and nyStartArc equals nyEndArc, the result
is an ellipse with a single line from the center of the ellipse to the
point (nxStartArc,nyStartArc) or (nxEndArc,nyEndArc).
The figure drawn by this function extends up to but does not include the
right and bottom coordinates. This means that the height of the figure is
nBottom - nTop and the width of the figure is nRight - nLeft. Both the
width and the height of a rectangle must be greater than 2 units and less
than 32,767 units.
EXAMPLE:
+-------------------------------------------------------------+
| /* Draw a pie on the window */ |
| hDC := GetDC( oWnd:hWnd ) |
| Pie( hDC, 10, 10, 100, 100, 0, 0, 15, 15 ) |
+-------------------------------------------------------------+
SOURCE:
SOURCE\WINAPI\DRAWING.C
See Also:
Ellipse
hDC
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson