| Pacchetto | flash.text.engine |
| Classe | public final class TextElement |
| Ereditarietà | TextElement  ContentElement Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
content di un oggetto TextBlock per creare un blocco di testo. Assegnatelo a un oggetto GroupElement per combinarlo con altri elementi di testo e grafici come un'unità. Utilizzate la classe ElementFormat per formattare il testo.
Elementi API correlati
Proprietà pubbliche
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| 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
Riceve il testo che costituisce il contenuto dell'elemento. | TextElement | ||
| 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 | |
Metodi pubblici
| Metodo | Definito da | ||
|---|---|---|---|
TextElement(text:String = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Crea una nuova istanza TextElement. | TextElement | ||
|
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 | |
Sostituisce un intervallo di caratteri, specificato dai parametri indiceIniziale e indiceFinale, con il contenuto del parametro nuovoTesto. | TextElement | ||
|
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 | |
Costanti pubbliche
Descrizione delle proprietà
text | proprietà |
Descrizione della funzione di costruzione
TextElement | () | Funzione di costruzione |
public function TextElement(text:String = null, 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 |
Crea una nuova istanza TextElement.
Parametritext:String (default = null)null.
| |
elementFormat:ElementFormat (default = null)null.
| |
eventMirror:EventDispatcher (default = null)EventDispatcher che riceve le copie di ogni evento inviato alle righe di testo in base a questo elemento content. Il valore predefinito è null.
| |
textRotation:String (default = "rotate0")TextRotation per questa proprietà. Il valore predefinito è TextRotation.ROTATE_0.
|
Esempio ( Come utilizzare questo esempio )
Nell'esempio seguente viene creato un oggetto TextElement da una stringa di testo, viene formattato utilizzando una dimensione del carattere 12 e il colore rosso (0xCC0000), quindi assegnato alla proprietà
content di un TextBlock. Chiama la funzione createLines() per interrompere il blocco di testo in righe di 150 pixel ognuna.
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);
}
}
}
}
Descrizione dei metodi
replaceText | () | metodo |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Sostituisce un intervallo di caratteri, specificato dai parametri beginIndex e endIndex, con il contenuto del parametro newText. I valori beginIndex e endIndex si riferiscono al contenuto attuale di text.
Per eliminare del testo, passate null per newText.
Per inserire del testo, passate lo stesso valore per beginIndex and endIndex. Il nuovo testo viene inserito prima dell'indice specificato.
Per aggiungere del testo, passate text.length per beginIndex e endIndex.
Per impostare tutto il testo, passate 0 per beginIndex e text.length per endIndex.
Parametri
beginIndex:int — L'indice a base zero del punto iniziale dell'intervallo da sostituire.
| |
endIndex:int — Il valore dell'indice a base zero che segue la posizione finale dell'intervallo da sostituire.
| |
newText:String — Il testo da utilizzare per la sostituzione dell'intervallo di caratteri specificato.
|
Genera
RangeError — Il valore beginIndex o endIndex specificato non rientra nell'intervallo.
|
Altri esempi
Esempio ( Come utilizzare questo esempio )
In questo esempio viene chiamato più volte
replaceText() per eseguire le seguenti operazioni:
- inserire una stringa all'inizio del testo
- aggiungere una stringa alla fine del testo
- inserire una stringa al centro del testo
- sostituire interamente il testo con uno nuovo
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, 02:44 PM Z