Paquete | flashx.textLayout.events |
Clase | public class FlowElementMouseEvent |
Herencia | FlowElementMouseEvent Event Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
Puede añadir un detector de eventos a un objeto LinkElement para detectar este tipo de eventos. Si decide cancelar el evento llamando a Event.preventDefault()
, no se activará el comportamiento predeterminado asociado al evento.
Si decide no añadir ningún controlador de eventos en el objeto LinkElement, o si su función de detector de eventos no cancela el comportamiento, el evento se vuelve a distribuir, pero esta vez mediante la instancia de TextFlow asociada a LinkElement en vez de con el propio objeto LinkElement. Proporciona una segunda oportunidad para detectar este evento con un detector de eventos asociado al objeto TextFlow.
Los eventos FlowElementMouseEvent se distribuyen únicamente si el texto no se puede editar o si se pulsa la tecla Control durante la actividad del ratón.
Los siguientes seis tipos de eventos se distribuyen sólo si no se puede editar el texto o si se pulsa la tecla Control:
-
FlowElementMouseEvent.CLICK
-
FlowElementMouseEvent.MOUSE_DOWN
-
FlowElementMouseEvent.MOUSE_UP
-
FlowElementMouseEvent.MOUSE_MOVE
-
FlowElementMouseEvent.ROLL_OVER
-
FlowElementMouseEvent.ROLL_OUT
Elementos de API relacionados
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 | ||
flowElement : FlowElement
Objeto FlowElement que distribuyó el evento. | FlowElementMouseEvent | ||
originalEvent : MouseEvent
El evento de ratón original generado por la actividad del ratón. | FlowElementMouseEvent | ||
target : Object [solo lectura]
El destino del evento. | Event | ||
type : String [solo lectura]
El tipo de evento. | Event |
Método | Definido por | ||
---|---|---|---|
FlowElementMouseEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, flowElement:FlowElement = null, originalEvent:MouseEvent = null)
Crea un objeto de evento que contiene información sobre actividad del ratón. | FlowElementMouseEvent | ||
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 | ||
---|---|---|---|
CLICK : String = "click" [estática]
Define el valor de la propiedad type para un objeto de evento click. | FlowElementMouseEvent | ||
MOUSE_DOWN : String = "mouseDown" [estática]
Define el valor de la propiedad type para un objeto de evento mouseDown. | FlowElementMouseEvent | ||
MOUSE_MOVE : String = "mouseMove" [estática]
Define el valor de la propiedad type para un objeto de evento mouseMove. | FlowElementMouseEvent | ||
MOUSE_UP : String = "mouseUp" [estática]
Define el valor de la propiedad type para un objeto de evento mouseUp. | FlowElementMouseEvent | ||
ROLL_OUT : String = "rollOut" [estática]
Define el valor de la propiedad type para un objeto de evento rollOut. | FlowElementMouseEvent | ||
ROLL_OVER : String = "rollOver" [estática]
Define el valor de la propiedad type para un objeto de evento rollOver. | FlowElementMouseEvent |
flowElement | propiedad |
flowElement:FlowElement
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
Objeto FlowElement que distribuyó el evento.
Implementación
public function get flowElement():FlowElement
public function set flowElement(value:FlowElement):void
Elementos de API relacionados
originalEvent | propiedad |
originalEvent:MouseEvent
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
El evento de ratón original generado por la actividad del ratón. Esta propiedad puede contener uno de los siguientes valores:
MouseEvent.CLICK
MouseEvent.MOUSE_DOWN
MouseEvent.MOUSE_UP
MouseEvent.MOUSE_MOVE
MouseEvent.MOUSE_OVER
MouseEvent.MOUSE_OUT
En la mayoría de los casos, el evento original coincide con el evento distribuido por LinkElement. Los eventos coinciden con los eventos click
, mouseDown
, mouseOut
y mouseOver
. Sin embargo, hay dos casos en los que el evento original se convierte mediante el elemento LinkElement en un evento relacionado. Si un objeto LinkElement detecta un evento mouseOver
, distribuye un evento rollOver
. Del mismo modo, si un objeto LinkElement detecta un evento mouseOut
, distribuye un evento rollOut
. Normalmente, el destino del evento y las coordenadas del ratón están relacionados con la instancia de TextLine que contiene el elemento del vínculo.
Implementación
public function get originalEvent():MouseEvent
public function set originalEvent(value:MouseEvent):void
Elementos de API relacionados
FlowElementMouseEvent | () | Información sobre |
public function FlowElementMouseEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, flowElement:FlowElement = null, originalEvent:MouseEvent = 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 actividad del ratón. Los objetos de evento se transfieren como parámetros a los detectores de eventos. Utilice el constructor si pretende distribuir un evento manualmente. No necesita utiliza el constructor para detectar objetos FlowElementMouseEvent generados por un elemento FlowElement.
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. Hay seis tipos: FlowElementMouseEvent.CLICK ; FlowElementMouseEvent.MOUSE_DOWN ; FlowElementMouseEvent.MOUSE_MOVE ; FlowElementMouseEvent.MOUSE_UP ; FlowElementMouseEvent.ROLL_OVER y FlowElementMouseEvent.ROLL_OUT .
| |
bubbles:Boolean (default = false ) — Determina si el objeto de evento participa en la fase de propagación del flujo del evento. Los objetos FlowElementMouseEvent no se propagan.
| |
cancelable:Boolean (default = true ) — Determina si se puede cancelar el objeto Event. Los detectores de eventos pueden acceder a esta información a través de la propiedad cancelable heredada. Los objetos FlowElementMouseEvent se pueden cancelar. Es posible cancelar el comportamiento predeterminado asociado a este evento llamando al método preventDefault() en el detector de eventos.
| |
flowElement:FlowElement (default = null ) — La instancia de FlowElement, actualmente es un elemento LinkElement, asociada a este evento. Los detectores de eventos pueden acceder a esta información a través de la propiedad flowElement .
| |
originalEvent:MouseEvent (default = null ) — El evento de ratón original que ocurrió en el elemento flowElement. Los detectores de eventos pueden acceder a esta información a través de la propiedad originalEvent .
|
CLICK | Constante |
public static const CLICK:String = "click"
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
Define el valor de la propiedad type
de un objeto de evento click
.
Elementos de API relacionados
MOUSE_DOWN | Constante |
public static const MOUSE_DOWN:String = "mouseDown"
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
Define el valor de la propiedad type
de un objeto de evento mouseDown
.
Elementos de API relacionados
MOUSE_MOVE | Constante |
public static const MOUSE_MOVE:String = "mouseMove"
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
Define el valor de la propiedad type
de un objeto de evento mouseMove
.
Elementos de API relacionados
MOUSE_UP | Constante |
public static const MOUSE_UP:String = "mouseUp"
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
Define el valor de la propiedad type
de un objeto de evento mouseUp
.
Elementos de API relacionados
ROLL_OUT | Constante |
public static const ROLL_OUT:String = "rollOut"
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
Define el valor de la propiedad type
de un objeto de evento rollOut
.
Elementos de API relacionados
ROLL_OVER | Constante |
public static const ROLL_OVER:String = "rollOver"
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
Define el valor de la propiedad type
de un objeto de evento rollOver
.
Elementos de API relacionados
Este ejemplo muestra cómo detectar eventos de ratón que se pueden producir en instancias de LinkElement. Los dos pasos principales son llamar a addEventListener() para cada tipo de evento y crear una función de detector de eventos.
La llamada a addEventListener()
se realiza en la instancia de LinkElement. Puede utilizar cadenas simples, como "click"
o "mouseDown"
, pero es más seguro utilizar constantes estáticas. El ejemplo utiliza las constantes de la clase MouseEvent porque no hay constantes estáticas en la clase FlowElementMouseEvent.
Este ejemplo contiene solamente una función de controlador de eventos porque el código es el mismo para todos los eventos. Normalmente, el código que responde a cada tipo de evento es distinto. En ese caso, una función de controlador de eventos independiente para cada llamada a addEventListener()
podría ser una opción mejor.
package flashx.textLayout.events.examples { import flash.display.Sprite; import flash.events.MouseEvent; import flashx.textLayout.container.ContainerController; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.LinkElement; import flashx.textLayout.events.FlowElementMouseEvent; import flashx.textLayout.formats.TextLayoutFormat; public class FlowElementMouseEvent_example extends Sprite { private var tf:TextFlow; public function FlowElementMouseEvent_example() { // define TextFlow tf = new TextFlow(); // define link element var linkPar:ParagraphElement = new ParagraphElement(); var linkEl:LinkElement = new LinkElement(); linkEl.href = "http://www.adobe.com/go/flashplayer"; linkEl.target = "_blank"; // when link is clicked, open a new browser window var span1:SpanElement = new SpanElement(); // for text associated with link span1.text = "Get Flash Player"; linkEl.addChild(span1); // define paragraph element for name of events dispatched var textPar:ParagraphElement = new ParagraphElement(); var span2:SpanElement = new SpanElement(); span2.text ="Three most recent events:"; // add span (text) and link elements to the TextFlow linkPar.addChild(linkEl); // add LinkElement to first paragraph textPar.addChild(span2); // add header text to second paragraph tf.addChild(linkPar); // add paragraph with link to text flow tf.addChild(textPar); // add paragraph for events to text flow // add event listeners for all six FlowElementMouseEvent types linkEl.addEventListener(FlowElementMouseEvent.CLICK, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.MOUSE_DOWN, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.MOUSE_MOVE, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.MOUSE_UP, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.ROLL_OVER, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.ROLL_OUT, linkHandler); // create text container for link and event listing text var linkContainer:Sprite = new Sprite(); linkContainer.x = 10; linkContainer.y = 10; var linkController:ContainerController = new ContainerController(linkContainer,200,80); var linkControllerFormat:TextLayoutFormat = new TextLayoutFormat(); linkControllerFormat.paddingTop = 3; linkController.format = linkControllerFormat; tf.flowComposer.addController(linkController); // Add linkContainer to Display List addChild(linkContainer); tf.flowComposer.updateAllControllers(); } // event handler function private function linkHandler(ev:FlowElementMouseEvent):void { var par:ParagraphElement = new ParagraphElement(); var span:SpanElement = new SpanElement(); span.text = ev.type; par.addChild(span); tf.replaceChildren(2,2,par); if (tf.numChildren > 5) { tf.removeChildAt(5); } tf.flowComposer.updateAllControllers(); } } }
Tue Jun 12 2018, 02:12 PM Z