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
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 ) — 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); } } }
Tue Jun 12 2018, 10:04 AM Z