Pacchetto | flash.text.engine |
Classe | public class ContentElement |
Ereditarietà | ContentElement Object |
Sottoclassi | GraphicElement, GroupElement, TextElement |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
ContentElement è una classe base astratta e non potete quindi creare direttamente un'istanza di ContentElement. Una chiamata a new ContentElement()
genera un'eccezione di tipo ArgumentError
.
Potete assegnare un elemento ContentElement a un unico GroupElement
o alla proprietà content
di un unico blocco di testo.
Elementi API correlati
Proprietà | Definito da | ||
---|---|---|---|
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
elementFormat : ElementFormat
L'oggetto ElementFormat usato per l'elemento. | ContentElement | ||
eventMirror : EventDispatcher
L'oggetto EventDispatcher che riceve le copie di ogni evento inviato alle righe di testo valide in base a questo elemento content. | ContentElement | ||
groupElement : GroupElement [sola lettura]
L'oggetto GroupElement che contiene questo elemento; oppure null se non fa parte di un gruppo. | ContentElement | ||
rawText : String [sola lettura]
Una copia del testo nell'elemento, inclusi i caratteri U+FDEF. | ContentElement | ||
text : String [sola lettura]
Una copia del testo nell'elemento, esclusi i caratteri U+FDEF che rappresentano elementi grafici nella stringa. | ContentElement | ||
textBlock : flash.text.engine:TextBlock [sola lettura]
L'oggetto TextBlock al quale appartiene questo elemento. | ContentElement | ||
textBlockBeginIndex : int [sola lettura]
L'indice nel testo del blocco di testo del primo carattere di questo elemento. | ContentElement | ||
textRotation : String
La rotazione da applicare all'elemento come un'unità. | ContentElement | ||
userData : *
Fornisce un modo per consentire a un'applicazione di associare dati arbitrari con l'elemento. | ContentElement |
Metodo | Definito da | ||
---|---|---|---|
ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Una chiamata alla nuova funzione di costruzione ContentElement() genera un'eccezione ArgumentError. | ContentElement | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | ||
Restituisce il valore di base dell'oggetto specificato. | Object |
Costante | Definito da | ||
---|---|---|---|
GRAPHIC_ELEMENT : uint = 0xFDEF [statico]
Indica la presenza di un elemento grafico nel testo. | ContentElement |
elementFormat | proprietà |
elementFormat:ElementFormat
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
L'oggetto ElementFormat usato per l'elemento.
Il valore predefinito è null
.
Quando la proprietà elementFormat
è impostata, l'oggetto ElementFormat fornito è bloccato: la proprietà locked
è impostata su true
. Non è possibile modificare un oggetto ElementFormat bloccato.
Implementazione
public function get elementFormat():ElementFormat
public function set elementFormat(value:ElementFormat):void
Elementi API correlati
eventMirror | proprietà |
eventMirror:EventDispatcher
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
L'oggetto EventDispatcher
che riceve le copie di ogni evento inviato alle righe di testo valide in base a questo elemento content. L'oggetto specificato può essere usato per impostare i listener per un collegamento di testo o altre parti di testo interattive, poiché potrebbe essere difficile determinare in runtime quali parti di righe sono state generate da elementi content particolari. Potete utilizzare i listener per applicare gli effetti, come la sottolineatura, la cui metrica non può essere determinata se non dopo la disposizione del testo. Il valore predefinito è null
; questo significa che gli eventi riflessi non vengono inviati.
Gli eventi riflessi si manifestano nelle righe di testo come istanze della classe TextLineMirrorRegion
. A seconda dell'elaborazione bidirezionale e delle interruzioni di riga, si possono generare una o più aree speculari.
Il valore predefinito è null
.
Implementazione
public function get eventMirror():EventDispatcher
public function set eventMirror(value:EventDispatcher):void
Elementi API correlati
groupElement | proprietà |
groupElement:GroupElement
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
L'oggetto GroupElement che contiene questo elemento; oppure null
se non fa parte di un gruppo.
Il valore predefinito è null
.
Implementazione
public function get groupElement():GroupElement
Elementi API correlati
rawText | proprietà |
rawText:String
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Una copia del testo nell'elemento, inclusi i caratteri U+FDEF. Il carattere Unicode, U+FDEF, indica la posizione di un elemento grafico nella stringa.
Implementazione
public function get rawText():String
text | proprietà |
text:String
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Una copia del testo nell'elemento, esclusi i caratteri U+FDEF che rappresentano elementi grafici nella stringa.
Implementazione
public function get text():String
Elementi API correlati
textBlock | proprietà |
textBlock:flash.text.engine:TextBlock
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
L'oggetto TextBlock al quale appartiene questo elemento.
Il valore predefinito è null
.
Implementazione
public function get textBlock():flash.text.engine:TextBlock
Elementi API correlati
textBlockBeginIndex | proprietà |
textBlockBeginIndex:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
L'indice nel testo del blocco di testo del primo carattere di questo elemento. Questo valore non viene memorizzato nella cache, ma viene calcolato ogni volta che chiamate questo metodo.
Il valore predefinito è -1.
Implementazione
public function get textBlockBeginIndex():int
textRotation | proprietà |
textRotation:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
La rotazione da applicare all'elemento come un'unità. Utilizzate le costanti TextRotation
per questa proprietà.
Il valore predefinito è TextRotation.ROTATE_0
.
La rotazione finale di qualsiasi glifo è la somma di , ElementFormat.textRotation
, ContentElement.textRotation
e TextBlock.lineRotation
.
ContentElement.textRotation
viene usato per creare una breve sequenza di testo la cui rotazione è diversa dalla riga che la contiene. Ne sono un esempio le sequenze TCY nel testo in giapponese. TCY è l'acronimo di Tate-Chu-Yoko e si riferisce a una piccola sequenza di testo orizzontale (di solito un numero) presente in alcune porzioni di testo verticale in giapponese. Per creare un paragrafo di testo verticale in giapponese contenente una sequenza TCY, procedete come segue:
- Impostate
TextBlock.lineRotation=TextRotation.ROTATE_90
- Impostate
TextBlock.content
su un oggetto GroupElement, formato tra tre oggetti TextElement. Il primo di questi elementi dovrebbe essere il testo in giapponese prima della sequenza TCY, il secondo il testo latino della sequenza TCY e il terzo il testo in giapponese dopo la sequenza TCY. - Impostate la proprietà
textRotation
dell'oggetto TextElement TCY suTextRotation.ROTATE_270
. L'elemento di testo TCY viene ruotato come un'unità. Inizia con una rotazione di 90° ereditata dalla riga. L'aggiunta di altri 270° lo riporta in orizzontale.
Gli elementi di contenuto ruotati non possono essere nidificati. In una gerarchia di elementi di contenuto, indipendentemente dalla complessità, potete impostare la proprietà textRotation
solo per un elemento di contenuto. I metodi e le funzioni setter delle proprietà riportati di seguito generano un ArgumentError se vengono rilevate rotazioni nidificate:
ContentElement.textRotation
GroupElement.setElements
GroupElement.replaceElements
Per impostare i valori di questa proprietà, utilizzate i seguenti valori stringa:
Valore stringa | Descrizione |
---|---|
TextRotation.ROTATE_0 | L'elemento non viene ruotato. |
TextRotation.ROTATE_90 | L'elemento viene ruotato di 90 gradi in senso orario. |
TextRotation.ROTATE_180 | L'elemento viene ruotato di 180 gradi. |
TextRotation.ROTATE_270 | L'elemento viene ruotato di 270 gradi in senso orario. |
TextRotation.AUTO | Non supportati. |
Implementazione
public function get textRotation():String
public function set textRotation(value:String):void
Genera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di TextRotation.
| |
ArgumentError — Se impostato su TextRotation.AUTO .
| |
ArgumentError — Se l'operazione restituisce rotazioni nidificate all'interno di un oggetto GroupElement.
|
Elementi API correlati
userData | proprietà |
public var userData:*
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Fornisce un modo per consentire a un'applicazione di associare dati arbitrari con l'elemento.
Il valore predefinito è null
.
ContentElement | () | Funzione di costruzione |
public function ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Una chiamata alla funzione di costruzione new ContentElement()
genera un'eccezione ArgumentError
. Potete invece chiamare funzioni di costruzione per le seguenti sottoclassi di ContentElement:
new GraphicElement()
nuovo GroupElement()
nuovo TextElement()
elementFormat:ElementFormat (default = null ) — Il formato dell'elemento per il testo contenuto nell'elemento. Il valore predefinito è null .
| |
eventMirror:EventDispatcher (default = null ) — L'oggetto EventDispatcher che riceve le copie di ogni evento inviato alle righe di testo valide create in base a questo elemento content. Il valore predefinito è null .
| |
textRotation:String (default = "rotate0 ") — La rotazione applicata all'elemento come un'unità. Utilizzate le costanti TextRotation per questa proprietà. Il valore predefinito è TextRotation.ROTATE_0 .
|
GRAPHIC_ELEMENT | Costante |
Tue Jun 12 2018, 02:44 PM Z