ContentElement

Pakiet	flash.text.engine
Klasa	public class ContentElement
Dziedziczenie	ContentElement Object
Podklasy	GraphicElement, GroupElement, TextElement

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

Klasa ContentElement stanowi klasę bazową do tworzenia typów elementów, które mogą pojawić się w obiekcie GroupElement, tj. GraphicElement, inny obiekt GroupElement lub TextElement.

Klasa ContentElement stanowi klasę podstawową, dlatego nie można jej wywołać bezpośrednio. Wywołanie metody new ContentElement() powoduje zgłoszenie wyjątku ArgumentError.

Element ContentElement można przypisać wyłączanie do jednego obiektu GroupElement lub do właściwości content dokładnie tego samego bloku tekstu.

Powiązane elementy interfejsu API

ElementFormat
GraphicElement
GroupElement
TextBlock.content
TextElement
TextLineMirrorRegion
TextRotation

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		elementFormat : ElementFormat Obiekt ElementFormat zastosowany dla elementu.	ContentElement
		eventMirror : EventDispatcher Obiekt EventDispatcher otrzymujący kopie każdego zdarzenia wywołanego do poprawnego wiersza tekstu utworzonego na podstawie tego elementu treści.	ContentElement
		groupElement : GroupElement [tylko do odczytu] Obiekt GroupElement zawierający ten element lub wartość null, jeśli element nie znajduje się w grupie.	ContentElement
		rawText : String [tylko do odczytu] Kopia tekstu w elemencie, w tym znaki U+FDEF.	ContentElement
		text : String [tylko do odczytu] Kopia tekstu w elemencie bez znaków U+FDEF reprezentujących element graficzny w ciągu znaków.	ContentElement
		textBlock : flash.text.engine:TextBlock [tylko do odczytu] Obiekt TextBlock, do którego należy element.	ContentElement
		textBlockBeginIndex : int [tylko do odczytu] Indeks w bloku tekstu pierwszego znaku tego elementu.	ContentElement
		textRotation : String Obrót zastosowany do elementu jako jednostki.	ContentElement
		userData : * Umożliwia aplikacji skojarzenie dowolnych danych z elementem.	ContentElement

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0") Wywołanie konstruktora new ContentElement() powoduje zgłoszenie wyjątku ArgumentError.	ContentElement
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg reprezentujący określony obiekt.	Object
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object

Stałe publiczne

	Stała		Zdefiniowane przez
		GRAPHIC_ELEMENT : uint = 0xFDEF [statyczny] Wskazuje na obecność elementu graficznego w tekście.	ContentElement

Szczegół właściwości

elementFormat

właściwość

elementFormat:ElementFormat

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

Obiekt ElementFormat zastosowany dla elementu.

Wartością domyślną jest null.

Po ustawieniu właściwości elementFormat przekazany obiekt ElementFormat zostaje zablokowany: jego właściwość locked ma wartość true. Zablokowany obiekt ElementFormat nie może być modyfikowany.

Implementacja
public function get elementFormat():ElementFormat
public function set elementFormat(value:ElementFormat):void

Powiązane elementy interfejsu API

ElementFormat
TextBlock
TextElement

eventMirror

właściwość

eventMirror:EventDispatcher

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

Obiekt EventDispatcher otrzymujący kopie każdego zdarzenia wywołanego do poprawnego wiersza tekstu utworzonego na podstawie tego elementu treści. Określony obiekt może służyć do konfiguracji detektorów dla wiersza tekstu lub innego interaktywnego fragmentu tekstu ze względu na możliwe trudności związane z określeniem w trakcie wykonania, które fragmenty wiersza pochodzą z określonych elementów treści. Detektory służą również do stosowania elementów ozdobnych takich jak podkreślenia, których wymiarów nie można określić do czasu rozplanowania tekstu. Wartość domyślna to null, która oznacza, że nie są wywoływane żadne odbite zdarzenia.

Odbicia zdarzeń występują w wierszu tekstu jako instancje klasy TextLineMirrorRegion. W zależności od sposobu przetwarzania dwukierunkowego i podziałów wierszy utworzony może być jeden lub większa liczba obszarów odbicia.

Wartością domyślną jest null.

Implementacja
public function get eventMirror():EventDispatcher
public function set eventMirror(value:EventDispatcher):void

Powiązane elementy interfejsu API

flash.events.EventDispatcher
TextLineMirrorRegion

groupElement

właściwość

