Paket | flashx.textLayout.events |
Klasse | public class FlowElementMouseEvent |
Vererbung | FlowElementMouseEvent Event Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Sie können einem Linkelement einen Ereignis-Listener hinzufügen, um auf diese Art von Ereignis zu warten. Wenn Sie sich entscheiden, das Ereignis abzubrechen, indem Sie Event.preventDefault()
aufrufen, tritt das standardmäßige Verhalten, welches mit diesem Ereignis verknüpft ist, nicht auf.
Wenn Sie sich entscheiden, dem Linkelement keinen Ereignis-Listener hinzuzufügen, oder Ihre Ereignis-Listener-Funktion das Verhalten nicht beendet, wird das Ereignis erneut ausgelöst, diesmal jedoch nicht vom Linkelement selbst, sondern von der dazugehörigen TextFlow-Instanz. Dies bietet eine zweite Möglichkeit, mit einem Ereignis-Listener, der dem TextFlow angefügt ist, auf dieses Ereignis zu warten.
FlowElementMouseEvents werden nur ausgelöst, wenn der Text nicht editiert werden kann oder wenn gleichzeitig mit der Mausaktivität auch die Strg-Taste gedrückt wird.
Die folgenden sechs Ereignistypen werden nur ausgelöst, wenn der Text nicht editiert werden kann oder die Strg-Taste gedrückt wird.
-
FlowElementMouseEvent.CLICK
-
FlowElementMouseEvent.MOUSE_DOWN
-
FlowElementMouseEvent.MOUSE_UP
-
FlowElementMouseEvent.MOUSE_MOVE
-
FlowElementMouseEvent.ROLL_OVER
-
FlowElementMouseEvent.ROLL_OUT
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
bubbles : Boolean [schreibgeschützt]
Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt. | Event | ||
cancelable : Boolean [schreibgeschützt]
Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann. | Event | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
currentTarget : Object [schreibgeschützt]
Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. | Event | ||
eventPhase : uint [schreibgeschützt]
Die aktuelle Phase im Ereignisablauf. | Event | ||
flowElement : FlowElement
Das FlowElement, von dem das Ereignis abgesetzt wurde. | FlowElementMouseEvent | ||
originalEvent : MouseEvent
Das ursprüngliche Mausereignis, das durch die Mausaktivität generiert wurde. | FlowElementMouseEvent | ||
target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | ||
type : String [schreibgeschützt]
Der Ereignistyp. | Event |
Methode | Definiert von | ||
---|---|---|---|
FlowElementMouseEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, flowElement:FlowElement = null, originalEvent:MouseEvent = null)
Erstellt ein Ereignisobjekt, das Informationen über Mauseaktivität enthält. | FlowElementMouseEvent | ||
Dupliziert eine Instanz einer Event-Unterklasse. | Event | ||
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. | Event | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. | Event | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält. | Event | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
Konstante | Definiert von | ||
---|---|---|---|
CLICK : String = "click" [statisch]
Definiert den Wert der Eigenschaft type eines Klickereignisobjekts. | FlowElementMouseEvent | ||
MOUSE_DOWN : String = "mouseDown" [statisch]
Definiert den Wert der Eigenschaft type eines mouseDown-Ereignisobjekts. | FlowElementMouseEvent | ||
MOUSE_MOVE : String = "mouseMove" [statisch]
Definiert den Wert der Eigenschaft type eines mouseMove-Ereignisobjekts. | FlowElementMouseEvent | ||
MOUSE_UP : String = "mouseUp" [statisch]
Definiert den Wert der Eigenschaft type eines mouseUp-Ereignisobjekts. | FlowElementMouseEvent | ||
ROLL_OUT : String = "rollOut" [statisch]
Definiert den Wert der Eigenschaft type eines rollOut-Ereignisobjekts. | FlowElementMouseEvent | ||
ROLL_OVER : String = "rollOver" [statisch]
Definiert den Wert der Eigenschaft type eines rollOver-Ereignisobjekts. | FlowElementMouseEvent |
flowElement | Eigenschaft |
flowElement:FlowElement
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Das FlowElement, von dem das Ereignis abgesetzt wurde.
Implementierung
public function get flowElement():FlowElement
public function set flowElement(value:FlowElement):void
Verwandte API-Elemente
originalEvent | Eigenschaft |
originalEvent:MouseEvent
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Das ursprüngliche Mausereignis, das durch die Mausaktivität generiert wurde. Diese Eigenschaft kann einen der folgenden Werte enthalten:
MouseEvent.CLICK
MouseEvent.MOUSE_DOWN
MouseEvent.MOUSE_UP
MouseEvent.MOUSE_MOVE
MouseEvent.MOUSE_OVER
MouseEvent.MOUSE_OUT
In den meisten Fällen stimmt das ursprüngliche Ereignis mit dem vom Linkelement ausgelösten Ereignis überein. Die Ereignisse stimmen für click
-, mouseDown
-, mouseOut
- und mouseOver
-Ereignisse überein. Es gibt jedoch zwei Fälle, in denen das ursprüngliche Ereignis vom Linkelement in ein verwandtes Ereignis konvertiert wird. Wenn ein Linkelement ein mouseOver
-Ereignis erkennt, löst es ein rollOver
-Ereignis aus. Wenn ein Linkelement ein mouseOut
-Ereignis erkennt, löst es ein rollOut
-Ereignis aus. Normalerweise sind das Ereignisziel und die Mauskoordinaten mit der TextLine-Instanz verknüpft, die das Linkelement enthält.
Implementierung
public function get originalEvent():MouseEvent
public function set originalEvent(value:MouseEvent):void
Verwandte API-Elemente
FlowElementMouseEvent | () | Konstruktor |
public function FlowElementMouseEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, flowElement:FlowElement = null, originalEvent:MouseEvent = null)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Erstellt ein Ereignisobjekt, das Informationen über Mauseaktivität enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben. Verwenden Sie den Konstruktor, wenn Sie vorhaben, ein Ereignis manuell auszulösen. Um auf FlowElementMouseEvent-Objekte zu warten, die von einem FlowElement generiert wurden, benötigen Sie den Konstruktor nicht.
Parametertype:String — Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es stehen sechs Typen zur Verfügung: FlowElementMouseEvent.CLICK ; FlowElementMouseEvent.MOUSE_DOWN ; FlowElementMouseEvent.MOUSE_MOVE ; FlowElementMouseEvent.MOUSE_UP ; FlowElementMouseEvent.ROLL_OVER ; and FlowElementMouseEvent.ROLL_OUT .
| |
bubbles:Boolean (default = false ) — Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. FlowElementMouseEvent-Objekte propagieren nicht.
| |
cancelable:Boolean (default = true ) — Bestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene cancelable -Eigenschaft auf diese Informationen zugreifen. FlowElementMouseEvent-Objekte können abgebrochen werden. Sie können das mit diesem Ereignis verknüpfte Standardverhalten abbrechen, indem Sie die preventDefault() -Methode in Ihrem Ereignis-Listener aufrufen.
| |
flowElement:FlowElement (default = null ) — Die mit diesem Ereignis verknüpfte Instanz des FlowElement, momentan ein LinkElement. Ereignis-Listener können über die flowElement -Eigenschaft auf diese Informationen zugreifen.
| |
originalEvent:MouseEvent (default = null ) — Das ursprüngliche Mausereignis, das für das FlowElement auftrat. Ereignis-Listener können über die originalEvent -Eigenschaft auf diese Informationen zugreifen.
|
CLICK | Konstante |
public static const CLICK:String = "click"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Definiert den Wert der Eigenschaft type
eines click
-Ereignisobjekts.
Verwandte API-Elemente
MOUSE_DOWN | Konstante |
public static const MOUSE_DOWN:String = "mouseDown"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Definiert den Wert der Eigenschaft type
eines mouseDown
-Ereignisobjekts.
Verwandte API-Elemente
MOUSE_MOVE | Konstante |
public static const MOUSE_MOVE:String = "mouseMove"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Definiert den Wert der Eigenschaft type
eines mouseMove
-Ereignisobjekts.
Verwandte API-Elemente
MOUSE_UP | Konstante |
public static const MOUSE_UP:String = "mouseUp"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Definiert den Wert der Eigenschaft type
eines mouseUp
-Ereignisobjekts.
Verwandte API-Elemente
ROLL_OUT | Konstante |
public static const ROLL_OUT:String = "rollOut"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Definiert den Wert der Eigenschaft type
eines rollOut
-Ereignisobjekts.
Verwandte API-Elemente
ROLL_OVER | Konstante |
public static const ROLL_OVER:String = "rollOver"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Definiert den Wert der Eigenschaft type
eines rollOver
-Ereignisobjekts.
Verwandte API-Elemente
Dieses Beispiel zeigt das Warten auf Mausereignisse, die eventuell für eine LinkElement-Instanz auftreten. Die beiden entscheidenden Schritte sind, den addEventListener() für jeden Ereignistyp aufzurufen und eine Ereignisprozedurfunktion zu erstellen.
Der Aufruf an addEventListener()
wird an die LinkElement-Instanz gerichtet. Sie können einfache Strings wie"click"
oder "mouseDown"
verwenden, es ist jedoch sicherer, mit statische Konstanten zu arbeiten. Im Beispiel werden Konstanten der MouseEvent-Klasse verwendet, da es in der FlowElementMouseEvent-Klasse keine statischen Konstanten gibt.
Dieses Beispiel enthält nur eine Ereignisprozedurfunktion, da der Code für alle Ereignisse gleich ist. Normalerweise unterscheidet sich der Code für die verschiedenen Ereignistypen. Aus diesem Grund ist eine separate Ereignisprozedurfunktion für jeden Aufruf an addEventListener()
die bessere Lösung.
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, 10:04 AM Z