1
1
Fork 0
mirror of https://github.com/QB64-Phoenix-Edition/QB64pe.git synced 2024-06-29 10:30:36 +00:00
QB64-PE/internal/help/_ALLOWFULLSCREEN.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

78 lines
2.7 KiB
Plaintext

{{DISPLAYTITLE:_ALLOWFULLSCREEN}}
The [[_ALLOWFULLSCREEN]] statement allows setting the behavior of the ALT+ENTER combo.
{{PageSyntax}}
: [[_ALLOWFULLSCREEN]] [{_STRETCH|_SQUAREPIXELS|OFF|_ALL}][, {_SMOOTH|OFF|_ALL}]
{{PageDescription}}
* Calling the statement with no parameters enables all four possible full screen modes (and is the default state when a program is started): both [[_STRETCH]] ([[_SMOOTH]] and [[_OFF]]) and [[_SQUAREPIXELS]] ([[_SMOOTH]] and [[_OFF]]).
** Using [[_ALLOWFULLSCREEN]] [[_ALL]], [[_ALL]] has the same effect.
* [[_ALLOWFULLSCREEN]] only affects the behavior of ALT+ENTER. The [[_FULLSCREEN]] statement is not bound by [[_ALLOWFULLSCREEN]]'s settings so all modes can be accessed programmatically.
* To limit just the mode but allow both _SMOOTH + _OFF antialiasing modes, pass just the first parameter: ''Example:'' [[_ALLOWFULLSCREEN]] _SQUAREPIXELS
* To allow multiple modes with _SMOOTH or _OFF as default, pass just the second parameter. ''Example:'' [[_ALLOWFULLSCREEN]] , _SMOOTH
* Any possible permutation of the parameters is allowed.
* With [[_ALLOWFULLSCREEN]] _OFF you can trap Alt+Enter manually in your program and reassign it. See example 2 below.
==Availability==
* '''Version 1.3 and up'''.
{{PageExamples}}
''Example 1:'' Allowing only one fullscreen mode with square pixels and no antialiasing:
{{CodeStart}}
{{Cl|_ALLOWFULLSCREEN}} {{Cl|_SQUAREPIXELS}}, {{Cl|OFF}}
{{CodeEnd}}
''Example 2:'' Disabling _FULLSCREEN with Alt+ENTER so the combo can be manually trapped:
{{CodeStart}}
{{Cl|DO}}
{{Cl|CLS}}
{{Cl|LOCATE}} 7
{{Cl|PRINT}} " - Press ALT+ENTER to test trapping the combo..."
{{Cl|PRINT}} " _ Press SPACEBAR to allow fullscreen again..."
k& = {{Cl|_KEYHIT}}
{{Cl|IF}} k& = 13 {{Cl|THEN}}
{{Cl|IF}} {{Cl|_KEYDOWN}}(100307) {{Cl|OR}} {{Cl|_KEYDOWN}}(100308) {{Cl|THEN}}
altEnter = altEnter + 1
{{Cl|END IF}}
{{Cl|ELSEIF}} k& = 32 {{Cl|THEN}}
fullscreenEnabled = {{Cl|NOT}} fullscreenEnabled
{{Cl|END IF}}
{{Cl|LOCATE}} 14
{{Cl|IF}} fullscreenEnabled {{Cl|THEN}}
{{Cl|_ALLOWFULLSCREEN}} {{Cl|_ALL}}, {{Cl|_ALL}}
altEnter = 0
{{Cl|PRINT}} "_ALLOWFULLSCREEN _ALL, _ALL"
{{Cl|LOCATE}} 18
{{Cl|PRINT}} "ALT+ENTER will trigger all four fullscreen modes now."
{{Cl|ELSE}}
{{Cl|_ALLOWFULLSCREEN}} {{Cl|OFF}}
{{Cl|PRINT}} "_ALLOWFULLSCREEN OFF"
{{Cl|END IF}}
{{Cl|IF}} altEnter {{Cl|THEN}}
{{Cl|LOCATE}} 18
{{Cl|PRINT}} "ALT+ENTER manually trapped"; altEnter; "times."
{{Cl|END IF}}
{{Cl|_DISPLAY}}
{{Cl|_LIMIT}} 30
{{Cl|LOOP}}
{{CodeEnd}}
{{PageSeeAlso}}
* [[_FULLSCREEN]], [[_SMOOTH (function)]]
{{PageNavigation}}
<