mirror of
https://github.com/QB64-Phoenix-Edition/QB64pe.git
synced 2024-07-04 06:00:23 +00:00
aeb9c0668b
Note: Many files were removed (not yet existing/empty pages). The parser will try to download them on demand and will auto-generate text for missing pages (eg. most _gl pages).
28 lines
1.1 KiB
Plaintext
28 lines
1.1 KiB
Plaintext
{{QBDLDATE:05-20-2022}}
|
|
{{QBDLTIME:23:08:34}}
|
|
{{DISPLAYTITLE:_HEIGHT}}
|
|
The [[_HEIGHT]] function returns the height of an image handle or of the current write page.
|
|
|
|
|
|
{{PageSyntax}}
|
|
: {{Parameter|columns&}} = [[_HEIGHT]][({{Parameter|imageHandle&}})]
|
|
|
|
|
|
{{PageDescription}}
|
|
* If {{Parameter|imageHandle&}} is omitted, it's assumed to be the handle of the current [[SCREEN]] or write page.
|
|
* To get the height of the current program [[SCREEN|screen]] window use zero for the handle value or nothing: {{Parameter|lines&}} = [[_HEIGHT]](0) ''or'' {{Parameter|lines&}} = [[_HEIGHT]]
|
|
* If the image specified by {{Parameter|imageHandle&}} is in text only([[SCREEN]] 0) mode, the number of characters per row is returned.
|
|
* If the image specified by {{Parameter|imageHandle&}} is in graphics mode, the number of pixels per row is returned.
|
|
* If {{Parameter|imageHandle&}} is an invalid handle, then an [[ERROR Codes|invalid handle error]] is returned.
|
|
* The last visible pixel coordinate of a program [[SCREEN|screen]] is '''[[_HEIGHT]] - 1'''.
|
|
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[_WIDTH (function)]], [[_LOADIMAGE]], [[_NEWIMAGE]]
|
|
* [[Bitmaps]]
|
|
|
|
|
|
{{PageNavigation}}
|
|
|