| Pacote | flashx.textLayout.factory |
| Classe | public class StringTextLineFactory |
| Herança | StringTextLineFactory  TextLineFactoryBase Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
As linhas de texto são estáticas e são criadas com um único formato e um único parágrafo. As linhas são criadas para caber no retângulo limitador especificado.
StringTextLineFactory é uma maneira eficiente de criar TextLines, pois reutiliza objetos TextFlow, ParagraphElement, SpanElement e ContainerController simples em várias chamadas repetidas. Você pode criar uma única fábrica e reutilizá-la várias vezes. Também é possível reutilizar todas as partes que forem iguais sempre que elas forem chamadas; por exemplo, você pode reutilizar os vários formatos e os limites.
Nota: para criar linhas estáticas que utilizem vários formatos ou parágrafos, ou que incluam gráficos inline, use um objeto TextFlowTextLineFactory e um objeto TextFlow.
Observe: O StringTextLineFactory ignora o conjunto de propriedades truncationIndicatorFormat no truncationOptions ao truncar o texto.
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | compositionBounds : Rectangle
O retângulo dentro do qual são criadas linhas de texto. | TextLineFactoryBase | |
| configuration : IConfiguration [somente leitura]
A configuração usada pelo objeto interno TextFlow. | StringTextLineFactory | ||
| constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| defaultConfiguration : IConfiguration [estático] [somente leitura]
A configuração padrão usada por esta fábrica se nenhuma for especificada. | StringTextLineFactory | ||
| horizontalScrollPolicy : String
Especifica como as linhas são criadas quando os limites da composição não forem suficientemente grandes. | TextLineFactoryBase | |
| isTruncated : Boolean [somente leitura]
Indica se o texto foi truncado quando foram criadas linhas pela última vez. | TextLineFactoryBase | |
| paragraphFormat : flashx.textLayout.formats:ITextLayoutFormat
O formato do parágrafo. | StringTextLineFactory | ||
| spanFormat : flashx.textLayout.formats:ITextLayoutFormat
O formato do caractere. | StringTextLineFactory | ||
| swfContext : ISWFContext
A instância ISWFContext usada para fazer chamadas FTE conforme necessário. | TextLineFactoryBase | |
| text : String
O texto a ser convertido em objetos TextLine. | StringTextLineFactory | ||
| textFlowFormat : flashx.textLayout.formats:ITextLayoutFormat
O formato do fluxo de texto. | StringTextLineFactory | ||
| truncationOptions : flashx.textLayout.factory:TruncationOptions
Especifica as opções para truncar o texto caso ele não caiba nos limites de composição. | TextLineFactoryBase | |
| verticalScrollPolicy : String
Especifica como as linhas são criadas quando os limites da composição não forem suficientemente grandes. | TextLineFactoryBase | |
| Método | Definido por | ||
|---|---|---|---|
StringTextLineFactory(configuration:IConfiguration = null)
Cria um objeto StringTextLineFactory. | StringTextLineFactory | ||
Cria objetos TextLine usando o texto atribuído no momento a este objeto de fábrica. | StringTextLineFactory | ||
|
O menor retângulo no qual o conteúdo disposto cabe. | TextLineFactoryBase | |
|
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 | |
|
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 | |
configuration | propriedade |
configuration:IConfiguration [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A configuração usada pelo objeto interno TextFlow.
Implementação
public function get configuration():IConfigurationdefaultConfiguration | propriedade |
defaultConfiguration:IConfiguration [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A configuração padrão usada por esta fábrica se nenhuma for especificada.
Implementação
public static function get defaultConfiguration():IConfigurationparagraphFormat | propriedade |
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O formato do parágrafo.
Implementação
public function get paragraphFormat():flashx.textLayout.formats:ITextLayoutFormat public function set paragraphFormat(value:flashx.textLayout.formats:ITextLayoutFormat):voidspanFormat | propriedade |
spanFormat:flashx.textLayout.formats:ITextLayoutFormat| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O formato do caractere.
Implementação
public function get spanFormat():flashx.textLayout.formats:ITextLayoutFormat public function set spanFormat(value:flashx.textLayout.formats:ITextLayoutFormat):voidtext | propriedade |
text:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O texto a ser convertido em objetos TextLine.
Para gerar TextLines, chame createTextLines() após definir esta propriedade text e os formatos desejados.
Implementação
public function get text():String public function set text(value:String):voidtextFlowFormat | propriedade |
textFlowFormat:flashx.textLayout.formats:ITextLayoutFormat| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O formato do fluxo de texto.
Implementação
public function get textFlowFormat():flashx.textLayout.formats:ITextLayoutFormat public function set textFlowFormat(value:flashx.textLayout.formats:ITextLayoutFormat):voidStringTextLineFactory | () | Construtor |
public function StringTextLineFactory(configuration:IConfiguration = null)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Cria um objeto StringTextLineFactory.
Parâmetrosconfiguration:IConfiguration (default = null) |
createTextLines | () | método |
public function createTextLines(callback:Function):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Cria objetos TextLine usando o texto atribuído no momento a este objeto de fábrica.
As linhas de texto são criadas usando o texto e os formatos atribuídos no momento e são compostas de forma a caber nos limites atribuídos à propriedade compositionBounds. À medida que cada linha é criada, a fábrica chama a função especificada no parâmetro callback. Esta função é transmitida ao objeto TextLine, sendo responsável pela exibição da linha.
Para criar um conjunto diferente de linhas, altere qualquer propriedade desejada e chame createTextLines() novamente.
Observe que as políticas rolagem de fábrica controlarão quantas linhas serão geradas.
Parâmetros
callback:Function — Função de callback chamada para cada objeto TextLine criado.
|
createTextLines() é chamado duas vezes com o uso da mesma frase. As propriedades da fábrica são ajustadas entre as chamadas para criar um efeito de "sombra".
package flashx.textLayout.factory.examples {
import flash.display.DisplayObject;
import flash.display.Sprite;
import flash.geom.Rectangle;
import flashx.textLayout.factory.StringTextLineFactory;
import flashx.textLayout.formats.TextLayoutFormat;
public class StringTextLineFactory_example extends Sprite
{
public function StringTextLineFactory_example()
{
var factory:StringTextLineFactory = new StringTextLineFactory();
factory.compositionBounds = new Rectangle( 100, 100, 200, 130 );
var format:TextLayoutFormat = new TextLayoutFormat();
format.fontFamily = "LilyUPC, Verdana, _sans";
format.fontSize = 32;
format.color = 0x000000;
format.textAlpha = .5;
factory.spanFormat = format;
factory.text = "The quick brown fox jumped over the lazy dog.";
factory.createTextLines( useTextLines );
factory.compositionBounds = new Rectangle( 99, 99, 200, 130 );
format.color = 0x990000;
format.textAlpha = 1;
factory.spanFormat = format;
factory.createTextLines( useTextLines );
graphics.beginFill(0x555555,.5);
graphics.drawRect( 99, 99, 201, 131 );
graphics.endFill();
}
private function useTextLines( line:DisplayObject ):void
{
var displayObject:DisplayObject = this.addChild( line );
}
}
}
Wed Jun 13 2018, 11:10 AM Z