1
1
Fork 0
mirror of https://github.com/QB64-Phoenix-Edition/QB64pe.git synced 2024-07-05 22:50:23 +00:00
QB64-PE/internal/help/_SCREENEXISTS__111111111111.txt
Roland Heyder 6912727753 Update help files
Help file snapshot as of 07/31/2022.
2022-07-31 23:57:56 +02:00

36 lines
967 B
Plaintext

{{QBDLDATE:07-31-2022}}
{{QBDLTIME:23:39:48}}
{{DISPLAYTITLE:_SCREENEXISTS}}
The [[_SCREENEXISTS]] function returns true (-1) once a screen has been created.
{{PageSyntax}}
: {{Parameter|screenReady%%}} = [[_SCREENEXISTS]]
{{PageDescription}}
* Function returns true (-1) once a program screen is available to use or change.
* Can be used to avoid program errors because a screen was not ready for input or alterations.
** Use before [[_TITLE]], [[_SCREENMOVE]] and other functions that require the output window to have been created.
{{PageExamples}}
;Example:Waiting in a loop until the screen exists to add the title. The [[_LIMIT]] prevents the loop from using all CPU time while waiting.
{{CodeStart}}
{{Cl|SCREEN}} 12
{{Cl|DO}}: {{Cl|_LIMIT}} 10: {{Cl|LOOP}} {{Cl|UNTIL}} {{Cl|_SCREENEXISTS}}
{{Cl|_TITLE}} "My Title"
{{CodeEnd}}
{{PageSeeAlso}}
* [[_FULLSCREEN]]
* [[_SCREENIMAGE]]
* [[$CONSOLE]]
* [[$RESIZE]]
{{PageNavigation}}
[[Category:Final]]