Paketflash.utils
Klassepublic class Timer
VererbungTimer Inheritance EventDispatcher Inheritance Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Timer-Klasse ist die Schnittstelle zu Zeitgebern in Flash Player. Sie können neue Timer-Objekte erstellen, um Programmcode in einer bestimmten zeitlichen Reihenfolge auszuführen. Verwenden Sie zum Starten eines Timers die Methode start(). Fügen Sie einen Ereignis-Listener für das timer-Ereignis hinzu, um Programmcode einzurichten, der bei Ablauf des Timers ausgeführt wird.

Sie können festlegen, ob Timer-Objekte einmalig oder in bestimmten Abständen wiederholt ausgeführt werden sollen, um Programmcode nach einem Zeitplan auszuführen. Je nach Bildrate der SWF-Datei oder nach Flash Player-Umgebung (freier Speicher und andere Faktoren) werden Ereignisse in Flash Player möglicherweise zu leicht versetzten Zeitpunkten ausgelöst. Wenn eine SWF-Datei beispielsweise zur Wiedergabe mit 10 Bildern pro Sekunde eingerichtet ist, d. h. in Abständen von 100 Millisekunden, der Timer jedoch so eingestellt ist, dass ein Ereignis nach 80 Millisekunden ausgelöst wird, löst Flash Player das Ereignis kurz vor dem 100-Millisekunden-Intervall aus. Auch speicherintensive Skripts können zum zeitversetzten Auslösen von Ereignissen führen.

Beispiele anzeigen

Siehe auch

Verwenden von Datums- und Uhrzeitangaben
Verwenden von Zeitintervallen


Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  currentCount : int
[read-only] Die Gesamtzahl der Ereignisse, die der Timer ausgelöst hat, seit er bei 0 gestartet wurde.
Timer
  delay : Number
Die Dauer zwischen den Timer-Ereignissen in Millisekunden.
Timer
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
  repeatCount : int
Die Gesamtzahl der für den Timer festgelegten Ausführungen.
Timer
  running : Boolean
[read-only] Der aktuelle Zustand des Timers. Wird der Timer ausgeführt, ist dieser Wert "true", sonst "false".
Timer
Öffentliche Methoden
 MethodeDefiniert von
  
Timer(delay:Number, repeatCount:int = 0)
Erstellt ein neues Timer-Objekt mit den angegebenen Zuständen für "delay" und "repeatCount".
Timer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
  
Hält den Timer an, wenn dieser ausgeführt wird, und setzt die currentCount-Eigenschaft wieder auf 0, etwa wie die Taste zum Zurücksetzen einer Stoppuhr.
Timer
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
Startet den Timer, sofern dieser noch nicht ausgeführt wird.
Timer
  
Hält den Timer an.
Timer
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner vorangegangenen Elementen ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 EreignisÜbersicht Definiert von
 Inherited Wird ausgelöst, wenn Flash Player den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited Wird ausgelöst, wenn Flash Player den Betriebssystemfokus verliert und inaktiv wird.EventDispatcher
   Wird ausgelöst, wenn ein Timer-Objekt das in der Timer.delay-Eigenschaft festgelegte Intervall erreicht hat.Timer
   Wird ausgelöst, wenn die Anzahl der in "Timer.repeatCount" festgelegten Anforderungen ausgeführt wurde.Timer
Eigenschaftsdetail
currentCountEigenschaft
currentCount:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Gesamtzahl der Ereignisse, die der Timer ausgelöst hat, seit er bei 0 gestartet wurde. Wenn der Timer zurückgesetzt wurde, werden nur die seitdem erfolgten Ereignisse gezählt.


Implementierung
    public function get currentCount():int
delayEigenschaft 
delay:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Dauer zwischen den Timer-Ereignissen in Millisekunden. Wenn Sie das Zeitintervall festlegen, während der Timer ausgeführt wird, wird der Timer mit derselben repeatCount-Iteration neu gestartet.


