Configuration

Pacote	flashx.textLayout.elements
Classe	public class Configuration
Herança	Configuration Object
Implementações	IConfiguration

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

A classe Configuration é um ponto principal de integração entre o Text Layout Framework e um aplicativo. Você pode incluir um objeto Configuration como parâmetro do construtor TextFlow() ao criar uma nova instância de TextFlow. Permite que o aplicativo controle inicialmente o comportamento do Text Layout Framework.

A classe Configuration permite que você especifique os formatos inicial, de parágrafo e de contêiner do fluxo de texto através da propriedade textFlowInitialFormat. Também permite que você especifique atributos iniciais de formatação para links, seleção, rolagem e para tratar as teclas Tab e Enter.

Veja os exemplos

Mais exemplos

Applying styles with the Configuration class

Elementos da API relacionados

ITextLayoutFormat
SelectionFormat
TextFlow

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
		defaultLinkActiveFormat : flashx.textLayout.formats:ITextLayoutFormat Especifica os atributos ativos de formato de caracteres válidos inicialmente para todos os links (objetos LinkElement) no fluxo de texto.	Configuration
		defaultLinkHoverFormat : flashx.textLayout.formats:ITextLayoutFormat Especifica os atributos iniciais de formato de caracteres válidos para um link (LinkElement) no fluxo de texto quando o cursor passa por cima deles.	Configuration
		defaultLinkNormalFormat : flashx.textLayout.formats:ITextLayoutFormat Especifica os atributos iniciais de link para todos os objetos LinkElement no fluxo de texto.	Configuration
		defaultListMarkerFormat : IListMarkerFormat Especifica os atributos ativos de formato de caracteres válidos inicialmente para todos os ListItems no fluxo de texto.	Configuration
		enableAccessibility : Boolean Especifica se o suporte à acessibilidade está ativado ou não.	Configuration
		flowComposerClass : Class Especifica o tipo de compositor de fluxo a ser anexado por padrão a um novo objeto TextFlow.	Configuration
		focusedSelectionFormat : SelectionFormat O formato de seleção inicial (SelectionFormat) de um fluxo de texto (TextFlow) quando o foco estiver na sua janela.	Configuration
		inactiveSelectionFormat : SelectionFormat O formato de seleção inicial (SelectionFormat) de um fluxo de texto (TextFlow) quando sua janela estiver inativa.	Configuration
		inlineGraphicResolverFunction : Function Especifica o callback usado para resolver um elemento gráfico em linha.	Configuration
		manageEnterKey : Boolean Especifica se a tecla Enter/Return é reconhecida como texto pelo Text Layout Framework, para dividir um parágrafo, por exemplo, ou se o código do cliente tratará dessa tecla.	Configuration
		manageTabKey : Boolean Especifica se a tecla TAB será reconhecida como texto pelo Text Layout Framework, ou se o Flash Player ou o AIR tratarão dessa tecla e a transformarão em um evento de painel com guias.	Configuration
		overflowPolicy : String Política usada para decidir se a última linha de um contêiner cabe no contêiner ou se o ultrapassa.	Configuration
		releaseLineCreationData : Boolean Solicita que o processo de composição de texto libere os dados de criação de linhas depois de compor cada parágrafo.	Configuration
		scrollDragDelay : Number Especifica um atraso temporizado entre uma rolagem e a rolagem seguinte para evitar uma rolagem muito rápida.	Configuration
		scrollDragPixels : Number Especifica o número padrão de pixels a ser rolado quando o usuário iniciar a rolagem automática arrastando a seleção.	Configuration
		scrollMouseWheelMultiplier : Number Especifica o número padrão de pixels a ser rolado quando a roda do mouse for utilizada.	Configuration
		scrollPagePercentage : Number Especifica a porcentagem padrão do fluxo de texto a ser rolada nas rolagens de página.	Configuration
		textFlowInitialFormat : flashx.textLayout.formats:ITextLayoutFormat Especifica a configuração inicial do formato TextLayoutFormat de um fluxo de texto (objeto TextFlow).	Configuration
		unfocusedSelectionFormat : SelectionFormat O formato inicial de seleção usado pelo Text Layout Framework para desenhar a seleção quando a janela estiver ativa sem que os contêineres do TextFlow levem o foco.	Configuration

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		Configuration(initializeWithDefaults:Boolean = true) Construtor – cria uma configuração padrão.	Configuration
		clone():Configuration Cria um clone do objeto Configuration.	Configuration
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Retorna a representação de string do objeto especificado.	Object
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object

Detalhes da propriedade

defaultLinkActiveFormat

propriedade

