ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flashx.textLayout.events 

FlowElementMouseEvent  - AS3

Paketflashx.textLayout.events
Klassepublic class FlowElementMouseEvent
VererbungFlowElementMouseEvent Inheritance Event Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Ein Linkelement löst dieses Ereignis aus, wenn Mausaktivität erkannt wird. In Text Layout Framework ist diese spezielle Version von Mausereignissen enthalten, da Mausereignisse im Allgemeinen nicht erwünscht sind, wenn ein Flusselement in einen bearbeitbaren Textfluss eingebettet wird und da Linkelemente nicht in der Anzeigeliste enthalten sind (es sind keine DisplayObjects).

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

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : 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
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert 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
 Inherited
Dupliziert eine Instanz einer Event-Unterklasse.
Event
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält.
Event
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert 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
Eigenschaftendetails

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

Konstruktordetails

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.

Parameter
type: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.
Konstantendetails

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

FlowElementMouseEvent_example.as

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();  
        }

    }        
}




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.