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

44 lines
1.7 KiB
Plaintext

{{QBDLDATE:07-31-2022}}
{{QBDLTIME:23:39:21}}
{{DISPLAYTITLE:_PRINTMODE}}
The [[_PRINTMODE]] statement sets the text or [[_FONT]] printing mode on an image when using [[PRINT]] or [[_PRINTSTRING]].
{{PageSyntax}}
: [[_PRINTMODE]] {''_KEEPBACKGROUND''|''_ONLYBACKGROUND''|''_FILLBACKGROUND''}[, {{Parameter|imageHandle&}}]
{{Parameters}}
* One of 3 mode keywords is mandatory when using this statement to deal with the text background.
**''_KEEPBACKGROUND'' (mode 1): Text background transparent. Only the text is displayed over anything behind it.
**''_ONLYBACKGROUND'' (mode 2): Text background only is displayed. Text is transparent to anything behind it.
**''_FILLBACKGROUND'' (mode 3): Text and background block anything behind them like a normal [[PRINT]]. '''Default setting.'''
* If the optional {{Parameter|imageHandle&}} is omitted or is 0 then the setting will be applied to the current [[_DEST|destination]] image.
{{PageDescription}}
* Use the [[_PRINTMODE (function)]] to find the current [[_PRINTMODE]] setting mode number for an image.
* '''The _PRINTMODE statement and function can only be used on graphic images, not text-based ones such as SCREEN 0'''
{{PageExamples}}
''Example:'' Using _PRINTMODE with [[PRINT]] in a graphic screen mode. The background used is CHR$(219) = █
{{CodeStart}}
{{Cl|SCREEN (statement)|SCREEN}} 12
{{Cl|COLOR}} 8: {{Cl|LOCATE}} 10, 10: {{Cl|PRINT}} {{Cl|STRING$}}(3, 219) 'background
{{Cl|_PRINTMODE}} _KEEPBACKGROUND
{{Cl|COLOR}} 15: {{Cl|LOCATE}} 10, 10: {{Cl|PRINT}} {{Cl|_PRINTMODE}}
{{Cl|END}}
{{CodeEnd}}
{{PageSeeAlso}}
* [[_PRINTMODE (function)]]
* [[_PRINTSTRING]]
* [[_LOADFONT]]
* [[_NEWIMAGE]]
* [[PRINT]], [[_PRINT USING]]
{{PageNavigation}}