groupElement:GroupElement [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

Obiekt GroupElement zawierający ten element lub wartość null, jeśli element nie znajduje się w grupie.

Wartością domyślną jest null.

Implementacja
public function get groupElement():GroupElement

Powiązane elementy interfejsu API

GroupElement

rawText

właściwość

rawText:String [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

Kopia tekstu w elemencie, w tym znaki U+FDEF. Znak Unicode, U+FDEF, oznacza położenie elementu graficznego w obiekcie String.

Implementacja
public function get rawText():String

text

właściwość

text:String [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

Kopia tekstu w elemencie bez znaków U+FDEF reprezentujących element graficzny w ciągu znaków.

Implementacja
public function get text():String

Powiązane elementy interfejsu API

TextElement.text

textBlock

właściwość

textBlock:flash.text.engine:TextBlock [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

Obiekt TextBlock, do którego należy element.

Wartością domyślną jest null.

Implementacja
public function get textBlock():flash.text.engine:TextBlock

Powiązane elementy interfejsu API

TextBlock

textBlockBeginIndex

właściwość

textBlockBeginIndex:int [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

Indeks w bloku tekstu pierwszego znaku tego elementu. Wartość nie jest buforowana; jest obliczana każdorazowo podczas wywołania metody.

Wartością domyślną jest -1.

Implementacja
public function get textBlockBeginIndex():int

textRotation

właściwość

textRotation:String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

Obrót zastosowany do elementu jako jednostki. Dla tej właściwości należy użyć stałej TextRotation.

Wartością domyślną jest TextRotation.ROTATE_0.

Końcowy obrót dowolnego glifu to suma właściwości ElementFormat.textRotation, ContentElement.textRotation oraz TextBlock.lineRotation.

ContentElement.textRotation służy do tworzenia krótkiego fragmentu tekstu, którego obrót różni się od obrotu samego wiersza. Za przykład mogą posłużyć łańcuchy TCY w tekstach w języku japońskim. TCY oznacza Tate-Chu-Yoko i odnosi się do małego łańcucha tekstu poziomego (zazwyczaj liczba) w określonym pionowym tekście w języku japońskim. W celu utworzenia akapitu pionowego tekstu w języku japońskim zawierającego łańcuch TCY należy wykonać następujące czynności:

Ustawić TextBlock.lineRotation=TextRotation.ROTATE_90
Ustawić właściwość TextBlock.content dla obiektu GroupElement składającego się z trzech obiektów TextElement. Pierwszy z tych elementów to tekst w języku japońskim przed łańcuchem TCY, drugi to tekst na bazie alfabetu łacińskiego łańcucha TCY, a trzeci to tekst w języku japońskim za łańcuchem TCY.
Ustawić właściwość textRotation obiektu TextElementTCY jako TextRotation.ROTATE_270. Element tekstu TCY obraca się jako jednostka. Rozpoczyna się obrotem o 90 stopni dziedziczonym z wiersza. Obrócenie o dalsze 270 stopi powoduje ustawienie w położeniu poziomym.

Obróconych elementów tekstu nie można zagnieżdżać. W dowolnej hierarchii elementów treści, bez względu na stopień złożoności, właściwość textRotation można ustawić wyłącznie dla jednego elementu treści. Następujące metody oraz procedury ustawiające właściwości zgłaszają błąd argumentu w przypadku wykrycia zagnieżdżonych obrotów.

ContentElement.textRotation
GroupElement.setElements
GroupElement.replaceElements

W celu ustawienia wartości tej właściwości należy użyć następujących wartości ciągu znaków:

Wartość ciągu znaków	Opis
`TextRotation.ROTATE_0`	Element nie jest obracany.
`TextRotation.ROTATE_90`	Elementy jest obracany o 90 stopni w prawo.
`TextRotation.ROTATE_180`	Elementy jest obracany o 180 stopni.
`TextRotation.ROTATE_270`	Elementy jest obracany o 270 stopni w prawo.
`TextRotation.AUTO`	Nie obsługiwany.

Implementacja
public function get textRotation():String
public function set textRotation(value:String):void

Zgłasza

	`ArgumentError` — Jeśli ustawiona jest dowolna wartość, która nie jest elementem klasy TextRotation.

	`ArgumentError` — Jeśli ustawiono `TextRotation.AUTO`.

	`ArgumentError` — Jeśli działanie spowoduje zagnieżdżenie obrotu w obiekcie GroupElement.

Powiązane elementy interfejsu API

TextRotation
ElementFormat.textRotation
TextBlock.lineRotation

userData

właściwość

public var userData:*

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

Umożliwia aplikacji skojarzenie dowolnych danych z elementem.

Wartością domyślną jest null.

Konstruktor Szczegół

()

Konstruktor

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

Wywoływanie konstruktora new ContentElement() powoduje zgłoszenie wyjątku ArgumentError. Jednak możliwe jest wywołanie konstruktorów następujących podklas obiektu ContentElement:

new GraphicElement()
new GroupElement()
new TextElement()

Parametry

	`elementFormat:ElementFormat` (default = `null`) — Format elementu dla tekstu w elemencie. Wartością domyślną jest `null`.

	`eventMirror:EventDispatcher` (default = `null`) — Obiekt `EventDispatcher` otrzymujący kopie każdego zdarzenia wywołanego do poprawnego wiersza tekstu utworzonego na podstawie tego elementu treści. Wartością domyślną jest `null`.

	`textRotation:String` (default = "`rotate0`") — Obrót zastosowany do elementu jako jednostki. Dla tej właściwości należy użyć stałej `TextRotation`. Wartością domyślną jest `TextRotation.ROTATE_0`.

Szczegół stałej

GRAPHIC_ELEMENT

Stała

public static const GRAPHIC_ELEMENT:uint = 0xFDEF

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

Wskazuje na obecność elementu graficznego w tekście.

Powiązane elementy interfejsu API

rawText

Informacje prawne | Zasady prywatności online

ContentElement - AS3

Pakietyx

Elementy językowe

Dodatki

Pakiet flash.text.engine

elementFormat

eventMirror

groupElement

rawText

text

textBlock

textBlockBeginIndex

textRotation

userData

ContentElement

GRAPHIC_ELEMENT