ULINESPACING: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
m (Add _UCHARPOS to "See Also")
No edit summary
Line 1: Line 1:
{{DISPLAYTITLE:_ULINESPACING}}
{{DISPLAYTITLE:_ULINESPACING}}
The '''_ULINESPACING''' function returns the vertical line spacing (distance between two consecutive baselines) in pixels.
The '''_ULINESPACING''' function returns the vertical line spacing (distance between two consecutive baselines) in pixels.


{{PageSyntax}}
{{PageSyntax}}
: {{Parameter|pixels&}} = [[_ULINESPACING]][({{Parameter|fontHandle&}})]
: {{Parameter|pixels&}} = [[_ULINESPACING]][({{Parameter|fontHandle&}})]


{{PageParameters}}
{{PageParameters}}
* {{Parameter|fontHandle&}} is an optional font handle.
* {{Parameter|fontHandle&}} is an optional font handle.


{{PageDescription}}
{{PageDescription}}
Line 12: Line 15:
* If no font is set, it returns the current screen mode's text block height.
* If no font is set, it returns the current screen mode's text block height.
* This can be used to leave the correct amount of line gap between lines.
* This can be used to leave the correct amount of line gap between lines.


{{PageAvailability}}
{{PageAvailability}}
Line 24: Line 28:
</gallery>
</gallery>
<!-- additional availability notes go below here -->
<!-- additional availability notes go below here -->


{{PageExamples}}
{{PageExamples}}
Line 58: Line 63:
{{Cl|DATA}} {{Text|<nowiki>"To strive,to seek,to find,and not to yield."</nowiki>|#FFB100}}
{{Cl|DATA}} {{Text|<nowiki>"To strive,to seek,to find,and not to yield."</nowiki>|#FFB100}}
{{CodeEnd}}
{{CodeEnd}}


{{PageSeeAlso}}
{{PageSeeAlso}}
Line 65: Line 71:
* [[SCREEN]], [[_LOADFONT]]
* [[SCREEN]], [[_LOADFONT]]
* [[Text Using Graphics]] (Demo)
* [[Text Using Graphics]] (Demo)


{{PageNavigation}}
{{PageNavigation}}

Revision as of 12:38, 22 May 2023

The _ULINESPACING function returns the vertical line spacing (distance between two consecutive baselines) in pixels.


Syntax

pixels& = _ULINESPACING[(fontHandle&)]


Parameters

  • fontHandle& is an optional font handle.


Description

  • Returns the vertical line spacing of the last font used if a handle is not designated.
  • If no font is set, it returns the current screen mode's text block height.
  • This can be used to leave the correct amount of line gap between lines.


Availability


Examples

Example
How to use _ULINESPACING.
OPTION _EXPLICIT

SCREEN _NEWIMAGE(800, 600, 32)

DIM fh AS LONG: fh = _LOADFONT("LHANDW.TTF", 23)
IF fh <= 0 THEN
    PRINT "Failed to load font file!"
    END
END IF

_FONT fh

CLS , _RGB32(200, 200, 200)
COLOR _RGB32(0, 0, 0)
_PRINTMODE _KEEPBACKGROUND

DIM l AS STRING, i AS LONG
FOR i = 0 TO 4
    READ l
    _UPRINTSTRING (0, _ULINESPACING * i), l
NEXT

END

DATA "We are not now that strength which in old days"
DATA "Moved earth and heaven; that which we are,we are;"
DATA "One equal temper of heroic hearts,"
DATA "Made weak by time and fate,but strong in will"
DATA "To strive,to seek,to find,and not to yield."


See also



Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link