Referencia de ActionScript® 3.0 para la plataforma de Adobe® Flash®
Inicio  |  Ocultar lista de paquetes y clases |  Paquetes  |  Clases  |  Novedades  |  Índice  |  Apéndices  |  ¿Por qué hay texto en inglés?
Filtros: Recuperando datos del servidor...
Recuperando datos del servidor...
flashx.textLayout.events 

SelectionEvent  - AS3

Paqueteflashx.textLayout.events
Clasepublic class SelectionEvent
HerenciaSelectionEvent Inheritance Event Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

Una instancia de TextFlow distribuye un objeto SelectionEvent cuando los parámetros EditManager o SelectionManager cambian o seleccionan un rango de texto. Por ejemplo, este evento no sólo se distribuye cuando se selecciona un rango de texto, sino también cuando cambia la selección, ya que el usuario hace clic en otra posición del flujo de texto. Además, este evento también se distribuye cuando un parámetro EditManager cambia el texto o el formato del texto en un rango de texto.

Ver los ejemplos



Propiedades públicas
 PropiedadDefinido por
 Inheritedbubbles : Boolean
[solo lectura] Indica si un evento es un evento de propagación.
Event
 Inheritedcancelable : Boolean
[solo lectura] Indica si se puede evitar el comportamiento asociado al evento.
Event
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 InheritedcurrentTarget : Object
[solo lectura] Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
Event
 InheritedeventPhase : uint
[solo lectura] La fase actual en el flujo del evento.
Event
  selectionState : SelectionState
Un objeto de tipo SelectionState que representa el rango seleccionado asociado a este evento SelectionEvent.
SelectionEvent
 Inheritedtarget : Object
[solo lectura] El destino del evento.
Event
 Inheritedtype : String
[solo lectura] El tipo de evento.
Event
Métodos públicos
 MétodoDefinido por
  
SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Crea un objeto de evento que contiene información sobre una operación de flujo.
SelectionEvent
 Inherited
Duplica una instancia de la subclase Event.
Event
 Inherited
formatToString(className:String, ... arguments):String
Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0.
Event
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Comprueba si se ha llamado a preventDefault() en el evento.
Event
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo.
Event
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento.
Event
 Inherited
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual.
Event
 Inherited
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.
Object
 Inherited
Devuelve una cadena que contiene todas las propiedades del objeto de evento.
Event
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Constantes públicas
 ConstanteDefinido por
  SELECTION_CHANGE : String = "selectionChange"
[estática] La constante SelectionEvent.SELECTION_CHANGE define el valor de la propiedad type de un objeto de evento de un evento selection.
SelectionEvent
Información sobre propiedades

selectionState

propiedad
selectionState:SelectionState

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

Un objeto de tipo SelectionState que representa el rango seleccionado asociado a este evento SelectionEvent.

Puede utilizar esta propiedad junto con la clase ElementRange para crear una instancia de ElementRange que represente el rango del texto seleccionado. Puede utilizar la siguiente línea de código para crear una instancia de la clase ElementRange que represente el rango del texto seleccionado (la variable ev representa el objeto de evento y el operador condicional se utiliza para protegerlo frente a un posible valor null de la propiedad selectionState):

         // Find selected element range
         var range:ElementRange = ev.selectionState ?  
             ElementRange.createElementRange(ev.selectionState.textFlow,
             ev.selectionState.absoluteStart, ev.selectionState.absoluteEnd) : null;



Implementación
    public function get selectionState():SelectionState
    public function set selectionState(value:SelectionState):void

Elementos de API relacionados

Información sobre constructores

SelectionEvent

()Información sobre
public function SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

Crea un objeto de evento que contiene información sobre una operación de flujo.

Parámetros
type:String — El tipo de evento. Los detectores de eventos pueden acceder a esta información a través de la propiedad type heredada. Sólo hay un tipo de evento SelectionEvent: SelectionEvent.SELECTION_CHANGE;
 
bubbles:Boolean (default = false) — Indica si un evento es de propagación. Este evento no es de propagación.
 
cancelable:Boolean (default = false) — Indica si se puede evitar el comportamiento asociado al evento.
 
selectionState:SelectionState (default = null) — Un objeto de tipo ElementRange que describe el rango del texto seleccionado.
Información sobre constantes

SELECTION_CHANGE

Constante
public static const SELECTION_CHANGE:String = "selectionChange"

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

La constante SelectionEvent.SELECTION_CHANGE define el valor de la propiedad type de un objeto de evento de un evento selection.

SelectionEvent_example.as

Este ejemplo muestra cómo detectar los cambios de selección de texto en un flujo de texto. Los dos pasos principales son llamar al método addEventListener() en el flujo de texto y crear una función de controlador de eventos.

La llamada a addEventListener() se realiza en la instancia de TextFlow. Puede utilizar la cadena simple "selectionChange", pero es más seguro utilizar la constante estática SelectionEvent.SELECTION_CHANGE.

La función de controlador de eventos de este ejemplo se denomina selectionHandler(). El método selectionHandler() utiliza la función trace() para generar sentencias de trazado que indican los puntos de inicio y final del rango de texto. Es posible acceder a esta información desde la propiedad selectedElementRange del objeto de evento.

package flashx.textLayout.events.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.edit.ElementRange;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.edit.SelectionManager;
    import flashx.textLayout.edit.SelectionState;
    import flashx.textLayout.events.SelectionEvent;

    public class SelectionEvent_example extends Sprite
    {
        private var tf:TextFlow;
        private var sm:SelectionManager;
        
        public function SelectionEvent_example()
        {
            //define TextFlow and manager objects
            tf = new TextFlow();
            sm = new SelectionManager();
            tf.interactionManager = sm;
            
            //define elements to contain text
            var p:ParagraphElement = new ParagraphElement();
            var s:SpanElement = new SpanElement();
            s.text ="This is sample text for the SelectionEvent example.";
                  
            //add the elements to the TextFlow
            p.addChild(s);  // add span as child of paragraph
            tf.addChild(p);  // add paragraph to text flow   
                    
            //compose TextFlow to display
            tf.flowComposer.addController(new ContainerController(this,600,400));
            tf.flowComposer.updateAllControllers();
            
            //add event handler to listen for SelectionEvent
            tf.addEventListener(SelectionEvent.SELECTION_CHANGE, selectionHandler);
    
        }
        private function selectionHandler(ev:SelectionEvent):void{
            trace("Selection event detected.");
            
            // Find selected element range
            var range:ElementRange = ev.selectionState ?  
                ElementRange.createElementRange(ev.selectionState.textFlow,
                ev.selectionState.absoluteStart, ev.selectionState.absoluteEnd) : null;

            trace("Starting index of selection range: " + range.absoluteStart);
            trace("Ending index of selection range: " + range.absoluteEnd);
        }
       
    }        
}




[ X ]¿Por qué hay texto en inglés?
Cierto contenido de la Referencia de ActionScript 3.0 se muestra en inglés

No todo el contenido de la Referencia de ActionScript 3.0 se traduce a todos los idiomas. Si un elemento del lenguaje no se traduce, aparecerá en inglés. Por ejemplo, la clase ga.controls.HelpBox no está traducida en ningún idioma. Por lo tanto, en la versión en español de la referencia, la clase ga.controls.HelpBox aparecerá en inglés.