Implementierung
    public function get delay():Number
    public function set delay(value:Number):void

Auslöser
Error — Es wird eine Ausnahme ausgelöst, wenn die angegebene Verzögerung ein negativer Wert oder keine endliche Zahl ist.
repeatCountEigenschaft 
repeatCount:int  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Gesamtzahl der für den Timer festgelegten Ausführungen. Wenn als Anzahl der Wiederholungen 0 festgelegt ist, wird der Timer unbegrenzt ausgeführt, bis die stop()-Methode aufgerufen oder das Programm beendet wird. Wenn als Anzahl der Wiederholungen ein Wert ungleich 0 festgelegt ist, wird der Timer entsprechend oft ausgeführt. Wenn für repeatCount ein Wert angegeben ist, der gleich oder kleiner dem Wert von currentCount ist, wird der Timer angehalten und löst keine Ereignisse mehr aus.


Implementierung
    public function get repeatCount():int
    public function set repeatCount(value:int):void
runningEigenschaft 
running:Boolean  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der aktuelle Zustand des Timers. Wird der Timer ausgeführt, ist dieser Wert true, sonst false.


Implementierung
    public function get running():Boolean
Konstruktordetail
Timer()Konstruktor
public function Timer(delay:Number, repeatCount:int = 0)

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Erstellt ein neues Timer-Objekt mit den angegebenen Zuständen für delay und repeatCount.

Der Timer startet nicht automatisch. Sie müssen dazu die start()-Methode aufrufen.

Parameter
delay:Number — Die Dauer zwischen zwei Timer-Ereignissen in Millisekunden.
 
repeatCount:int (default = 0) — Gibt die Anzahl der Wiederholungen an. Wenn der Wert 0 ist, wird der Timer unbegrenzt ausgeführt. Wenn der Wert ungleich 0 ist, wird der Timer so oft ausgeführt wie angegeben und dann angehalten.

Auslöser
Error — Die angegebene Verzögerung ist ein negativer Wert oder keine endliche Zahl.

Beispiel

Im folgenden Beispiel hat der Benutzer 90 Sekunden Zeit, eine Antwort in ein Eingabetextfeld zu schreiben. Alle 30 Sekunden wird der Benutzer in einem Statustextfeld darüber informiert, wie viel Zeit ihm noch verbleibt.

Es wird ein Timer-Objekt erstellt, das in 30 Sekunden startet (die Verzögerung ist auf 30000 Millisekunden eingestellt) und drei Mal wiederholt wird, sodass sich der Gesamtzeitraum von 90 Sekunden ergibt. (Der Timer stoppt nach dem dritten Mal.)

Für den Timer myTimer werden zwei Ereignis-Listener hinzugefügt. Der erste wird ausgelöst durch das Ereignis TimerEvent.TIMER, das bei jedem Starten des Timers auftritt. Die Methode timerHandler() ändert den Text für das Textfeld statusTextField, um die verbleibenden Sekunden anzugeben. (Beachten Sie, dass die Timer-Klasse verfolgt, wie viele Male ein Start erforderlich ist (repeats), indem die Zahl in der Eigenschaft currentCount erhöht wird.)

