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...
fl.events 

ScrollEvent  - AS3 Flash

Paketfl.events
Klassepublic class ScrollEvent
VererbungScrollEvent Inheritance Event Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Die ScrollEvent-Klasse definiert das scroll-Ereignis, das mit der ScrollBar-Komponente verknüpft ist.

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
  delta : Number
[schreibgeschützt] Ruft das Ausmaß der Änderung der Bildlaufposition in Pixel ab.
ScrollEvent
  direction : String
[schreibgeschützt] Ruft eine Konstante ab, die die mit dem Ereignis verknüpfte Bewegungsrichtung anzeigt.
ScrollEvent
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
  position : Number
[schreibgeschützt] Ruft die aktuelle Bildlaufposition in Pixel ab.
ScrollEvent
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
ScrollEvent(direction:String, delta:Number, position:Number)
Erstellt ein neues ScrollEvent-Objekt mit den angegebenen Parametern.
ScrollEvent
  
[override] Erstellt eine Kopie des ScrollEvent-Objekts und stellt die Werte der einzelnen Parameter so ein, dass sie den Werten des Originals entsprechen.
ScrollEvent
 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
  
[override] Gibt einen String zurück, der alle Eigenschaften des ScrollEvent-Objekts enthält.
ScrollEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  SCROLL : String = "scroll"
[statisch] Definiert den Wert der Eigenschaft type eines scroll-Ereignisobjekts.
ScrollEvent
Eigenschaftendetails

delta

Eigenschaft
delta:Number  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Ruft das Ausmaß der Änderung der Bildlaufposition in Pixel ab. Ein positiver Wert zeigt an, dass nach unten oder nach rechts geblättert wurde. Ein negativer Wert zeigt an, dass nach oben oder nach links geblättert wurde.



Implementierung
    public function get delta():Number

direction

Eigenschaft 
direction:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Ruft eine Konstante ab, die die mit dem Ereignis verknüpfte Bewegungsrichtung anzeigt. Der Wert ScrollBarDirection.HORIZONTAL zeigt eine horizontale Bewegungsrichtung an, der Wert ScrollBarDirection.VERTICAL eine vertikale.



Implementierung
    public function get direction():String

Verwandte API-Elemente

position

Eigenschaft 
position:Number  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Ruft die aktuelle Bildlaufposition in Pixel ab.



Implementierung
    public function get position():Number
Konstruktordetails

ScrollEvent

()Konstruktor
public function ScrollEvent(direction:String, delta:Number, position:Number)

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Erstellt ein neues ScrollEvent-Objekt mit den angegebenen Parametern.

Parameter
direction:String — Die mit dem Ereignis verknüpfte Bewegungsrichtung. Der Wert ScrollBarDirection.HORIZONTAL zeigt eine horizontale Bewegungsrichtung an, der Wert ScrollBarDirection.VERTICAL eine vertikale.
 
delta:Number — Die Änderung der Bildlaufposition in Pixel. Ein positiver Wert zeigt an, dass nach unten oder nach rechts geblättert wurde. Ein negativer Wert zeigt an, dass nach oben oder nach links geblättert wurde.
 
position:Number — Die aktuelle Bildlaufposition.
Methodendetails

clone

()Methode
override public function clone():Event

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Erstellt eine Kopie des ScrollEvent-Objekts und stellt die Werte der einzelnen Parameter so ein, dass sie den Werten des Originals entsprechen.

Rückgabewerte
Event — Ein neues ScrollEvent-Objekt mit Parameterwerten, die dem Original entsprechen.

toString

()Methode 
override public function toString():String

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Gibt einen String zurück, der alle Eigenschaften des ScrollEvent-Objekts enthält. Der String hat das folgende Format:

[ ScrollEvent type= value bubbles= value cancelable= value direction= value delta= value position= value]

Rückgabewerte
String — Eine Stringdarstellung des ScrollEvent-Objekts.
Konstantendetails

SCROLL

Konstante
public static const SCROLL:String = "scroll"

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: Flash Player 9.0.28.0, AIR 1.0

Definiert den Wert der Eigenschaft type eines scroll-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
delta1; ein Wert, der das Ausmaß des Bildlaufs angibt.
directionvertical; die ScrollBar-Richtung.
position0; die Position des Bildlauffelds, nachdem es bewegt wurde.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft currentTarget, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein Listener für das scroll-Ereignis verwendet. Die direction-Eigenschaft der ScrollEvent-Klasse wird verwendet, um festzustellen, ob bei dem Inhalt ein horizontaler oder vertikaler Bildlauf durchführt wurde.
import fl.containers.ScrollPane;
import fl.events.ScrollEvent;
import fl.controls.ScrollBarDirection;

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.scrollDrag = true;
myScrollPane.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myScrollPane.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myScrollPane);

function scrollHandler(event:ScrollEvent):void {
    switch (event.direction) {
        case ScrollBarDirection.HORIZONTAL:
            trace("horizontal scroll", event.position, "of", event.currentTarget.maxHorizontalScrollPosition);
            break;
        case ScrollBarDirection.VERTICAL:
            trace("vertical scroll", event.position, "of", event.currentTarget.maxVerticalScrollPosition);
            break;
    }
}




[ 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.