| Paket | flash.text.engine |
| Klasse | public class ContentElement |
| Vererbung | ContentElement Object |
| Unterklassen | GraphicElement, GroupElement, TextElement |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
ContentElementist eine abstrakte Basisklasse. Daher können Sie ContentElement nicht direkt instanziieren. Durch das Aufrufen von new ContentElement() wird ein ArgumentError-Ausnahmefehler zurückgegeben.
Sie können ein ContentElement-Element genau einem GroupElement bzw. der content-Eigenschaft von genau einem Textblock zuweisen.
Verwandte API-Elemente
| 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 [schreibgeschützt]
Eine Kopie des Texts in diesem Element, ausschließlich aller U+FDEF-Zeichen, die Grafikelemente im String repräsentieren. | ContentElement | ||
| 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 | ||
| Methode | Definiert von | ||
|---|---|---|---|
ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Durch das Aufrufen des Konstruktors „new ContentElement()“ wird ein ArgumentError-Ausnahmefehler zurückgegeben. | ContentElement | ||
![]() |
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 | |
![]() |
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 | |
| Konstante | Definiert von | ||
|---|---|---|---|
| GRAPHIC_ELEMENT : uint = 0xFDEF [statisch]
Gibt an, dass im Text ein Grafikelement vorhanden ist. | ContentElement | ||
elementFormat | Eigenschaft |
elementFormat:ElementFormat| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Das ElementFormat-Objekt, das für das Element verwendet wird.
Der Standardwert ist null.
Wenn die elementFormat-Eigenschaft eingestellt ist, ist das bereitgestellte ElementFormat-Objekt gesperrt, d. h. seine locked-Eigenschaft ist auf true eingestellt. Ein gesperrtes ElementFormat-Objekt kann nicht geändert werden.
Implementierung
public function get elementFormat():ElementFormat public function set elementFormat(value:ElementFormat):voidVerwandte API-Elemente
eventMirror | Eigenschaft |
eventMirror:EventDispatcher| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Das EventDispatcher-Objekt, das Kopien von jedem Ereignis erhält, das für auf diesem content-Element basierende gültige Textzeilen ausgelöst wurde. Mit dem angegebenen Objekt können Listener für eine Textverknüpfung oder ein anderes interaktives Textstück eingerichtet werden, da es zur Laufzeit schwierig sein kann, festzustellen, welche Teile von Zeilen aus bestimmten content-Elementen resultieren. Sie können auch Listener verwenden, um Effekte wie Unterstreichen anzuwenden, deren Metrik Sie erst nach dem Layout des Texts bestimmen können. Der Standardwert ist null, was bedeutet, das keine gespiegelten Ereignisse ausgelöst werden.
Ereignisspiegel manifestieren sich selbst in Textzeilen als Instanzen der TextLineMirrorRegion-Klasse. Je nach bidirektionaler Verarbeitung und Zeilenumbrüchen können ein oder mehrere Spiegelbereiche erzeugt werden.
Der Standardwert ist null.
Implementierung
public function get eventMirror():EventDispatcher public function set eventMirror(value:EventDispatcher):voidVerwandte API-Elemente
groupElement | Eigenschaft |
groupElement:GroupElement [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Das GroupElement-Objekt, das dieses Element enthält, oder null, falls es sich nicht in einer Gruppe befindet.
Der Standardwert ist null.
Implementierung
public function get groupElement():GroupElementVerwandte API-Elemente
rawText | Eigenschaft |
rawText:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Eine Kopie des Texts in diesem Element, einschließlich aller U+FDEF-Zeichen. Das Unicode-Zeichen U+FDEF kennzeichnet die Position eines Grafikelements in einem String.
Implementierung
public function get rawText():Stringtext | Eigenschaft |
text:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Eine Kopie des Texts in diesem Element, ausschließlich aller U+FDEF-Zeichen, die Grafikelemente im String repräsentieren.
Implementierung
public function get text():StringVerwandte API-Elemente
textBlock | Eigenschaft |
textBlock:flash.text.engine:TextBlock [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Der TextBlock, zu dem dieses Element gehört.
Der Standardwert ist null.
Implementierung
public function get textBlock():flash.text.engine:TextBlockVerwandte API-Elemente
textBlockBeginIndex | Eigenschaft |
textBlockBeginIndex:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Der Index, den das erste Zeichen dieses Elements im Textblock belegt. Dieser Wert wird nicht zwischengespeichert; er wird berechnet, wenn diese Methode aufgerufen wird.
Der Standardwert ist -1.
Implementierung
public function get textBlockBeginIndex():inttextRotation | Eigenschaft |
textRotation:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Die Drehung, die auf das Element als Einheit angewendet werden soll. Verwenden Sie TextRotation-Konstanten für diese Eigenschaft.
Der Standardwert ist TextRotation.ROTATE_0.
Die endgültige Drehung jeder Glyphe ist die Summe von ElementFormat.textRotation, ContentElement.textRotation und TextBlock.lineRotation.
ContentElement.textRotation wird verwendet, um eine kurze Textfolge zu erstellen, deren Drehung sich von der der Zeile, die sie enthält, unterscheidet. TCY-Textfolgen in japanischem Text sind ein Beispiel hierfür. TCY steht für Tate-Chu-Yoko und bezeichnet eine kurze horizontale Textfolge (meistens eine Zahl) in vertikalem japanischem Text. Um einen Absatz mit vertikalem japanischem Text zu erstellen, der eine TCY-Folge enthält, gehen Sie folgendermaßen vor:
- Legen Sie
TextBlock.lineRotation=TextRotation.ROTATE_90fest. - Legen Sie
TextBlock.contentauf ein GroupElement fest, das aus drei TextElement-Objekten besteht. Das erste ist der japanische Text vor der TCY-Folge, das zweite der Latin-Text der TCY-Folge und das dritte der japanische Text nach der TCY-Folge. - Stellen Sie die
textRotation-Eigenschaft des TCY-TextElement aufTextRotation.ROTATE_270ein. Das TCY-Textelement wird als Einheit gedreht. Es beginnt mit einer 90-Grad-Drehung, die von der Zeile übernommen wird. Durch das Hinzufügen einer zusätzlichen 270-Grad-Drehung wird die Horizontale erreicht.
Gedrehte content-Elemente können nicht verschachtelt sein. In einer Hierarchie von content-Elementen, unabhängig von ihrer Komplexität, kann jeweils nur für ein content-Element die textRotation-Eigenschaft eingestellt werden. Die folgenden Methoden und Eigenschaften geben einen Argumentfehler zurück, wenn verschachtelte Drehungen erkannt werden:
ContentElement.textRotationGroupElement.setElementsGroupElement.replaceElements
Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden Stringwerte:
| Stringwert | Beschreibung |
|---|---|
TextRotation.ROTATE_0 | Das Element wird nicht gedreht. |
TextRotation.ROTATE_90 | Das Element wird um 90 Grad im Uhrzeigersinn gedreht. |
TextRotation.ROTATE_180 | Das Element wird um 180 Grad gedreht. |
TextRotation.ROTATE_270 | Das Element wird um 270 Grad im Uhrzeigersinn gedreht. |
TextRotation.AUTO | Nicht unterstützt. |
Implementierung
public function get textRotation():String public function set textRotation(value:String):voidAuslöser
ArgumentError — Falls ein Wert verwendet wird, der kein Mitglied von TextRotation ist.
| |
ArgumentError — Falls der Wert auf TextRotation.AUTO gesetzt ist.
| |
ArgumentError — Wenn der Vorgang zu verschachtelten Drehungen innerhalb eines GroupElement führen würde.
|
Verwandte API-Elemente
userData | Eigenschaft |
public var userData:*| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Ermöglicht einer Anwendung, beliebige Daten mit dem Element zu verknüpfen.
Der Standardwert ist null.
ContentElement | () | Konstruktor |
public function ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Durch das Aufrufen des Konstruktors new ContentElement() wird ein ArgumentError-Ausnahmefehler zurückgegeben. Sie können jedoch durchaus Konstruktoren für die folgenden Unterklassen von ContentElement aufrufen:
new GraphicElement()new GroupElement()new TextElement()
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 von jedem Ereignis erhält, das für auf diesem content-Element basierende gültige Textzeilen ausgelöst wurde. 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.
|
GRAPHIC_ELEMENT | Konstante |
Tue Jun 12 2018, 10:04 AM Z
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen