TextElement

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

La classe TextElement rappresenta una stringa di testo formattato. Assegnate un oggetto TextElement alla proprietà 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

ContentElement
ElementFormat
TextBlock

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

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		TextElement(text:String = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0") Crea una nuova istanza TextElement.	TextElement
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		replaceText(beginIndex:int, endIndex:int, newText:String):void Sostituisce un intervallo di caratteri, specificato dai parametri indiceIniziale e indiceFinale, con il contenuto del parametro nuovoTesto.	TextElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

Costanti pubbliche

Nascondi costanti pubbliche ereditate

Mostra costanti pubbliche ereditate

	Costante		Definito da

Descrizione delle proprietà

text

proprietà

text:String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

Riceve il testo che costituisce il contenuto dell'elemento.

Il valore predefinito è null.

Implementazione
public function get text():String
public function set text(value:String):void

Descrizione della funzione di costruzione

()

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.

Parametri

	`text:String` (default = `null`) — Il testo per l'elemento. Il valore predefinito è `null`.

	`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 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`.

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

Sostituzione del testo

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);
        }
    }
}

Note legali | Informativa sulla privacy online

TextElement - AS3

Classi x

text

TextElement

replaceText