AddWindowTimer()

Syntax

AddWindowTimer(#Window, Timer, Timeout)

Fügt einen neuen Timer (in Deutsch "Zeitgeber") zum angegebenen Fenster '#Window' hinzu. Dies verursacht #PB_Event_Timer Ereignisse, die in regelmäßigen Zeitabständen von den WindowEvent() bzw. WaitWindowEvent() Funktionen empfangen werden. Die Funktion RemoveWindowTimer() kann verwendet werden, um den Timer wieder zu entfernen.

Parameter

Der Parameter '#Window' definiert das Fenster für den Timer. Ein Timer wird immer zu einem Fenster hinzugefügt und wird entfernt, wenn dieses Fenster geschlossen wird.

Der Parameter 'Timer' ist eine benutzerdefinierte Zahl, welche diesen Timer identifiziert. Timer auf verschiedenen Fenstern dürfen sich überschneidende Nummern haben. Dieser Wert wird später von EventTimer() zurückgegeben, wenn ein #PB_Event_Timer empfangen wurde. Er kann auch verwendet werden, um den Timer mit der RemoveWindowTimer() Funktion wieder zu entfernen.

Der Parameter 'Timeout' definiert die Zeit in Millisekunden zwischen den #PB_Event_Timer Ereignissen.

Hinweis: Die Timer-Ereignisse werden nur generiert, wenn keine anderen Ereignisse zu verarbeiten sind (Timer sind Ereignisse mit niedriger Priorität). Dies bedeutet, dass die zwischen zwei Timern vergangene Zeit größer sein kann, als der definierte 'TimeOut'-Wert. Timer sind daher nicht geeignet für exaktes Timing (Zeitsteuerung), sondern eher gedacht für das Ausführen regelmäßiger Aufgaben wie das Aktualisieren eines Gadget-Inhalts oder ähnlich.

Beispiel:

  If OpenWindow(0, 0, 0, 400, 100, "Timer Example", #PB_Window_SystemMenu|#PB_Window_ScreenCentered)
    ProgressBarGadget(0, 10, 10, 380, 20, 0, 100)
    AddWindowTimer(0, 123, 250)
    
    Value = 0
    Repeat
      Event = WaitWindowEvent()
      
      If Event = #PB_Event_Timer And EventTimer() = 123
        Value = (Value + 5) % 100
        SetGadgetState(0, Value)
      EndIf    
      
    Until Event = #PB_Event_CloseWindow
  EndIf

Unterstützte OS

Alle