defaultLinkActiveFormat:flashx.textLayout.formats:ITextLayoutFormat

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica os atributos ativos de formato de caracteres válidos inicialmente para todos os links (objetos LinkElement) no fluxo de texto. Esses são os padrões dos novos objetos LinkElement que não especificam valores para esses atributos.

O padrão é null.

Implementação
public function get defaultLinkActiveFormat():flashx.textLayout.formats:ITextLayoutFormat
public function set defaultLinkActiveFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

Elementos da API relacionados

FlowElement.linkActiveFormat
ITextLayoutFormat
LinkElement

defaultLinkHoverFormat

propriedade

defaultLinkHoverFormat:flashx.textLayout.formats:ITextLayoutFormat

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica os atributos iniciais de formato de caracteres válidos para um link (LinkElement) no fluxo de texto quando o cursor passa por cima deles. Esses são os padrões dos novos objetos LinkElement que não especificam valores para esses atributos.

O padrão é null.

Implementação
public function get defaultLinkHoverFormat():flashx.textLayout.formats:ITextLayoutFormat
public function set defaultLinkHoverFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

Elementos da API relacionados

FlowElement.linkHoverFormat
ITextLayoutFormat
LinkElement

defaultLinkNormalFormat

propriedade

defaultLinkNormalFormat:flashx.textLayout.formats:ITextLayoutFormat

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica os atributos iniciais de link para todos os objetos LinkElement no fluxo de texto. Esses são os valores padrão dos novos objetos LinkElement que não especificam valores para esses atributos. O formato normal padrão exibe o link em azul com sublinhado.

Implementação
public function get defaultLinkNormalFormat():flashx.textLayout.formats:ITextLayoutFormat
public function set defaultLinkNormalFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

Elementos da API relacionados

FlowElement.linkNormalFormat
ITextLayoutFormat
LinkElement

defaultListMarkerFormat

propriedade

defaultListMarkerFormat:IListMarkerFormat

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica os atributos ativos de formato de caracteres válidos inicialmente para todos os ListItems no fluxo de texto. Esses são os padrões dos novos objetos ListItemElements que não especificam valores para esses atributos.

O padrão é null.

Implementação
public function get defaultListMarkerFormat():IListMarkerFormat
public function set defaultListMarkerFormat(value:IListMarkerFormat):void

Elementos da API relacionados

FlowElement.listMarkerFormat
IListMarkerFormat
LinkElement

enableAccessibility

propriedade

enableAccessibility:Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica se o suporte à acessibilidade está ativado ou não. Se for true, os leitores de tela poderão ler o conteúdo do TextFlow.

O valor padrão é false.

Implementação
public function get enableAccessibility():Boolean
public function set enableAccessibility(value:Boolean):void

Elementos da API relacionados

TextFlow

flowComposerClass

propriedade

flowComposerClass:Class

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica o tipo de compositor de fluxo a ser anexado por padrão a um novo objeto TextFlow. O valor padrão é StandardFlowComposer.

Implementação
public function get flowComposerClass():Class
public function set flowComposerClass(value:Class):void

Elementos da API relacionados

StandardFlowComposer
TextFlow

focusedSelectionFormat

propriedade

focusedSelectionFormat:SelectionFormat

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

O formato de seleção inicial (SelectionFormat) de um fluxo de texto (TextFlow) quando o foco estiver na sua janela. O Text Layout Framework utiliza focusedSelectionFormat para desenhar a seleção quando a janela está ativa e quando o foco está em um dos contêineres do TextFlow. Se desejar, você pode ignorar este formato usando SelectionManager.focusedSelectionFormat.

A classe SelectionFormat especifica os valores padrão que invertem a cor do texto e o fundo.

Implementação
public function get focusedSelectionFormat():SelectionFormat
public function set focusedSelectionFormat(value:SelectionFormat):void

Elementos da API relacionados

SelectionFormat
SelectionManager.focusedSelectionFormat
TextFlow

inactiveSelectionFormat

propriedade

inactiveSelectionFormat:SelectionFormat

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

O formato de seleção inicial (SelectionFormat) de um fluxo de texto (TextFlow) quando sua janela estiver inativa. O Text Layout Framework usa inactiveSelectionFormat para desenhar a seleção quando a janela está inativa. Se desejar, você pode ignorar este formato usando SelectionManager.inactiveSelectionFormat.

Se você não substituir unfocusedSelectionFormat, os valores de SelectionFormat usados serão:

colora=0xffffff (branco)
alpha = 0
blendMode=flash.display.BlendMode. DIFFERENCE

O resultado é que nenhuma seleção será exibida.

Implementação
public function get inactiveSelectionFormat():SelectionFormat
public function set inactiveSelectionFormat(value:SelectionFormat):void

Elementos da API relacionados

SelectionFormat
SelectionManager.inactiveSelectionFormat
TextFlow

