Pacchetto | flashx.textLayout.events |
Classe | public class FlowElementMouseEvent |
Ereditarietà | FlowElementMouseEvent Event Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Per rilevare questo tipo di evento, potete aggiungere un listener di eventi a un elemento link. Se scegliete di annullare l'evento chiamando Event.preventDefault()
, verrà annullato anche il comportamento predefinito associato a questo evento.
Se scegliete di non aggiungere un listener di eventi all'elemento link, o se la funzione del listener di eventi utilizzato non annulla il comportamento, l'evento viene inviato di nuovo, ma questa volta dall'istanza TextFlow associata all'elemento link anziché dallo stesso elemento link. In questo modo viene fornita una seconda opportunità per rilevare questo evento con un listener di eventi associato a TextFlow.
Gli eventi FlowElementMouseEvents vengono inviati solo quando non è possibile modificare il testo o quando si preme il tasto Ctrl contemporaneamente all'attività del mouse.
I sei tipi di eventi seguenti vengono inviati solo quando non è possibile modificare il testo o quando si preme il tasto Ctrl:
-
FlowElementMouseEvent.CLICK
-
FlowElementMouseEvent.MOUSE_DOWN
-
FlowElementMouseEvent.MOUSE_UP
-
FlowElementMouseEvent.MOUSE_MOVE
-
FlowElementMouseEvent.ROLL_OVER
-
FlowElementMouseEvent.ROLL_OUT
Elementi API correlati
Proprietà | Definito da | ||
---|---|---|---|
bubbles : Boolean [sola lettura]
Indica se un evento è un evento di bubbling. | Event | ||
cancelable : Boolean [sola lettura]
Indica se il comportamento associato all'evento può essere impedito. | Event | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
currentTarget : Object [sola lettura]
L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. | Event | ||
eventPhase : uint [sola lettura]
La fase attuale del flusso di eventi. | Event | ||
flowElement : FlowElement
Il FlowElement che ha inviato l'evento. | FlowElementMouseEvent | ||
originalEvent : MouseEvent
L'evento mouse originale generato dall'attività del mouse. | FlowElementMouseEvent | ||
target : Object [sola lettura]
Il target dell'evento. | Event | ||
type : String [sola lettura]
Il tipo di evento. | Event |
Metodo | Definito da | ||
---|---|---|---|
FlowElementMouseEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, flowElement:FlowElement = null, originalEvent:MouseEvent = null)
Crea un oggetto evento contenente informazioni relative all'attività del mouse. | FlowElementMouseEvent | ||
Duplica un'istanza di una sottoclasse Event. | Event | ||
Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate. | Event | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Verifica se sull'evento è stato chiamato il metodo preventDefault(). | Event | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato. | Event | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi. | Event | ||
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente. | Event | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce una stringa che contiene tutte le proprietà dell'oggetto Event. | Event | ||
Restituisce il valore di base dell'oggetto specificato. | Object |
Costante | Definito da | ||
---|---|---|---|
CLICK : String = "click" [statico]
Definisce il valore della proprietà type di un oggetto evento click. | FlowElementMouseEvent | ||
MOUSE_DOWN : String = "mouseDown" [statico]
Definisce il valore della proprietà type di un oggetto evento mouseDown. | FlowElementMouseEvent | ||
MOUSE_MOVE : String = "mouseMove" [statico]
Definisce il valore della proprietà type di un oggetto evento mouseMove. | FlowElementMouseEvent | ||
MOUSE_UP : String = "mouseUp" [statico]
Definisce il valore della proprietà type di un oggetto evento mouseUp. | FlowElementMouseEvent | ||
ROLL_OUT : String = "rollOut" [statico]
Definisce il valore della proprietà type di un oggetto evento rollOut. | FlowElementMouseEvent | ||
ROLL_OVER : String = "rollOver" [statico]
Definisce il valore della proprietà type di un oggetto evento rollOver. | FlowElementMouseEvent |
flowElement | proprietà |
flowElement:FlowElement
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Il FlowElement che ha inviato l'evento.
Implementazione
public function get flowElement():FlowElement
public function set flowElement(value:FlowElement):void
Elementi API correlati
originalEvent | proprietà |
originalEvent:MouseEvent
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
L'evento mouse originale generato dall'attività del mouse. Questa proprietà può contenere uno qualsiasi dei seguenti valori:
MouseEvent.CLICK
MouseEvent.MOUSE_DOWN
MouseEvent.MOUSE_UP
MouseEvent.MOUSE_MOVE
MouseEvent.MOUSE_OVER
MouseEvent.MOUSE_OUT
Nella maggior parte dei casi, l'evento originale corrisponde all'evento inviato dall'elemento link. La corrispondenza degli eventi per gli eventi click
, mouseDown
, mouseOut
e mouseOver
. Esistono, tuttavia, due casi in cui l'evento originale viene convertito dall'elemento link a un evento correlato. Se un elemento link rileva un evento mouseOver
, invia un evento rollOver
. In modo analogo, se un elemento link rileva un evento mouseOut
, invia un evento rollOut.
Solitamente, il target dell'evento e le coordinate del mouse sono relativi all'istanza TextLine che contiene l'elemento link.
Implementazione
public function get originalEvent():MouseEvent
public function set originalEvent(value:MouseEvent):void
Elementi API correlati
FlowElementMouseEvent | () | Funzione di costruzione |
public function FlowElementMouseEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, flowElement:FlowElement = null, originalEvent:MouseEvent = null)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Crea un oggetto evento contenente informazioni relative all'attività del mouse. Gli oggetti evento vengono passati ai listener di eventi come parametri. Se prevedete di inviare manualmente un evento, utilizzate la funzione di costruzione. Non è necessario utilizzare la funzione di costruzione per rilevare gli oggetti FlowElementMouseEvent generati da un LinkElement.
Parametritype:String — Il tipo di evento. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata type . Vi sono sei tipi: FlowElementMouseEvent.CLICK ; FlowElementMouseEvent.MOUSE_DOWN ; FlowElementMouseEvent.MOUSE_MOVE ; FlowElementMouseEvent.MOUSE_UP ; FlowElementMouseEvent.ROLL_OVER e FlowElementMouseEvent.ROLL_OUT .
| |
bubbles:Boolean (default = false ) — Determina se l'oggetto Event partecipa alla fase di bubbling del flusso di eventi. Gli oggetti FlowElementMouseEvent non si propagano.
| |
cancelable:Boolean (default = true ) — Determina se l'oggetto Event può essere annullato. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata cancelable . Gli oggetti FlowElementMouseEvent possono essere annullati. Potete annullare il comportamento predefinito associato a questo evento chiamando il metodo preventDefault() nel gestore di eventi.
| |
flowElement:FlowElement (default = null ) — L'istanza di FlowElement, attualmente un LinkElement, associata a questo evento. I listener di eventi possono accedere a queste informazioni tramite la proprietà flowElement .
| |
originalEvent:MouseEvent (default = null ) — L'evento mouse originale che si è verificato in flowElement. I listener di eventi possono accedere a queste informazioni tramite la proprietà originalEvent .
|
CLICK | Costante |
public static const CLICK:String = "click"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Definisce il valore della proprietà type
di un oggetto evento click
.
Elementi API correlati
MOUSE_DOWN | Costante |
public static const MOUSE_DOWN:String = "mouseDown"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Definisce il valore della proprietà type
di un oggetto evento mouseDown
.
Elementi API correlati
MOUSE_MOVE | Costante |
public static const MOUSE_MOVE:String = "mouseMove"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Definisce il valore della proprietà type
di un oggetto evento mouseMove
.
Elementi API correlati
MOUSE_UP | Costante |
public static const MOUSE_UP:String = "mouseUp"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Definisce il valore della proprietà type
di un oggetto evento mouseUp
.
Elementi API correlati
ROLL_OUT | Costante |
public static const ROLL_OUT:String = "rollOut"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Definisce il valore della proprietà type
di un oggetto evento rollOut
.
Elementi API correlati
ROLL_OVER | Costante |
public static const ROLL_OVER:String = "rollOver"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Definisce il valore della proprietà type
di un oggetto evento rollOver
.
Elementi API correlati
In questo esempio viene illustrato come rilevare gli eventi del mouse che possono verificarsi per le istanze LinkElement. Le due fasi principali consistono nel chiamare addEventListener() per ogni tipo di evento e creare una funzione del gestore di eventi.
La chiamata a addEventListener()
viene effettuata all'istanza LinkElement. Potete utilizzare semplici stringhe, come "click"
o "mouseDown"
, ma è più sicuro utilizzare costanti statiche. Nell'esempio vengono utilizzate costanti della classe MouseEvent, in quanto nella classe FlowElementMouseEvent non sono disponibili costanti statiche.
In questo esempio è presente una sola funzione del gestore di eventi, in quanto il codice è lo stesso per tutti gli eventi. Normalmente, il codice che attiva la risposta a ogni tipo di evento varia, nel qual caso può essere preferibile utilizzare una funzione del gestore di eventi distinta per ogni chiamata a addEventListener()
.
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:44 PM Z