Referência do ActionScript® 3.0 para Adobe® Flash® Platform
Início  |  Ocultar listas de Pacotes e Classes |  Pacotes  |  Classes  |  Novidades  |  Índice  |  Apêndices  |  Por que inglês?
Filtros: Recuperando dados do servidor...
Recuperando dados do servidor...
flashx.textLayout.factory 

StringTextLineFactory  - AS3

Pacoteflashx.textLayout.factory
Classepublic class StringTextLineFactory
HerançaStringTextLineFactory Inheritance TextLineFactoryBase Inheritance Object

Versão da linguagem: ActionScript 3.0
Versões de runtime: Flash Player 10, AIR 1.5

A classe StringTextLineFactory é uma maneira simples de criar TextLines a partir de uma string.

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.

Veja os exemplos

Elementos da API relacionados



Propriedades públicas
 PropriedadeDefinido por
 InheritedcompositionBounds : 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
 Inheritedconstructor : 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
 InheritedhorizontalScrollPolicy : String
Especifica como as linhas são criadas quando os limites da composição não forem suficientemente grandes.
TextLineFactoryBase
 InheritedisTruncated : 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
 InheritedswfContext : 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
 InheritedtruncationOptions : flashx.textLayout.factory:TruncationOptions
Especifica as opções para truncar o texto caso ele não caiba nos limites de composição.
TextLineFactoryBase
 InheritedverticalScrollPolicy : String
Especifica como as linhas são criadas quando os limites da composição não forem suficientemente grandes.
TextLineFactoryBase
Métodos públicos
 MétodoDefinido por
  
Cria um objeto StringTextLineFactory.
StringTextLineFactory
  
Cria objetos TextLine usando o texto atribuído no momento a este objeto de fábrica.
StringTextLineFactory
 Inherited
O menor retângulo no qual o conteúdo disposto cabe.
TextLineFactoryBase
 Inherited
Indica se um objeto tem uma propriedade especificada definida.
Object
 Inherited
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.
Object
 Inherited
Indica se a propriedade especificada existe e é enumerável.
Object
 Inherited
Define a disponibilidade de uma propriedade dinâmica para operações de repetição.
Object
 Inherited
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.
Object
 Inherited
Retorna a representação de string do objeto especificado.
Object
 Inherited
Retorna o valor primitivo do objeto especificado.
Object
Detalhes da propriedade

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():IConfiguration

defaultConfiguration

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():IConfiguration

paragraphFormat

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):void

spanFormat

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):void

text

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):void

textFlowFormat

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):void
Detalhes do construtor

StringTextLineFactory

()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âmetros
configuration:IConfiguration (default = null) — O objeto de configuração usado para definir as propriedades do objeto TextFlow interno usado para compor as linhas geradas por esta fábrica.
Detalhes do método

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.

StringTextLineFactory_example.as

O exemplo a seguir utiliza StringTextLineFactory para criar um conjunto de linhas de texto a partir de uma string. O método de fábrica, 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 );
        }
    }
}




[ X ]Por que inglês?
O conteúdo na Referência do ActionScript 3.0 aparece em inglês

Nem todas as partes da Referência do ActionScript 3.0 estão traduzidas em todos os idiomas. Quando um elemento de um idioma não está traduzido, ele é exibido em inglês. Por exemplo, a classe ga.controls.HelpBox não está traduzida em nenhum idioma. Por isso, na versão da referência em português do Brasil, a classe ga.controls.HelpBox é exibida em inglês.