GRABSCRN()      Captures the contents of the screen

Description:
  GRABSCRN() is actually nothing more than a greatly improved version of
  Clipper's 'SAVE SCREEN' command. GRABSCRN() captures not only the
  screen image, but also the screen attributes, cursor location, etc.
  GRABSCRN() is designed to be used in conjunction with PUTSCRN().


Syntax:     
  GRABSCRN()


Pass:       
  Nothing


Return:     
  Summer 87:
     <expL>   = Always true

  Version 5.0:
     Always NIL


Notes:      


Example:    
  GRABSCRN()
     _msg[1] = "Please wait while printing"
     DISPMSG(_msg,1,"","")
     DO RPT_PRGM
  PUTSCRN()
  .
  .
  .


Usage:      
  Clipper's SAVE SCREEN command doesn't quite fit the bill for most
  screen save operations.  i.e.  it doesn't save the cursor location or
  screen attributes (colors). GRABSCRN() saves all of these very
  important aspects of your screen and will restore them properly when
  you call PUTSCRN().