SelectionManager  - AS3

La posición del texto al final de la selección, como desplazamiento desde el inicio del flujo de texto.

El final absoluto es el mismo, sea un punto activo o un punto de ancla de la selección (será el último que aparezca en el flujo de texto).

La posición del texto al inicio de la selección, como desplazamiento desde el inicio del flujo de texto.

El inicio absoluto es el mismo, sea un punto activo o un punto de ancla de la selección (será el primero que aparezca en el flujo de texto).

El punto activo de la selección.

El punto activo es el final volátil de la selección. El punto activo cambia cuando se modifica la selección. El punto activo puede estar en el inicio o en el final de la selección.

El punto de ancla de la selección.

Un punto de ancla es el final estable de la selección. Si se amplía la selección, el punto de ancla permanece fijo. El punto de ancla puede estar en el inicio o en el final de la selección.

El objeto SelectionFormat actual.

El objeto SelectionFormat actual se elige entre los objetos SelectionFormat asignados a las propiedades unfocusedSelectionFormat, inactiveSelectionFormat y focusedSelectionFormat basándose en el estado actual de las propiedades windowActive y focused.

Elementos de API relacionados

El modo de edición.

El modo de edición indica si el flujo de texto admite selección, edición o sólo lectura. Un flujo de texto puede seleccionarse asignando un administrador de selección; puede editarse asignando un administrador de edición. Las constantes que representan los modos de edición se definen en la clase EditingMode.

Elementos de API relacionados

Indica si un contenedor del flujo de texto tiene la selección.

La propiedad focused es true si cualquiera de los contenedores del flujo de texto está seleccionado.

El objeto SelectionFormat utilizado para dibujar la selección en un contenedor seleccionado.

Elementos de API relacionados

El objeto SelectionFormat utilizado para dibujar la selección si no está en la ventana activa.

Elementos de API relacionados

El formato que se aplicará al texto insertado. TBD: pointFormat debe ampliarse recordar estilos de usuario y "undefine" de formatos de llamadas a IEditManager.undefineFormat leafFormat con valores de una selección de punto.

El objeto TextFlow administrado por este administrador de selección.

Un administrador de selección administra únicamente un flujo de texto. Se puede asignar también un administrador de selección a un flujo de texto estableciendo la propiedad interactionManager del objeto TextFlow.

Elementos de API relacionados

El objeto SelectionFormat utilizado para dibujar la selección si no está seleccionado un contenedor, pero se encuentra en la ventana activa.

Elementos de API relacionados

Indica si la ventana asociada al flujo de texto está activa o no.

La propiedad windowActive es true si la ventana en la que se visualiza el flujo de texto es la ventana activa.

Crea un objeto SelectionManager.

Asigna un objeto SelectionManager a la propiedad interactionManager de un flujo de texto para permitir la selección de texto.

Procesa un evento activate.

Parámetros

Procesa un evento deactivate.

Parámetros

Lleva a cabo una operación SelectionManager: nunca podrán modificar el flujo pero los clientes siguen pudiendo cancelarlos.

Parámetros

Procesa un evento edit.

Los eventos edit se distribuyen para comandos cut, copy, paste y selectAll.

Parámetros

Procesa un evento focusChange.

Parámetros

Procesa un evento focusIn.

Parámetros

Procesa un evento focusOut.

Parámetros

Obtiene los atributos de formato de caracteres comunes a todos los caracteres del rango de texto especificado o de la selección actual.

Los atributos de formato que no tengan el mismo valor para todos los caracteres del rango de elementos seleccionado o de la selección se establecen como null en la instancia de TextLayoutFormat devuelta.

Parámetros

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

Obtiene los atributos de formato de contenedor comunes a todos los contenedores del rango de texto seleccionado o de la selección actual.

Los atributos de formato que no tengan el mismo valor para todos los caracteres del rango de texto seleccionado y de la selección se establecen como null en la instancia de TextLayoutFormat devuelta.

Parámetros

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

Obtiene los atributos de formato de párrafo comunes a todos los párrafos del rango de texto seleccionado o la selección actual.

Los atributos de formato que no tengan el mismo valor para todos los párrafos del rango de elementos especificado o de la selección se establecen como null en la instancia de TextLayoutFormat devuelta.

Parámetros

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

Obtiene el objeto SelectionState de la selección actual.

Elementos de API relacionados

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

Indica si hay una selección.

Devuelve true si hay una selección de rango o de puntos. De forma predeterminada, si se configura primero un administrador de selección, no hay ninguna selección activada (el inicio y el final es -1).

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

Procesa un evento imeStartComposition

Parámetros

Indica si la selección abarca un rango de texto.

Devuelve true si hay una selección que va más allá de una única posición.

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

Procesa un evento keyDown.

Parámetros

Procesa un evento keyFocusChange.

Parámetros

Procesa un evento keyUp.

Parámetros

Procesa un evento menuSelect.

Parámetros

Procesa un evento mouseDoubleClick.

Parámetros

Procesa un evento mouseDown.

Parámetros

Procesa un evento mouseMove.

Parámetros

Procesa un evento mouseOut.

Parámetros

Procesa un evento mouseOver.

Parámetros

Procesa un evento mouseUp.

Parámetros

Procesa un evento mouseWheel.

Parámetros

Actualiza el administrador de selección cuando se inserta o se elimina texto.

Las operaciones deben llamar a notifyInsertOrDelete cuando cambia el texto del flujo de texto. El administrador de selección ajusta los indicadores de posición basados en los índices como corresponda. Si crea una nueva clase Operation que cambie el texto de un flujo de texto directamente (no mediante otra operación), la operación debe llamar a esta función para mantener la selección actualizada.

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 );
}

Vuelve a mostrar las formas de selección.

Nota: no es necesario llamar a este método directamente. Se le llama automáticamente.

Elementos de API relacionados

Parámetros

Elementos de API relacionados

Da la selección al primer contenedor de la selección.

 textFlow.interactionManager.setFocus();

Define el cursor del ratón.

Parámetros

Establece el objeto SelectionState de la selección actual.

Parámetros

Elementos de API relacionados

Procesa un evento softKeyboardActivating.

Parámetros

Procesa un evento TextEvent.

Parámetros

Este ejemplo muestra el uso de la clase SelectionManager.

Establece un objeto TextFlow y un detector para los cambios de la selección; seguidamente se actualiza basándose en los cambios de la selección.

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
        }
        
    }        
}