| Paket | flash.text.engine |
| Klasse | public final class TextElement |
| Vererbung | TextElement  ContentElement Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| elementFormat : ElementFormat
Das ElementFormat-Objekt, das für das Element verwendet wird. | ContentElement | |
| eventMirror : 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 | |
| groupElement : GroupElement [schreibgeschützt]
Das GroupElement-Objekt, das dieses Element enthält, oder null, falls es sich nicht in einer Gruppe befindet.
| ContentElement | |
| rawText : 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 | ||
| textBlock : flash.text.engine:TextBlock [schreibgeschützt]
Der TextBlock, zu dem dieses Element gehört. | ContentElement | |
| textBlockBeginIndex : int [schreibgeschützt]
Der Index, den das erste Zeichen dieses Elements im Textblock belegt. | ContentElement | |
| textRotation : String
Die Drehung, die auf das Element als Einheit angewendet werden soll. | ContentElement | |
| userData : *
Ermöglicht einer Anwendung, beliebige Daten mit dem Element zu verknüpfen. | ContentElement | |
Öffentliche Methoden
| Methode | Definiert von | ||
|---|---|---|---|
TextElement(text:String = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Erstellt eine neue TextElement-Instanz. | TextElement | ||
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
Ersetzt den Zeichenbereich, der durch die Parameter „beginIndex“ und „endIndex“ angegeben wird, durch den Inhalt des Parameters „newText“. | TextElement | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
Öffentliche Konstanten
Eigenschaftendetails
text | Eigenschaft |
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.
Parametertext:String (default = null)null.
| |
elementFormat:ElementFormat (default = null)null.
| |
eventMirror:EventDispatcher (default = null)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")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);
}
}
}
Tue Jun 12 2018, 10:04 AM Z