inlineGraphicResolverFunction

propriedade

inlineGraphicResolverFunction:Function

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica o callback usado para resolver um elemento gráfico em linha. O callback pega um objeto flashx.textLayout.elements.InlineGraphicElement e retorna o valor para ser usado como flashx.textLayout.elements.InlineGraphicElement#source do elemento. Este callback fornece o mecanismo para atrasar o fornecimento da origem de um elemento gráfico em linha até antes de ele ser composto.

Nota: este callback será invocado somente se uma origem de espaço reservado de tipo de string já estiver definida. Além disso, pode ser invocado diversas vezes.

Implementação
public function get inlineGraphicResolverFunction():Function
public function set inlineGraphicResolverFunction(value:Function):void

Elementos da API relacionados

InlineGraphicElement

manageEnterKey

propriedade

manageEnterKey:Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica se a tecla Enter/Return é reconhecida como texto pelo Text Layout Framework, para dividir um parágrafo, por exemplo, ou se o código do cliente tratará dessa tecla. O código do cliente pode cuidar disso, enviando um formulário que possui um botão predefinido para essa finalidade, por exemplo.

O valor padrão é true.

Implementação
public function get manageEnterKey():Boolean
public function set manageEnterKey(value:Boolean):void

manageTabKey

propriedade

manageTabKey:Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica se a tecla TAB será reconhecida como texto pelo Text Layout Framework, ou se o Flash Player ou o AIR tratarão dessa tecla e a transformarão em um evento de painel com guias.

O valor padrão é false.

Implementação
public function get manageTabKey():Boolean
public function set manageTabKey(value:Boolean):void

overflowPolicy

propriedade

overflowPolicy:String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Política usada para decidir se a última linha de um contêiner cabe no contêiner ou se o ultrapassa. Use as constantes da classe OverflowPolicy para definir esta propriedade.

O valor padrão é OverflowPolicy.FIT_DESCENDERS, que caberá na linha da área de composição se a área do alto até a linha de base couber.

Implementação
public function get overflowPolicy():String
public function set overflowPolicy(value:String):void

Elementos da API relacionados

OverflowPolicy

releaseLineCreationData

propriedade

releaseLineCreationData:Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Solicita que o processo de composição de texto libere os dados de criação de linhas depois de compor cada parágrafo. Esta solicitação economiza memória, mas deixa o processo de composição mais lento.

O valor padrão é false.

Implementação
public function get releaseLineCreationData():Boolean
public function set releaseLineCreationData(value:Boolean):void

Elementos da API relacionados

StandardFlowComposer
TextBlock.releaseLineCreationData()

scrollDragDelay

propriedade

scrollDragDelay:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica um atraso temporizado entre uma rolagem e a rolagem seguinte para evitar uma rolagem muito rápida. Esse valor especifica o atraso, em milissegundos. O valor padrão é 35.

Implementação
public function get scrollDragDelay():Number
public function set scrollDragDelay(value:Number):void

scrollDragPixels

propriedade

scrollDragPixels:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica o número padrão de pixels a ser rolado quando o usuário iniciar a rolagem automática arrastando a seleção. O valor padrão é 20.

Implementação
public function get scrollDragPixels():Number
public function set scrollDragPixels(value:Number):void

scrollMouseWheelMultiplier

propriedade

scrollMouseWheelMultiplier:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica o número padrão de pixels a ser rolado quando a roda do mouse for utilizada. O valor padrão é 20.

Implementação
public function get scrollMouseWheelMultiplier():Number
public function set scrollMouseWheelMultiplier(value:Number):void

scrollPagePercentage

propriedade

scrollPagePercentage:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica a porcentagem padrão do fluxo de texto a ser rolada nas rolagens de página. O valor padrão é 7.0/8.0 ou .875.

Implementação
public function get scrollPagePercentage():Number
public function set scrollPagePercentage(value:Number):void

textFlowInitialFormat

propriedade

textFlowInitialFormat:flashx.textLayout.formats:ITextLayoutFormat

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Especifica a configuração inicial do formato TextLayoutFormat de um fluxo de texto (objeto TextFlow).

O padrão é null.

Implementação
public function get textFlowInitialFormat():flashx.textLayout.formats:ITextLayoutFormat
public function set textFlowInitialFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

Elementos da API relacionados

TextFlow
ITextLayoutFormat

unfocusedSelectionFormat

propriedade

unfocusedSelectionFormat:SelectionFormat

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

O formato inicial de seleção usado pelo Text Layout Framework para desenhar a seleção quando a janela estiver ativa sem que os contêineres do TextFlow levem o foco. Se desejar, você pode ignorar este formato usando SelectionManager.unfocusedSelectionFormat.

