1
1
Fork 0
mirror of https://github.com/QB64-Phoenix-Edition/QB64pe.git synced 2024-06-29 11:40:38 +00:00
QB64-PE/internal/help/POS.txt
SteveMcNeill 33adc04fc4 Add temp folder to repo. It's necessary as well!
Just more initial setting on... nothing much to see here.
2022-04-28 13:39:56 -04:00

37 lines
1.5 KiB
Plaintext

The '''POS''' function returns the current print cursor text column position.
{{PageSyntax}}
:: column% = POS(0)
* The value in parenthesis is normally 0, but any numerical value or variable could be used for compatibility with Basic.
* When a semicolon ends the previous PRINT statement the cursor column position will be after the last character printed.
* If [[TAB]] or a comma is used the column position will be immediately after the tabbed position normally 9 spaces after text
* If a [[PRINT]] statement does not use a semicolon or comma at the end, the return value will be 1 on the next row.
* Column position returned can be saved to return to a previous print position later using [[LOCATE]].
''Example:'' Column positions after prints.
{{CodeStart}} '' ''
{{Cl|PRINT}} {{Cl|POS}}(0) 'column position always starts on 1 at top of new or after {{Cl|CLS}}
{{Cl|PRINT}} "hello"; 'column position is 6 on same row immediately after text
{{Cl|PRINT}} {{Cl|POS}}(0)
{{Cl|PRINT}} 'start new row
{{Cl|PRINT}} "hello", 'column position is 15 on same row (normally tabs 9 spaces)
{{Cl|PRINT}} {{Cl|POS}}(0)
{{Cl|PRINT}} 'start new row
{{Cl|PRINT}}
{{Cl|PRINT}} {{Cl|POS}}(0) ' column position is 1 on next row '' ''
{{CodeEnd}}
''Note:'' Column tab prints may not always move 9 spaces past the center of the screen. Some may move text to next row.
''See also:''
* [[CSRLIN]], [[LOCATE]], [[PRINT]]
* [[_PRINTSTRING]] {{text|(graphic position print)}}
{{PageNavigation}}
<