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

 ERASTEXT() 

          If you've ever constructed a screen using the Clipper BOX command
          you know that it can be difficult to remember where the box border
          stops and your text begins, especially if you only want to erase a
          few lines of the text.  Generating FOR...NEXT loops to erase only
          that portion of an enclosed area is no fun.  Enter ERASTEXT, which
          will erase all standard ASCII characters (text & numbers) from
          within the requested area.  Simply specify the coordinates and
          "zap" all the text is gone.  Does not affect the attribute in use
          at the time.


      Format: 

               erastext(top,left,bottom,right [,type])


      Parameters: 

               top.......Numeric variable or constant indicating the top row
                         of the area to be changed.  Value checked to be
                         between 0 and 24 inclusive.

               left......Numeric variable or constant indicating the left
                         column of the area to be changed.  Value checked to
                         be between 0 and 79 inclusive.

               bottom....Numeric variable or constant indicating the ending
                         row of the area to be changed.  Value checked to be
                         greater than TOP but less than or equal to 24.

               right.....Numeric variable or constant indicating the right
                         column of the area to be changed.  Value checked to
                         be greater than LEFT but less than or equal to 79.

             type... OPTIONAL. Logical variable or constant instructing
                         the function to use DMA updating or not.

                         .T.            DEFAULT.  If not specified, the
                                        function will use DMA screen
                                        updating.

                         .F.            Setting this flag to a logical false
                                        will cause the function to use the
                                        standard BIOS INT 10H for screen
                                        updating.

      Examples: 

               1.   Erase a video line without affecting the BOX borders
                    around the line.

                    .
                    .
                    .
                    @ 08,20,16,60 box '(special characters)'
                    @ 09,21 say (something useful)
                    @ 10,21 say (something useful)
                    @ 11,21 say (something useful)
                    @ 12,21 say (something useful)
                    @ 13,21 say (something useful)
                    .
                    .
                    .
                    erastext(11,20,13,60)
                    .
                    .
                    .


      Returns: 

               Nothing.


      Cautions: 

               None.