TextFlow  - AS3

O objeto Configuration deste objeto TextFlow. O objeto Configuration especifica os formatos iniciais de caractere e parágrafo, o formato inicial do contêiner, e os atributos de destaque de seleção, links, foco e rolagem.

Se você não especificar um objeto Configuration, o Text Layout Framework utilizará um objeto Configuration padrão, ao qual a propriedade defaultConfiguration faz referência.

Elementos da API relacionados

Configuração padrão de todos os novos objetos TextFlow, caso a configuração não seja especificada.

Elementos da API relacionados

Gerencia os contêineres deste elemento.

As TextLines criadas a partir do elemento aparecem como filhos do contêiner. O flowComposer gerencia os contêineres e, à medida que o texto é editado, acrescenta e retira linhas nos/dos contêineres. O flowComposer também controla alguns atributos essenciais, tais como a largura e a altura de composição, se a rolagem está ativada, etc.

O contêiner e o flowComposer estão estreitamente relacionados. Se você reiniciar flowComposer, o contêiner voltará ao novo contêiner do flowComposer. Da mesma forma, se o contêiner for reiniciado, flowComposer voltará ao novo flowComposer do contêiner.

Elementos da API relacionados

Uma função de callback para conversão de estilos de elementos. Você pode usar isso na estilização, utilizando, por exemplo, estilos CSS ou nomeados.

Elementos da API relacionados

O número de geração deste objeto TextFlow. As operações de reversão e repetição utilizam o número de geração para verificar se é permitido desfazer ou refazer uma operação. Os números de geração devem coincidir.

Cada alteração de modelo incrementa generation. Portanto, se o número de geração mudar, você saberá que o modelo do TextFlow mudou.

O objeto TextLayoutFormat deste objeto TextFlow. Isso permite várias otimizações para reutilizar os formatos de host. Por exemplo;

        textFlowA.hostFormat = textFlowB.hostFormat
        

        format = new TextLayoutFormat()
        textFlow.hostFormat = format
        format.fontSize = 24;
        

Elementos da API relacionados

O InteractionManager associado a este objeto TextFlow.

Controla toda a seleção e edição no texto. Se não for possível selecionar o TextFlow, o interactionManager será null. Para possibilitar a edição de TextFlow, atribua um interactionManager que seja ao mesmo tempo um ISelectionManager e um IEditManager. Para fazer um TextFlow que seja exclusivo para leitura e permita seleção, atribua um interactionManager que seja apenas um ISelectionManager.

Elementos da API relacionados

Construtor - cria uma nova instância de TextFlow.

Se você fornecer um parâmetro config, o conteúdo do objeto Configuration será copiado e não será possível efetuar mudanças. Entretanto, você pode acessar os parâmetros de configuração através da propriedade configuration. Se o parâmetro config for null, você poderá acessar as os parâmetros padrão de configuração através da propriedade defaultConfiguration.

O objeto Configuration é um mecanismo para definir atributos padrão configuráveis em um TextFlow. Embora não seja possível efetuar mudanças no objeto Configuration, você pode ignorar os atributos padrão, se for necessário, definindo os atributos de TextFlow e dos filhos.

Elementos da API relacionados

Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. Você pode registrar ouvintes de eventos em todos os nós da lista de exibição de um tipo específico de evento, fase e prioridade.

Depois de registrar um ouvinte de evento com êxito, não será possível alterar a respectiva prioridade por meio de chamadas adicionais para o addEventListener(). Para alterar a prioridade de um ouvinte, chame primeiramente o removeEventListener(). Em seguida, você poderá registrar o ouvinte novamente com o novo nível de prioridade.

Depois que o ouvinte for registrado, chamadas subsequentes para o addEventListener() com um valor diferente para type ou useCapture resultarão na criação de um registro de ouvinte separado. Por exemplo, se você primeiro registrar um ouvinte com o useCapture definido como true, ele escutará apenas durante a fase de captura. Se você chamar o addEventListener() novamente, usando o mesmo objeto de ouvinte, mas com o useCapture definido como false, você terá dois ouvintes distintos: um que escuta durante a fase de captura e outro que escuta durante as fases de destino e de bubbling.

Você não pode registrar um ouvinte de evento apenas para a fase de destino ou a fase de bubbling. Essas fases são emparelhadas durante o registro porque o bubbling se aplica apenas aos ancestral do nó-alvo.

Quando você não precisar ais de um ouvinte de evento, remova-o, chamando o EventDispatcher.removeEventListener(); do contrário, poderão ocorrer problemas de memória. Objetos com ouvintes de eventos registrados não são removidos automaticamente da memória porque o coletor de lixo não remove objetos que ainda têm referências.

Copiar uma ocorrência do EventDispatcher não copia os ouvintes de eventos a ele anexados. (Se o seu recém-criado nó precisar de um ouvinte de evento, anexe o ouvinte após criar o nó). Entretanto, se você mover uma ocorrência do EventDispatcher, os ouvintes de evento anexados se movimentarão com ele.

Se o ouvinte de evento estiver sendo registrado em um nó enquanto um evento também estiver sendo processado nesse nó, o ouvinte de evento não será disparado durante a fase atual, mas poderá ser disparado durante uma fase posterior no fluxo de eventos, como a fase de bubbling.

