1
1
Fork 0
mirror of https://github.com/QB64Official/qb64.git synced 2024-07-20 19:45:15 +00:00
qb64/internal/help/_HEIGHT.txt
Luke Ceddia b586eafd3b Integrated _BLINEINPUT into regular LINE INPUT for BINARY files
LINE INPUT will now use the faster method if passed a file handle
that has been opened FOR BINARY. As such, the _BLINEINPUT command
has been removed.

qb64.bas now takes advantage of this for reading from '$include files,
at least in Include Manager 1. Some tweaking of internal/source/main.txt
was required to get things into a sane state, so I'm holing off changing
the compiler any further so the auto-builder can make sure everything's
smoothed over.

Note: Everything should still compile as normal; I'm just being overcautious.
2014-07-27 00:06:17 +10:00

34 lines
1.2 KiB
Plaintext

The {{KW|_HEIGHT}} function returns the height of an image handle or current write page.
{{PageSyntax}}
:''result&'' = {{KW|_HEIGHT}}[({{Parameter|imageHandle&}})]
{{PageDescription}}
* If {{Parameter|imageHandle&}} is omitted, it's assumed to be the handle of the current write page.
* To get the width of the current program window use zero for the handle value: depth& = _HEIGHT(0)
* If the image specified by {{Parameter|imageHandle&}} is in text mode, the number of characters per column is returned.
* If the image specified by {{Parameter|imageHandle&}} is in graphics mode, the number of pixels per column is returned.
* If {{Parameter|imageHandle&}} is an invalid handle, then an [[ERROR Codes|invalid handle]] error will occur.
* The maximum pixel coordinate of a program [[SCREEN|screen]] is one less than what the function returns.
''Example:'' Displays the current program window area.
{{CodeStart}} '' ''
{{Cl|SCREEN}} 12
wide = {{Cl|_WIDTH (function)|_WIDTH}}
deep = {{Cl|_HEIGHT}}
{{Cl|PRINT}} "The program screen is"; wide; "X"; deep '' ''
{{CodeEnd}}
{{PageSeeAlso}}
* [[_WIDTH (function)]]
* [[_LOADIMAGE]]
* [[_FONTHEIGHT]]
* [[Bitmaps]]
{{PageNavigation}}