Microsoft Foundation Classes (mfc.hlp) (Table of Contents; Topic list)
CDC::Arc
CDC                                         Up Contents Index Back
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  BOOL Arc( int x1, int y1, int x2, int y2, int x3, int y3, int x4,
            int y4 );
  BOOL Arc( LPRECT lpRect, POINT ptStart, POINT ptEnd );
 
  Parameter   Description
 
  <x1>        Specifies the x-coordinate of the upper-left corner of the
              bounding rectangle (in logical units).
 
  <y1>        Specifies the y-coordinate of the upper-left corner of the
              bounding rectangle (in logical units).
 
  <x2>        Specifies the x-coordinate of the lower-right corner of the
              bounding rectangle (in logical units).
 
  <y2>        Specifies the y-coordinate of the lower-right corner of the
              bounding rectangle (in logical units).
 
  <x3>        Specifies the x-coordinate of the point that defines the
              arc's starting point (in logical units). This point does not
              have to lie exactly on the arc.
 
  <y3>        Specifies the y-coordinate of the point that defines the
              arc's starting point (in logical units). This point does not
              have to lie exactly on the arc.
 
  <x4>        Specifies the x-coordinate of the point that defines the
              arc's endpoint (in logical units). This point does not have
              to lie exactly on the arc.
 
  <y4>        Specifies the y-coordinate of the point that defines the
              arc's endpoint (in logical units). This point does not have
              to lie exactly on the arc.
 
  <lpRect>    Specifies the bounding rectangle (in logical units). You can
              pass either a LPRECT or a CRect object for this
              parameter.
 
  <ptStart>   Specifies the x- and y-coordinates of the point that defines
              the arc's starting point (in logical units). This point does
              not have to lie exactly on the arc. You can pass either a
              POINT structure or a CPoint object for this parameter.
 
  <ptEnd>     Specifies the x- and y-coordinates of the point that defines
              the arc's ending point (in logical units). This point does
              not have to lie exactly on the arc. You can pass either a
              POINT structure or a CPoint object for this parameter.
 
  Remarks
 
  Draws an elliptical arc. The arc drawn by using the function is a
  segment of the ellipse defined by the specified bounding rectangle.
 
  The actual starting point of the arc is the point at which a ray drawn
  from the center of the bounding rectangle through the specified starting
  point intersects the ellipse. The actual ending point of the arc is the
  point at which a ray drawn from the center of the bounding rectangle
  through the specified ending point intersects the ellipse. The arc is
  drawn in a counterclockwise direction. Since an arc is not a closed
  figure, it is not filled.
 
  Return Value
 
  TRUE if the arc is drawn; otherwise FALSE.
 
  See Also
 
  CDC::Chord, ::Arc
 
 
                                     -♦-