CSRLIN

From QB64.org wiki
Jump to: navigation, search

The CSRLIN function returns the current text row position of the PRINT cursor.


Syntax

row% = CSRLIN


Description

  • The value returned is within the range of 1 to the current number of rows in the SCREEN mode used.
    • In SCREEN 0 (text mode), the _HEIGHT function returns the number of text rows.
    • In graphic modes, the number of available text rows can be calculated by dividing _HEIGHT (measured in pixels in graphic modes) by _FONTHEIGHT: totalRows% = _HEIGHT / _FONTHEIGHT
  • In screen modes that support page flipping, the CSRLIN function returns the vertical coordinate of the cursor on the active page.
  • x = POS(0) returns the column location of the cursor.


Examples

Example: A semicolon stops the print cursor immediately after the print.

LOCATE 5, 5: PRINT "HELLO "; Y = CSRLIN 'save the row X = POS(0) 'save the column LOCATE 10, 10: PRINT "WORLD" LOCATE Y, X 'restore saved position PRINT "GOODBYE"

HELLO GOODBYE WORLD

Explanation: "HELLO " is printed and the semicolon stops the cursor immediately after the text. The CSRLIN variable records the current print cursor's text row in Y. The POS function records the current print cursor's text column in X. The second PRINT statement displays the comment "WORLD" on the 10th line of the screen. The last LOCATE statement restores the position of the cursor to the original line and column immediately after the first print.


See also



Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page