Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Verwenden der Flash Text Engine
Sperren und Klonen des ElementFormat-Objekts
Flash Player 10 und höher, Adobe AIR 1.5 und höher
Wenn ein ElementFormat-Objekt einem beliebigen ContentElement-Typ zugewiesen ist, wird die Eigenschaft
locked des Objekts automatisch auf true festgelegt. Wenn Sie versuchen, ein gesperrtes ElementFormat-Objekt zu
bearbeiten, wird eine IllegalOperationError-Ausnahme ausgelöst. Die beste Vorgehensweise ist, ein solches
Objekt vollständig zu definieren, bevor Sie es einer TextElement-Instanz zuweisen.
Wenn Sie eine vorhandene ElementFormat-Instanz ändern möchten, müssen Sie zunächst deren locked-Eigenschaft
überprüfen. Wenn der Wert true lautet, können Sie mit der clone()-Methode eine ungesperrte Kopie des Objekts
erstellen. Die Eigenschaften dieses ungesperrten Objekts können geändert werden, und anschließend kann des Objekt
mit der TextElement-Instanz verknüpft werden. Alle aus dem Objekt neu erstellten Zeilen weisen die neue
Formatierung auf. Zuvor von diesem Objekt erstellte Zeilen, die das alte Format verwenden, bleiben unverändert.
package
{
import flash.display.Sprite;
import flash.text.*;
}
public class ElementFormatCloneExample extends Sprite
{
private var tb:TextBlock = new TextBlock();
private var te:TextElement;
private var ef1:ElementFormat;
private var ef2:ElementFormat;
private var fd:FontDescription = new FontDescription();
}
public function ElementFormatCloneExample()
{
fd.fontName = "Garamond";
ef1 = new ElementFormat(fd);
ef1.fontSize = 24;
var str:String = "This is flash text";
te = new TextElement(str, ef);
tb.content = te;
var tx1:TextLine = tb.createTextLine(null,600);
addChild(tx1);
}
ef2 = (ef1.locked) ? ef1.clone() : ef1;
ef2.fontSize = 32;
tb.content.elementFormat = ef2;
var tx2:TextLine = tb.createTextLine(null,600);
addChild(tx2);
Letzte Aktualisierung 27.6.2012
434