LOCATE

Function

LOCATE sets the text cursor on the screen.

Syntax

LOCATE x,y

Maximum Value

Character Set	X	Y
Text mode	79	23
Char 0	239	63
Char 1	30	5
Char 2	30	5
Char 3	30	5
Char 4	30	5

Example

10 LOCATE 0,0

Places the cursor in the top left-hand corner.

Remarks

LOCATE is most useful for locating the cursor before printing text onto the display. LOCATE operates differently in text mode and graphics mode.

Text Mode:

Addressing a location outside the current window will cause the window to move so that the new cursor position is visible.

The maximum values for the parameters are X = 79 and Y = 23, being the size of the virtual screen.

Values greater than the maximum for X will cause wrap-around on the same line. Values greater than the maximum for Y will remain at the bottom of the screen.

Graphics Mode:

A SCREEN 1 command will reset the cursor to the origin at (0,0). When character set zero is selected the LOCATE co-ordinates are referenced to the graphics pixel position. Otherwise, the co-ordinates specified in LOCATE refer to the top left hand pixel of a 7 x 5 character cell, the size of which is equivalent to a CHAR1 character.