GWBASIC User's Manual

GW-BASIC User's Guide
SCREEN Function
Purpose:
To return the ASCII code (0-255) for the character at the specified row (line) and column on the
screen.
Syntax:
x=SCREEN(row,col[,z])
Comments:
x is a numeric variable receiving the ASCII code returned.
row is a valid numeric expression within the range 1 to 25.
col is a valid numeric expression 1 to 40, or 1 to 80, depending upon screen width setting. See
the WIDTH statement.
z is a valid numeric expression with a true or false value. It may be used only in alpha mode.
The ordinal of the character at the specified coordinates is stored in the numeric variable. In alpha
mode, if the optional parameter z is given and is true (nonzero), the color attribute for the
character is returned instead of the ASCII code for the character (see the COLOR statement).
Any values entered outside of the range indicated result in an "Illegal function call"
error. Row 25 may be referenced only if the function key is off.
Examples:
100 X=SCREEN (10, 10)
If the character at 10,10 is A, then X is 65.
110 X=SCREEN (1, 1, 1)
Returns the color attribute of the character in the upper-left corner of the screen.
file:///C|/Documents%20and%20Settings/Lorenzo/Desktop/GW%20Basic/SCREENF.html28/03/2004 21.29.46