Nachdem der Timer zum letzten Mal aufgerufen wurde, wird das Ereignis TimerEvent.TIMER_COMPLETE ausgelöst und die Methode completeHandler() aufgerufen. Die Methode completeHandler() ändert den Typ des Textfelds inputTextField von INPUT zu DYNAMIC, was bedeutet, dass der Benutzer keine Eingaben oder Änderungen für das Textfeld mehr vornehmen kann.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldType;
    import flash.text.TextFieldAutoSize;
    import flash.utils.Timer;
    import flash.events.TimerEvent;
    import flash.events.Event;

    public class Timer_constructorExample extends Sprite {
            private var statusTextField:TextField = new TextField();        
            private var inputTextField:TextField = new TextField();
            private var delay:uint = 30000;
            private var repeat:uint = 3;
            private var myTimer:Timer = new Timer(delay, repeat);
            
        public function Timer_constructorExample() {
            inputTextField.x = 10;
            inputTextField.y = 10;
            inputTextField.border = true;
            inputTextField.background = true;
            inputTextField.height = 200;
            inputTextField.width = 200;
            inputTextField.multiline = true;
            inputTextField.wordWrap = true;
            inputTextField.type = TextFieldType.INPUT;

            statusTextField.x = 10;
            statusTextField.y = 220;
            statusTextField.background = true;
            statusTextField.autoSize = TextFieldAutoSize.LEFT;   

            myTimer.start(); 
            statusTextField.text = "You have " + ((delay * repeat) / 1000) 
                                 + " seconds to write your response.";

            myTimer.addEventListener(TimerEvent.TIMER, timerHandler);
            myTimer.addEventListener(TimerEvent.TIMER_COMPLETE, completeHandler);

            addChild(inputTextField);
            addChild(statusTextField);
        }

        private function timerHandler(e:TimerEvent):void{
            repeat--;
            statusTextField.text = ((delay * repeat) / 1000) + " seconds left.";
        }

        private function completeHandler(e:TimerEvent):void {
            statusTextField.text = "Times Up.";
            inputTextField.type = TextFieldType.DYNAMIC;    
        }
    }
}
Methodendetail
reset()Methode
public function reset():void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Hält den Timer an, wenn dieser ausgeführt wird, und setzt die currentCount-Eigenschaft wieder auf 0, etwa wie die Taste zum Zurücksetzen einer Stoppuhr. Wird anschließend start() aufgerufen, wird die Timer-Instanz die mit dem repeatCount-Wert festgelegte Anzahl an Wiederholungen ausgeführt.

Siehe auch

start()Methode 
public function start():void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Startet den Timer, sofern dieser noch nicht ausgeführt wird.

stop()Methode 
public function stop():void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Hält den Timer an. Wird nach start() die Methode stop() aufgerufen, wird die Timer-Instanz die mit dem repeatCount-Wert festgelegte verbleibende Anzahl an Wiederholungen ausgeführt.

Siehe auch

Ereignisdetail
timer Ereignis
Ereignisobjekttyp: flash.events.TimerEvent
TimerEvent.type property = flash.events.TimerEvent.TIMER

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird ausgelöst, sobald ein Timer-Objekt das in der Timer.delay-Eigenschaft festgelegte Intervall erreicht hat.

Definiert den Wert der Eigenschaft type eines timer-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.
targetDas Timer-Objekt, das sein Intervall erreicht hat.
timerComplete Ereignis  
Ereignisobjekttyp: flash.events.TimerEvent
TimerEvent.type property = flash.events.TimerEvent.TIMER_COMPLETE

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird ausgelöst, sobald die Anzahl der in Timer.repeatCount festgelegten Anforderungen ausgeführt wurde.

Definiert den Wert der Eigenschaft type eines timerComplete-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.
targetDas Timer-Objekt, das seine Anforderungen abgearbeitet hat.
Beispiele Verwendung von Beispielen
TimerExample.as

Im folgenden Beispiel wird anhand der Klasse TimerExample erläutert, wie die Listener-Methode timerHandler() für auszulösende TimerEvent-Ereignisse konfiguriert werden kann. Der Timer wird gestartet, wenn start() aufgerufen wird. Anschließend werden die Timer-Ereignisse ausgelöst.
package {
    import flash.utils.Timer;
    import flash.events.TimerEvent;
    import flash.display.Sprite;

    public class TimerExample extends Sprite {

        public function TimerExample() {
            var myTimer:Timer = new Timer(1000, 2);
            myTimer.addEventListener("timer", timerHandler);
            myTimer.start();
        }

        public function timerHandler(event:TimerEvent):void {
            trace("timerHandler: " + event);
        }
    }
}




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/utils/Timer.html