SelectionManager  - AS3

A posição de texto do final da seleção, como deslocamento a partir do início do fluxo de texto.

O final absoluto é igual ao ponto ativo ou de ancoragem da seleção, o que vier por último no fluxo de texto.

A posição de texto do início da seleção, como deslocamento a partir do início do fluxo de texto.

O início absoluto é igual ao ponto ativo ou de ancoragem da seleção, o que vier primeiro no fluxo de texto.

O ponto ativo da seleção.

O ponto ativo é o final volátil da seleção. O ponto ativo muda quando a seleção é modificada. O ponto ativo pode estar ou no início ou no fim da seleção.

O ponto de ancoragem da seleção.

Um ponto de ancoragem é o final estável da seleção. Quando uma seleção é estendida, o ponto de ancoragem não muda. O ponto de ancoragem pode estar ou no início ou no fim da seleção.

O objeto SelectionFormat atual.

O objeto SelectionFormat atual é escolhido entre os objetos SelectionFormat atribuídos às propriedades unfocusedSelectionFormat, inactiveSelectionFormat e focusedSelectionFormat de acordo com o estado atual das propriedades windowActive e focused.

Elementos da API relacionados

O modo de edição.

O modo de edição indica se o fluxo de texto permite seleção, edição ou apenas leitura. Um fluxo de texto passa a ser selecionável por meio da atribuição de um gerenciador de seleções, e editável com a atribuição de um gerenciador de edições. As constantes que representam os modos de edição são definidas na classe EditingMode.

Elementos da API relacionados

Indica se o foco estará em um contêiner no fluxo de texto.

A propriedade focused é verdadeira se algum dos contêineres do fluxo de texto tiver o foco principal.

O objeto SelectionFormat usado para desenhar a seleção em um contêiner com foco.

Elementos da API relacionados

O objeto SelectionFormat usado para desenhar a seleção quando ela não estiver na janela ativa.

Elementos da API relacionados

O formato que será aplicado ao texto inserido. TBD: o pointFormat tem de ser extenso para lembrar os estilos de usuário e "não definições" de formatos de chamadas para IEditManager.undefineFormat com valores de leafFormat em uma seleção de ponto.

O objeto TextFlow gerenciado por este gerenciador de seleções.

Um gerenciador de seleções gerencia um único fluxo de texto. Um gerenciador de seleções também pode ser atribuído a um fluxo de texto por meio da definição da propriedade interactionManager do objeto TextFlow.

Elementos da API relacionados

O objeto SelectionFormat usado para desenhar a seleção quando ela não estiver em um contêiner com foco e sim na janela ativa.

Elementos da API relacionados

Indica se a janela associada ao fluxo de texto está ativa.

A propriedade windowActive é verdadeira se a janela exibida com o fluxo de texto for a janela ativa.

Cria um objeto SelectionManager.

Atribua um objeto SelectionManager à propriedade interactionManager de um fluxo de texto para ativar a seleção de texto.

Processa um evento de ativação.

Parâmetros

Processa um evento de desativação.

Parâmetros

Execute uma operação SelectionManager - estes nunca podem modificar o fluxo, mas os clientes ainda são capazes de cancelá-los.

Parâmetros

Processa um evento de edição.

Os eventos de edição são despachados para os comandos cortar, copiar, colar e selecionar tudo.

Parâmetros

Processa um evento focusChange.

Parâmetros

Processa um evento focusIn.

Parâmetros

Processa um evento focusOut.

Parâmetros

Obtém os atributos de formato de caractere comuns a todos os caracteres do intervalo de texto especificado ou da seleção atual.

Os atributos de formato que não tiverem o mesmo valor para todos os caracteres do intervalo de elemento especificado ou da seleção terão o valor null na instância TextLayoutFormat retornada.

Parâmetros

 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonCharacterFormat();

Obtém os atributos de formato de contêiner comuns a todos os contêineres no intervalo de texto especificado ou da seleção atual.

Os atributos de formato que não tiverem o mesmo valor para todos os contêineres do intervalo de elemento especificado ou da seleção terão o valor null na instância TextLayoutFormat retornada.

Parâmetros

 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonContainerFormat();

Obtém os atributos de formato de parágrafo comuns a todos os parágrafos no intervalo de texto especificado ou na seleção atual.