Se um ouvinte de evento for removido de um nó enquanto um evento estiver sendo processado no nó, ele ainda será disparado pelas ações atuais. Depois de removido, o ouvinte de evento nunca mais é chamado novamente (a menos que ele seja registrado mais uma vez para processamento futuro).

Parâmetros

Envia um evento para o fluxo de eventos. O destino de evento é o objeto EventDispatcher no qual o método dispatchEvent() é chamado.

Parâmetros

Gera um elemento cuja propriedade ID corresponde ao parâmetro idName. Permite aplicar um estilo de acordo com a id.

Por exemplo, a linha a seguir define o estilo "color" como 0xFF0000 (vermelho) para o elemento cuja id é span1.

         textFlow.getElementByID("span1").setStyle("color", 0xFF0000);
         

Nota: no código a seguir, p.addChild(s) retira s do seu pai original e o inclui em p, o novo pai.

         var s:SpanElement = new SpanElement();
         var p:ParagraphElement = new ParagraphElement();
         ...
         s = textFlow.getElementByID("span3") as SpanElement;
         p.addChild(s);
         textFlow.addChild(p);
         

Parâmetros

Elementos da API relacionados

package flashx.textLayout.elements.examples {
    import flash.display.Sprite;
    
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class TextFlow_getElementByIDExample extends Sprite
    {
        public function TextFlow_getElementByIDExample()
        {    
            // create the TextFlow object
            var textFlow:TextFlow = new TextFlow();
            
            // xml markup that defines the attributes and contents of a text flow
            var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
            "<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
                "<flow:p>"+
                    "<flow:span id='span1'>In the first paragraph of the </flow:span>"+
                    "<flow:span id='span2' fontStyle=\"italic\">cheap </flow:span>"+
                    "<flow:span id='span3'>Western novel, a cowboy meets a saloon girl.</flow:span>"+
                "</flow:p>"+
            "</flow:TextFlow>";
            var s:SpanElement = new SpanElement();
            var s2:SpanElement = new SpanElement();
            var p:ParagraphElement = new ParagraphElement();
            // import the xml markup into a TextFlow object and display it on the stage
            textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
            // get element with ID of span3, make a copy of it
            textFlow.getElementByID("span3").setStyle("color", 0xFF0000); 
            textFlow.flowComposer.addController(new ContainerController(this, 200, 800));
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

            
            

Gera todos os elementos cujo styleName foi definido como styleNameValue.

Parâmetros

Elementos da API relacionados

Gera todos os elementos cujo typeName foi definido como typeNameValue.

Parâmetros

Elementos da API relacionados

Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. Isto permite determinar quando um objeto EventDispatcher alterou o tratamento de um tipo de evento na hierarquia de fluxo de eventos. Para determinar se um tipo de evento específico efetivamente dispara um ouvinte de evento, utilize o IEventDispatcher.willTrigger().

A diferença entre o hasEventListener() e o willTrigger() é que o hasEventListener() examina só o objeto a que ele pertence, ao passo que o willTrigger() examina o fluxo de eventos inteiro para o evento especificado pelo parâmetro type.

Parâmetros

Invalida todas as informações de formatação do TextFlow, obrigando seu recálculo. Chame este método quando os estilos forem alterados.

Elementos da API relacionados

Remove um ouvinte do objeto EventDispatcher. Se não existir um ouvinte correspondente registrado com o objeto EventDispatcher, uma chamada para esse método não terá efeito.

Parâmetros

Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. Este método retorna true se um ouvinte de evento for disparado durante qualquer fase do fluxo de eventos quando um evento do tipo especificado for despachado para esse objeto EventDispatcher ou para algum de seus descendentes.

A diferença entre o hasEventListener() e o willTrigger() é que o hasEventListener() examina só o objeto a que ele pertence, ao passo que o willTrigger() examina o fluxo de eventos inteiro para o evento especificado pelo parâmetro type.

Parâmetros

Despachado ao se clicar em qualquer link.

Despachado depois de todas as recomposições.

Despachado por um objeto TextFlow sempre que ele estiver danificado. Você pode usar este evento para descobrir se o TextFlow mudou, mas não acessa o TextFlow por si mesmo quando este evento é despachado. Este evento é despachado quando as alterações em TextFlow estiverem parcialmente concluídas. Portanto, seu estado pode não apresentar uniformidade: algumas alterações já foram efetuadas e outras ainda estão pendentes. Obtenha do evento a informação de que você precisa e faça as alterações necessárias depois que o controle voltar ao seu aplicativo.

A alteração de uma operação neste momento (após sua execução) poderá falhar.

Despachado quando um InlineGraphicElement for redimensionado por ter a largura ou a altura definida como automática ou porcentagem e quando o gráfico terminar de ser carregado.

Despachado quando o mouse é pressionado em qualquer link.

Despachado quando o mouse passa sobre qualquer link.

Despachado quando o mouse sai de qualquer link.

Despachado quando o mouse sai de qualquer link.

Despachado quando o mouse acaba de entrar em qualquer link.

Despachado por um objeto TextFlow depois que um texto é rolado dentro de um contêiner controlador.

Despachado sempre que a seleção for alterada. Usado principalmente para atualizar a interface de usuário dependente da seleção. Também pode ser usado para alterar a seleção, mas não pode ser usado para alterar o próprio TextFlow.

Despachado por um objeto TextFlow sempre que novos DisplayObjects forem adicionados ou atualizados em um contêiner como resultado da composição.