mirror of
https://github.com/QB64-Phoenix-Edition/QB64pe.git
synced 2024-07-04 04:50:22 +00:00
aeb9c0668b
Note: Many files were removed (not yet existing/empty pages). The parser will try to download them on demand and will auto-generate text for missing pages (eg. most _gl pages).
54 lines
1.7 KiB
Plaintext
54 lines
1.7 KiB
Plaintext
{{QBDLDATE:05-20-2022}}
|
|
{{QBDLTIME:23:12:28}}
|
|
The [[CSRLIN]] function returns the current text row position of the [[PRINT]] cursor.
|
|
|
|
|
|
|
|
{{PageSyntax}}
|
|
: {{Parameter|row%}} = [[CSRLIN]]
|
|
|
|
|
|
{{PageDescription}}
|
|
* 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.
|
|
|
|
|
|
{{PageExamples}}
|
|
''Example:'' A semicolon stops the print cursor immediately after the print.
|
|
{{CodeStart}}
|
|
LOCATE 5, 5: PRINT "HELLO ";
|
|
Y = {{Cl|CSRLIN}} 'save the row
|
|
X = {{Cl|POS}}(0) 'save the column
|
|
LOCATE 10, 10: PRINT "WORLD"
|
|
LOCATE Y, X 'restore saved position
|
|
PRINT "GOODBYE"
|
|
{{CodeEnd}}
|
|
|
|
{{OutputStart}}
|
|
|
|
|
|
|
|
|
|
HELLO GOODBYE
|
|
|
|
|
|
|
|
|
|
WORLD
|
|
|
|
|
|
{{OutputEnd}}
|
|
:''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.
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[SCREEN]], [[LOCATE]], [[POS]]
|
|
* [[_PRINTSTRING]] (graphic print)
|
|
|
|
|
|
{{PageNavigation}}
|
|
|