ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.text.engine 

TextElement  - AS3

Paketflash.text.engine
Klassepublic final class TextElement
VererbungTextElement Inheritance ContentElement Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5, Flash Lite 4

Die TextElement-Klasse stellt einen String aus formatiertem Text dar. Weisen Sie ein TextElement-Objekt der content-Eigenschaft eines TextBlock-Objekts zu, um einen Textblock zu erstellen. Weisen Sie es einem GroupElement-Objekt zu, um es mit anderen Text- und Grafikelementen zu einer Gruppe zu kombinieren. Verwenden Sie die ElementFormat-Klasse, um den Text zu formatieren.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedelementFormat : ElementFormat
Das ElementFormat-Objekt, das für das Element verwendet wird.
ContentElement
 InheritedeventMirror : EventDispatcher
Das EventDispatcher-Objekt, das Kopien von jedem Ereignis erhält, das für auf diesem content-Element basierende gültige Textzeilen ausgelöst wurde.
ContentElement
 InheritedgroupElement : GroupElement
[schreibgeschützt] Das GroupElement-Objekt, das dieses Element enthält, oder null, falls es sich nicht in einer Gruppe befindet.
ContentElement
 InheritedrawText : String
[schreibgeschützt] Eine Kopie des Texts in diesem Element, einschließlich aller U+FDEF-Zeichen.
ContentElement
  text : String
Erhält den Text, der Inhalt des Elements ist.
TextElement
 InheritedtextBlock : flash.text.engine:TextBlock
[schreibgeschützt] Der TextBlock, zu dem dieses Element gehört.
ContentElement
 InheritedtextBlockBeginIndex : int
[schreibgeschützt] Der Index, den das erste Zeichen dieses Elements im Textblock belegt.
ContentElement
 InheritedtextRotation : String
Die Drehung, die auf das Element als Einheit angewendet werden soll.
ContentElement
 InheriteduserData : *
Ermöglicht einer Anwendung, beliebige Daten mit dem Element zu verknüpfen.
ContentElement
Öffentliche Methoden
 MethodeDefiniert von
  
