Paquete | flashx.textLayout.events |
Clase | public class SelectionEvent |
Herencia | SelectionEvent Event Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
Propiedad | Definido por | ||
---|---|---|---|
bubbles : Boolean [solo lectura]
Indica si un evento es un evento de propagación. | Event | ||
cancelable : Boolean [solo lectura]
Indica si se puede evitar el comportamiento asociado al evento. | Event | ||
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
currentTarget : Object [solo lectura]
Objeto que procesa de forma activa el objeto de evento con un detector de eventos. | Event | ||
eventPhase : 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 | ||
target : Object [solo lectura]
El destino del evento. | Event | ||
type : String [solo lectura]
El tipo de evento. | Event |
Método | Definido 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 | ||
Duplica una instancia de la subclase Event. | Event | ||
Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0. | Event | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Comprueba si se ha llamado a preventDefault() en el evento. | Event | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo. | Event | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento. | Event | ||
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual. | Event | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
Devuelve una cadena que contiene todas las propiedades del objeto de evento. | Event | ||
Devuelve el valor simple del objeto especificado. | Object |
Constante | Definido 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 |
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
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ámetrostype: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.
|
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.
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); } } }
Tue Jun 12 2018, 02:12 PM Z