ScreenStr() - Grabs a string with attributes from the screen
 Reads a string, including attributes, from the screen
──────────────────────────────────────────────────────────────────────────────

 Syntax

     ScreenStr( [<nRow>], [<nCol>], [<nChars>] ) --> cChar

 Arguments

     <nRow> is the row to start redaing from. The default is the cursor line.

     <nCol> is the column to start reading from.  The default is the cursor
     column.

     <nChars> is the number of charceters to read, excluding colour
     attributes. The default is to the end of the active window.

 Returns

     ScreenStr() retruns a string filled with characters and colour
     attributes.

 Description

     ScreenStr() returns a string of characters values and colour attributes
     from the active window.

 Notes

     ■  The returned character string contains all the attribute
        bytes.  For the entire screen, a variable that is 25 lines by 80
        columns, is a total of 4000 characters.

     ■  This function does not alter the cursor position.

 Examples

     ■  Grab the entire active window:

        cStr: = ScreenStr(0,0)

 Files:  Library is MRWINDOW.LIB.