TextElement(text:String = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Erstellt eine neue TextElement-Instanz.
TextElement
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
replaceText(beginIndex:int, endIndex:int, newText:String):void
Ersetzt den Zeichenbereich, der durch die Parameter „beginIndex“ und „endIndex“ angegeben wird, durch den Inhalt des Parameters „newText“.
TextElement
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

text

Eigenschaft
text:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5, Flash Lite 4

Erhält den Text, der Inhalt des Elements ist.

Der Standardwert ist null.



Implementierung
    public function get text():String
    public function set text(value:String):void
Konstruktordetails

TextElement

()Konstruktor
public function TextElement(text:String = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5, Flash Lite 4

Erstellt eine neue TextElement-Instanz.

Parameter
text:String (default = null) — Der Text für das Element. Der Standardwert ist null.
 
elementFormat:ElementFormat (default = null) — Das Elementformat für den Text in dem Element. Der Standardwert ist null.
 
eventMirror:EventDispatcher (default = null) — Das EventDispatcher-Objekt, das Kopien jedes Ereignisses erhält, das an Textzeilen basierend auf diesem Inhaltselement übergeben wird. Der Standardwert ist null.
 
textRotation:String (default = "rotate0") — Die auf das Element angewendete Drehung als Einheit. Verwenden Sie TextRotation-Konstanten für diese Eigenschaft. Der Standardwert ist TextRotation.ROTATE_0.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird aus einem Text ein TextElement-Objekt erstellt, mit der Schriftgröße 12 und der Farbe Rot (0xCC0000) formatiert und der content-Eigenschaft eines TextBlock zugewiesen. Es ruft die createLines()-Funktion auf, um den Textblock in Zeilen mit je 150 Pixel aufzuteilen.
package {
    import flash.display.Sprite;
    import flash.text.engine.TextBlock;
    import flash.text.engine.TextElement;
    import flash.text.engine.TextLine;
    import flash.text.engine.ElementFormat;
    
    public class TextElementExample extends Sprite {
        
        public function TextElementExample():void {
            
            var str:String = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, " +
            "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut " +
            "enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut " +
            "aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit " +
            "in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur " +
            "sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt " +
            "mollit anim id est laborum.";
            
            var format:ElementFormat = new ElementFormat(null, 12, 0xCC0000);
            var textElement:TextElement = new TextElement(str, format); 
            var textBlock:TextBlock = new TextBlock();
            textBlock.content = textElement; 
            createLines(textBlock);
        }
        
        private function createLines(textBlock:TextBlock):void {
        
            var yPos = 20;
            var textLine:TextLine = textBlock.createTextLine (null, 150);
 
            while (textLine)
            {
                addChild(textLine);
                textLine.x = 15;
                yPos += textLine.textHeight+2;
                textLine.y = yPos;
                textLine = textBlock.createTextLine(textLine, 150);
            }        
        }
    }
}
Methodendetails

replaceText

()Methode
public function replaceText(beginIndex:int, endIndex:int, newText:String):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5, Flash Lite 4

Ersetzt den Zeichenbereich, der durch die Parameter beginIndex und endIndex angegeben wird, durch den Inhalt des Parameters newText. Der beginIndex- und endIndex-Wert beziehen sich auf den aktuellen Inhalt von text.

Um Text zu löschen, übergeben Sie null für newText.

Um Text einzufügen, übergeben Sie den gleichen Wert für beginIndex und endIndex. Der neue Text wird vor dem angegebenen Index eingefügt.

Um Text anzuhängen, übergeben Sie text.length für beginIndex und endIndex.

Um den gesamten Text festzulegen, übergeben Sie 0 für beginIndex und text.length für endIndex.

Parameter

beginIndex:int — Der auf Null basierende Indexwert für die Startposition des Ersetzungsbereichs.
 
endIndex:int — Der auf Null basierende Indexwert, der der Endposition des Ersetzungsbereichs folgt.
 
newText:String — Der Text, durch den der angegebene Zeichenbereich ersetzt werden soll.


Auslöser
RangeError — Der angegebene beginIndex bzw. endIndex befindet sich nicht im gültigen Bereich.

Beispiel  ( Verwendung dieses Beispiels )

In diesem Beispiel wird replaceText() mehrmals aufgerufen, um Folgendes zu tun:
  • Einfügen eines Strings am Anfang des Texts
  • Anfügen eines Strings am Ende des Texts
  • Einfügen eines Strings in der Mitte des Texts
  • Ersetzen des ganzen Texts durch neuen Text
package {
    import flash.display.Sprite;
    import flash.text.engine.FontDescription;
    import flash.text.engine.ElementFormat;
    import flash.text.engine.TextElement;
    import flash.text.engine.TextBlock;
    import flash.text.engine.TextLine;
    
    
    public class TextElement_replaceTextExample extends Sprite {
        public function TextElement_replaceTextExample():void {
            
            var str:String = "0123456";
            var fontDescription:FontDescription = new FontDescription("Arial");
            var format:ElementFormat = new ElementFormat(fontDescription);
            format.fontSize = 14;
            var textElement:TextElement = new TextElement(str, format);
            var textBlock:TextBlock = new TextBlock();
            textBlock.content = textElement;
            textElement.replaceText(0, 0, "abc");  
            createLine(textBlock, 20);           //"abc0123456"
            textElement.replaceText(10, 10, "abc");   
            createLine(textBlock, 40);            // "abc0123456abc"
            textElement.replaceText(5, 8, "abc");
            createLine(textBlock, 60);         // "abc01abc56abc"
            textElement.replaceText(0, 13, "abc");
            createLine(textBlock, 80);            // "abc"
            textElement.replaceText(0, 3, "That's all she wrote!");
            createLine(textBlock, 100);        // "That's all she wrote" */
        }
            
        private function createLine(textBlock:TextBlock, y:Number):void {
            var textLine:TextLine = textBlock.createTextLine(null, 150);
            textLine.x = 10;
            textLine.y = y;
            addChild(textLine);
        }
    }
}




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.