
TextFormat.getTextExtent() Method
This is the Title of the Book, eMatter Edition
Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.
Alphabetical Language Reference
|
895
TextFormat.getTextExtent() Method
returns the pixel dimensions of a string rendered according to a given TextFormat object
Flash 6
theFormat.getTextExtent(text)
Arguments
text The string to be measured in this character format.
Returns
An object with height and width properties.
Description
The getTextExtent() method returns an object whose height and width properties tell us the
anticipated size of
text, formatted according to theFormat. It is used not to measure text
already assigned to a text field but to determine the dimensions of any arbitrary string in a
particular character format. We make these theoretical measurements when generating
dynamic interfaces. For example, a string that is found to be too large in a certain format
can be reformatted to fit available space. The following Example truncates text with an
ellipsis (...) if the text does not fit in a text field.
The getTextExtent() method measures only character formats; it ignores the effect of all
paragraph formats (word-wrapping, line breaks, margins, bullets, indent, block indent,
etc). For example, the following code with indentation:
f = new TextFormat();
f.indent = 30; // Add indentation.
trace(f.getTextExtent("test").width);
yields the same result as this ...