| Pacote | flash.text.engine |
| Classe | public final class TextElement |
| Herança | TextElement  ContentElement Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
content de um objeto TextBlock para criar um bloco de texto. Atribua-o a um objeto GroupElement para combiná-lo com outros elementos gráficos e de texto como uma unidade. Use a classe ElementFormat para formatar o texto.
Elementos da API relacionados
Propriedades públicas
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| elementFormat : ElementFormat
O objeto ElementFormat usado para o elemento. | ContentElement | |
| eventMirror : EventDispatcher
O objeto EventDispatcher que recebe cópias de todos os eventos despachados para linhas de texto válidas com base no elemento de conteúdo. | ContentElement | |
| groupElement : GroupElement [somente leitura]
O objeto GroupElement que contém esse elemento, ou nulo, se ele não estiver em um grupo. | ContentElement | |
| rawText : String [somente leitura]
Uma cópia do texto no elemento, incluindo quaisquer caracteres U+FDEF. | ContentElement | |
| text : String
Recebe o texto conteúdo do elemento. | TextElement | ||
| textBlock : flash.text.engine:TextBlock [somente leitura]
O TextBlock ao qual esse elemento pertence. | ContentElement | |
| textBlockBeginIndex : int [somente leitura]
O índice no bloco de texto dos primeiros caracteres desse elemento. | ContentElement | |
| textRotation : String
O giro a ser aplicado ao elemento como uma unidade. | ContentElement | |
| userData : *
Fornece uma maneira para um aplicativo associar dados arbitrários ao elemento. | ContentElement | |
Métodos públicos
| Método | Definido por | ||
|---|---|---|---|
TextElement(text:String = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Cria uma nova instância de TextElement. | TextElement | ||
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
Substitui o intervalo de caracteres especificado pelos parâmetros beginIndex e endIndex pelo conteúdo do parâmetro newText. | TextElement | ||
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
Constantes públicas
Detalhes da propriedade
text | propriedade |
Detalhes do construtor
TextElement | () | Construtor |
public function TextElement(text:String = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Cria uma nova instância de TextElement.
Parâmetrostext:String (default = null)null.
| |
elementFormat:ElementFormat (default = null)null.
| |
eventMirror:EventDispatcher (default = null)EventDispatcher que recebe cópias de todos os eventos despachados para linhas de texto baseadas no elemento de conteúdo. O valor padrão é null.
| |
textRotation:String (default = "rotate0")TextRotation para a propriedade. O valor padrão é TextRotation.ROTATE_0.
|
Exemplo ( Como usar este exemplo )
O seguinte exemplo cria um objeto TextElement de uma string de texto, o formata usando um tamanho de fonte igual a 12 e a cor vermelha (0xCC0000), além de atribuí-lo à propriedade
content de um TextBlock. Ele chama a função createLines() para quebrar o bloco de texto em linhas de 150 pixels cada.
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);
}
}
}
}
Detalhes do método
replaceText | () | método |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Substitui o intervalo de caracteres especificado pelos parâmetros beginIndex e endIndex pelo conteúdo do parâmetro newText. Os valores beginIndex e endIndex se referem ao conteúdo atual de text.
Para excluir textos, transmita null para newText.
Para inserir texto, transmita o mesmo valor para beginIndex e endIndex. O novo texto é inserido antes do índice especificado.
Para anexar textos, transmita text.length para beginIndex e endIndex.
Para definir todo o texto, transmita 0 para beginIndex e text.length para endIndex.
Parâmetros
beginIndex:int — O valor de índice com base em zero da posição inicial do intervalo de substituição.
| |
endIndex:int — O valor de índice baseado em zero que segue a posição final do intervalo de substituição.
| |
newText:String — O texto a ser utilizado para substituir o intervalo especificado de caracteres.
|
Lança
RangeError — O beginIndex ou endIndex especificado está fora do intervalo.
|
Exemplo ( Como usar este exemplo )
O exemplo chama
replaceText() várias vezes para fazer o seguinte:
- inserir uma string no início de texto
- acrescentar uma string ao final do texto
- inserir uma string no meio do texto
- substituir o texto inteiramente por novo texto
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);
}
}
}
Wed Jun 13 2018, 11:10 AM Z