ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Using the Flash Text Engine
Locking and cloning FontDescription
Flash Player 10 and later, Adobe AIR 1.5 and later
When a FontDescription object is assigned to an ElementFormat, its locked property is automatically set to true.
Attempting to modify a locked FontDescription object throws an IllegalOperationError. The best practice is to
fully define such an object before assigning it to a ElementFormat.
If you want to modify an existing FontDescription, first check its locked property. If it’s true, use the
clone()method to create an unlocked copy of the object. The properties of this unlocked object can be changed, and
it can then be assigned to the ElementFormat. Any new lines created from this TextElement have the new formatting.
Previous lines created from this same object are unchanged.
package
{
import flash.display.Sprite;
import flash.text.*;
}
public class FontDescriptionCloneExample extends Sprite
{
private var tb:TextBlock = new TextBlock();
private var te:TextElement;
private var ef1:ElementFormat;
private var ef2:ElementFormat;
private var fd1:FontDescription = new FontDescription();
private var fd2:FontDescription;
}
public function FontDescriptionCloneExample()
{
fd1.fontName = "Garamond";
ef1 = new ElementFormat(fd);
var str:String = "This is flash text";
te = new TextElement(str, ef);
tb.content = te;
var tx1:TextLine = tb.createTextLine(null,600);
addChild(tx1);
}
fd2 = (fd1.locked) ? fd1.clone() : fd1;
fd2.fontName = "Arial";
ef2 = (ef1.locked) ? ef1.clone() : ef1;
ef2.fontDescription = fd2;
tb.content.elementFormat = ef2;
var tx2:TextLine = tb.createTextLine(null,600);
addChild(tx2);
Controlling text
Flash Player 10 and later, Adobe AIR 1.5 and later
FTE gives you a new set of text formatting controls to handle justification and character spacing (kerning and
tracking). There are also properties for controlling that way lines are broken and for setting tab stops within lines.
Last updated 6/6/2012
411