Se você não substituir unfocusedSelectionFormat, os valores de SelectionFormat usados serão:

colora=0xffffff (branco)
alpha = 0
blendMode=flash.display.BlendMode. DIFFERENCE

O resultado é que nenhuma seleção será exibida.

Implementação
public function get unfocusedSelectionFormat():SelectionFormat
public function set unfocusedSelectionFormat(value:SelectionFormat):void

Elementos da API relacionados

SelectionFormat
SelectionManager.unfocusedSelectionFormat
TextFlow

Detalhes do construtor

()

Construtor

public function Configuration(initializeWithDefaults:Boolean = true)

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Construtor – cria uma configuração padrão.

Parâmetros

initializeWithDefaults:Boolean (default = true) — Especifica se a configuração será inicializada com os valores padrão. O padrão é true. Se o valor for definido como false, será inicializado sem os valores padrão, economizando, assim, alguns objetos. O método clone() atribui o valor false e copia as propriedades do objeto original.

Elementos da API relacionados

SelectionFormat
StandardFlowComposer

Detalhes do método

clone

()

método

public function clone():Configuration

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Cria um clone do objeto Configuration.

Retorna

Configuration

Detalhes da constante

hasTouchScreen

Constante

tlf_internal static const hasTouchScreen:Boolean

Exemplos Como usar este exemplo

ConfigurationExample.as

Este exemplo cria uma configuração inicial de formato aplicada a um TextFlow que consiste em um parágrafo e um link.

package flashx.textLayout.elements.examples {
    import flash.display.Sprite;
    import flash.text.engine.FontPosture;
    import flash.text.engine.Kerning;
    
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.edit.SelectionFormat;
    import flashx.textLayout.edit.SelectionManager;
    import flashx.textLayout.elements.Configuration;
    import flashx.textLayout.elements.LinkElement;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextAlign;
    import flashx.textLayout.formats.TextDecoration;
    import flashx.textLayout.formats.TextLayoutFormat;

    public class ConfigurationExample extends Sprite
    {
        public function ConfigurationExample()
        {    
            //create container for the text and add to stage
            var textContainer:Sprite = new Sprite();
            textContainer.x = 50;
            textContainer.y = 20;
            this.stage.addChild( textContainer );
            
            // create Configuration, set properties for it and add to TextFlow
            var config:Configuration = new Configuration();
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
            textLayoutFormat.fontSize = 16;
            textLayoutFormat.kerning = Kerning.ON;
            textLayoutFormat.fontStyle = FontPosture.ITALIC;
            textLayoutFormat.textAlign = TextAlign.CENTER;
            config.textFlowInitialFormat = textLayoutFormat;
            var linkNormalFormat:TextLayoutFormat = new TextLayoutFormat();
            // make links red and underlined
            linkNormalFormat.color = 0xFF0000;
            linkNormalFormat.textDecoration = TextDecoration.UNDERLINE;
            config.defaultLinkNormalFormat = linkNormalFormat;
            // set selection color to light blue
              var selectionFormat:SelectionFormat = new SelectionFormat(0x333300);
              config.focusedSelectionFormat = selectionFormat;
            var textFlow:TextFlow = new TextFlow(config);
            // make text selectable
            var selectionManager:SelectionManager = new SelectionManager();
            textFlow.interactionManager = selectionManager;
            
            // create paragraph, a span of text, and a link
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            var linkSpan:SpanElement = new SpanElement();
            var link:LinkElement = new LinkElement();
            link.href = "http://www.adobe.com";
            linkSpan.text = "Adobe's website";
            link.addChild(linkSpan);
            span.text = "The best place to go for information about Adobe products is: ";
            
            // Add span and link to paragraph; add paragraph to TextFlow
            p.addChild(span);
            p.addChild(link);
            textFlow.addChild(p);
            
            // Add a controller for the container; specify container width and height
            textFlow.flowComposer.addController(new ContainerController(textContainer, 80, 300));
            textFlow.flowComposer.updateAllControllers(); 
        }
    }
}

Aspectos jurídicos | Política de privacidade on-line

Configuration - AS3

Pacotesx

Elementos de linguagem

Apêndices

Pacote flashx.textLayout.elements

defaultLinkActiveFormat

defaultLinkHoverFormat

defaultLinkNormalFormat

defaultListMarkerFormat

enableAccessibility

flowComposerClass

focusedSelectionFormat

inactiveSelectionFormat

inlineGraphicResolverFunction

manageEnterKey

manageTabKey

overflowPolicy

releaseLineCreationData

scrollDragDelay

scrollDragPixels

scrollMouseWheelMultiplier

scrollPagePercentage

textFlowInitialFormat

unfocusedSelectionFormat

Configuration

clone

hasTouchScreen