Os atributos de formato que não tiverem o mesmo valor para todos os parágrafos no intervalo de elemento especificado ou na seleção terão o valor null na instância TextLayoutFormat retornada.

Parâmetros

 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonParagraphFormat();

Lê o objeto SelectionState da seleção atual.

Elementos da API relacionados

 var selection:SelectionState = textFlow.interactionManager.getSelectionState();

Indica se há uma seleção.

Gera true se houver uma seleção de intervalo ou uma seleção pontual. Por padrão, quando um gerenciador de seleções é criado, não há nenhuma seleção (o início e o final são -1).

 var selection:SelectionState = textFlow.interactionManager.hasSelection();

Processa um evento imeStartComposition

Parâmetros

Indica se a seleção cobre um intervalo de texto.

Gera true se houver uma seleção que se estende após uma única posição.

 var selection:SelectionState = textFlow.interactionManager.isRangeSelection();

Processa um evento keyDown.

Parâmetros

Processa um evento keyFocusChange.

Parâmetros

Processa um evento keyUp.

Parâmetros

Processa um evento menuSelect.

Parâmetros

Processa um evento mouseDoubleClick.

Parâmetros

Processa um evento mouseDown.

Parâmetros

Processa um evento mouseMove.

Parâmetros

Processa um evento mouseOut.

Parâmetros

Processa um evento mouseOver.

Parâmetros

Processa um evento mouseUp.

Parâmetros

Processa um evento mouseWheel.

Parâmetros

Atualiza o gerenciador de seleções quando um texto é inserido ou excluído.

As operações devem chamar notifyInsertOrDelete ao alterar o texto no fluxo de texto. O gerenciador de seleções ajusta proporcionalmente os indicadores de posição indexados. Se você criar uma nova classe Operação que altere diretamente o texto em um fluxo de texto (sem usar outra operação), a sua operação deverá chamar esta função para manter a seleção atualizada.

Parâmetros

 import flashx.textLayout.elements.SpanElement;
 

function doReplace( span:SpanElement, newText:String, relativeStart:int, relativeEnd:int ):void
{
    span.replaceText(  relativeStart, relativeEnd, newText );
    var parentFlow:TextFlow = span.getTextFlow();
    var lengthDifference:int = newText.length - (relativeEnd - relativeStart);

    parentFlow.interactionManager.notifyInsertOrDelete(    span.getAbsoluteStart() + relativeStart, lengthDifference );
}

Reexibe as formas da seleção.

Nota: não é necessário chamar esse método diretamente. Ele é chamado automaticamente.

Elementos da API relacionados

Parâmetros

Elementos da API relacionados

Põe o foco no primeiro contêiner da seleção.

 textFlow.interactionManager.setFocus();

Defina o cursor do mouse.

Parâmetros

Define o objeto SelectionState da seleção atual.

Parâmetros

Elementos da API relacionados

Processa um evento softKeyboardActivating

Parâmetros

Processa um TextEvent.

Parâmetros

Este exemplo mostra o uso da classe SelectionManager:

Ele configura um TextFlow e um ouvinte para as modificações da seleção, e em seguida atualiza com base nas modificações da seleção.

package flashx.textLayout.edit.examples {
    import flash.display.Sprite;
    
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.edit.SelectionManager;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.ITextLayoutFormat;
    import flashx.textLayout.events.SelectionEvent;

    public class SelectionManager_example extends Sprite
    {
        private var textFlow:TextFlow;
        
        public function SelectionManager_example()
        {
            //define TextFlow, and make it read-select
            textFlow = TextConverter.importToFlow("This is sample text for the SelectionManager example.",
                TextConverter.PLAIN_TEXT_FORMAT);
            textFlow.interactionManager = new SelectionManager();
            
            //compose TextFlow to display
            textFlow.flowComposer.addController(new ContainerController(this,600,600));
            textFlow.flowComposer.updateAllControllers();
            
            //add event handlers to the TextFlow to detect when selection changes
            textFlow.addEventListener(SelectionEvent.SELECTION_CHANGE, selectionChanged);
        }

        private function selectionChanged(selectionEvent:SelectionEvent):void
        {
            var format:ITextLayoutFormat = textFlow.interactionManager.getCommonCharacterFormat();
            // do something here - perhaps update the application's UI based on the formatting
            // attributes applied in the current selected text range
        }
        
    }        
}