FontOperationTextLayoutBoundsOnCanvas

Typeoperator
DictionaryLCB
LibraryLiveCode Builder
Syntax
the [ layout ] bounds of text <mText> on <mCanvas>
Associationscom.livecode.canvas
Summary

Measure text when drawn to a canvas.

Parameters
NameTypeDescription
mText

An expression which evaluates to a string.

mCanvas

An expression which evaluates to a canvas.

Example
// Set the canvas font
set the font of this canvas to font "Arial" at size 18

variable tBounds as Rectangle
put the bounds of text "Sample text" on this canvas into tBounds
Values
NameTypeDescription
return

The bounding box of mText when drawn at point 0,0 with the current font of mCanvas. Returns the bounds as a rectangle.

Description

The layout bounds of the text, constructed from the ascent and descent values of the font, and the width of the text string.

Note: The layout bounds is used to position blocks of text relative to each other, so the text may overlap these bounds.

Tagscanvas