Click above to get retro games delivered to your door ever month!

ENTER_PNT()                                                         C_EXAM11
ENTER_FLAG()
ENTER_TYPE()
   Allows the user to enter the exact point when drawing objects.

   Syntax
         ENTER_FLAG(nFlag)
         ENTER_PNT()
         nDrawType = ENTER_TYPE()

   Arguments
         nFlag       Sets the flag for object drawing options. (see table
                                                                & description)

   Returns
         nDrawType   Object number type being drawn.

   Description
         ENTER_PNT() is a Clipper PRG file that is called from MS_OBJECT()
         while you are drawing an object and the EnterKey (default ASCII 13,
         see CAD_SETUP()) is pressed. It allows you to enter the exact
         location of a point manually, whereas the mouse position may be
         slightly off.

         Line and box objects complete the drawing and return from the
         ENTER_PNT(). The polyline anchors the end of the line to the points
         entered, then allows the system to continue drawing.

         Two other functions can be used in combination with the ENTER_PNT()
         function to enhance its actions. ENTER_FLAG() allows you to modify
         what MS_OBJECT() does when you return from ENTER_PNT(). The normal
         condition in a polyline figure, for example, is to anchor the line at
         that point entered within ENTER_PNT(), then allows another section of
         the line to be drawn with the mouse. However, you may wish to end the
         line, or abort all together. The following table shows the flags that
         can be returned to MS_OBJECT() from ENTER_PNT() to modify its default
         action.
       +--------------------------------------------------------------------+
       | Flag            |Description                                       |
       ------------------+--------------------------------------------------|
       | 0               |Continue with no effect.                          |
       | 1 or 4 [default]|Anchor and continue if object is polyline or exit |
       |                 |if other object.                                  |
       | 2               |Snap to nearest object hot point or grid point.   |
       | 3               |Cancel last drawing.                              |
       +--------------------------------------------------------------------+
         ENTER_TYPE() allows you to return the current type of object you are
         drawing. This can help you furthur customize how ENTER_PNT() will
         work.