[<<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