GETSCRSTR()
 Queries screen output that was redirected by SETSCRSTR()
------------------------------------------------------------------------------
 Syntax

     GETSCRSTR() --> cHiddenCharacterstring

 Returns

     GETSCRSTR() returns the content of the internal memory area determined
     by SETSCRSTR().

 Description

     GETSCRSTR() returns the contents of the internal memory area (determined
     by SETSCRSTR(.T.)) for hidden screen output .  This return value has a
     length that always corresponds to SCREENSIZE(.T.).  You can pass it to a
     variable and after the mode is switched off, transfer it to the CA-
     Clipper RESTSCREEN() function.  The variable must be passed before the
     redirected output mode is shut off with SETSCRSTR(.F.).  Otherwise, the
     internal memory area is deallocated and GETSCRSTR() returns a null
     string.

 Note

     .  Since the entire screen output is always redirected
        (independent of its actual size), you should always call RESTSCREEN()
        with the maximum coordinates of 0, 0, MAXROW(), and MAXCOL()

 Examples

     .  Show hidden output, switched back to the physical screen, if
        the need should arise:

        WSELECT(0)
        ? SETSCRSTR(.T.)            // .T., when mode on
        @ 10, 10 SAY "XXXXXXX"      // Normal screen output
           *...
        @ 15, 10 SAY "YYYYYYY"

     .  Always call the GETSCRSTR() function before SETSCRSTR(.F.)

        cVar  :=  GETSCRSTR()
        ? SETSCRSTR(.F.)            // .F. when mode off
        RESTSCREEN(0, 0, MAXROW(), MAXCOL(), cVar)