SCREEN Function
 ----------------------------------------------------------------------------


 Action

 Reads a specified character's ASCII value or its color from a specified
 screen location.


 Syntax



  SCREEN( line%,  column% ,  colorflag%)

 Remarks


 The  SCREEN function uses the following arguments.

-----------------------------------------------------------------------------
 Argument                                Description
 ----------------------------------------------------------------------------
  line%                                  The line number of the character
                                         location on the screen. The
                                         argument  line% is an integer
                                         expression whose valid range
                                         depends on the number of lines on
                                         screen.

  column%                                The column number of the character
                                         location on the screen. The
                                         argument  column% is an integer
                                         expression with a value between 1
 Argument                                Description
 ----------------------------------------------------------------------------
                                         expression with a value between 1
                                         and 80, inclusive.

  colorflag%                             A numeric expression that
                                         determines which information is
                                         returned. When  colorflag% is
                                         nonzero,  SCREEN returns the
                                         number of the color attribute at
                                         the screen location. If
                                         colorflag% is 0 or is absent, the
                                         SCREEN function returns the ASCII
                                         character code.






 Note

 In graphics screen modes, if the pattern on the screen at the given
 character location does not exactly match any pattern in the current ASCII
 character set, the  SCREEN function will return the ASCII code for a space.
 If  colorflag% is nonzero, the  SCREEN function will return 0.


 See Also

 Appendix A, "Keyboard Scan Codes and ASCII Character Codes,"  COLOR,
 PALETTE,  SCREEN Statement


 Examples

 If the character at (10,10) is A, then the following statement would return
 65, the ASCII code for A, to the variable X.

 X = SCREEN(10,10)

 The following statement returns the color attribute of the character in the
 upper-left corner of the screen.

 X = SCREEN(1, 1, 1)