VS_GrabScr()         Captures the contents of the screen

Description:

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

Syntax:     

  VS_GrabScr()

Pass:       

  Nothing

Return:     

  VS_GrabScr() always returns NIL.

Notes:      


Example:    

  VS_GRABSCR()
     ac_msg[1] = "Please wait while printing"
     VS_MSG(ac_msg,1,"","")
     DO RPT_PRGM
  VS_PUTSCR()

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). VS_GRABSCR() saves all of these very
  important aspects of your screen and will restore them properly when
  you call VS_PUTSCR().