qb45advr.hlp (Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
LOCATE Statement Details
  QuickSCREEN      Details      Example      Contents      Index
──────────────────────────────────────────────────────────────────────────────
LOCATE Statement Details
 
Syntax
  LOCATE [row][,[column][,[cursor][,[start,stop]]]]
 
  Argument   Description
  row        The number of a row on the screen; row is a numeric
             expression returning an integer. If row is not specified,
             then the line (row) does not change.
  column     The number of a column on the screen; column is a numeric
             expression returning an integer. If column is not
             specified, then the column location does not change.
  cursor     A Boolean value indicating whether the cursor is visible
             or not. A value of 0 (zero) indicates cursor off; a value
             of 1 indicates cursor on.
  start      The starting scan line of cursor on the screen. It must
             be a numeric expression returning an integer.
  stop       The ending scan line of cursor on the screen. It must be
             a numeric expression returning an integer.
 
You may omit any argument from the statement. When you omit the row
or column, LOCATE leaves the cursor at the row or column where it was
moved by a previous LOCATE or a previous input or output statement,
whichever occurred most recently. When you omit other arguments,
QuickBASIC assumes the previous value for the argument.
 
Note that the start and stop lines are the CRT scan lines that specify
which pixels on the screen are lit. A wider range between the start
and stop lines produces a taller cursor, such as one that occupies an
entire character block. When start is less than stop, LOCATE produces
a two-part cursor. If the start line is given, stop must also be
specified.
 
The last line on the screen is reserved for the soft-key display and
is not accessible to the cursor unless the soft-key display is off
(KEY OFF) and LOCATE is used with PRINT to write on the line.