Zum Hauptinhalt springen

SysTimerCreate

SysTimerCreate(int1, int2[, handle3]) : handle​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von der DLL-Schnittstelle mit grafischer Erweiterung Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service mit grafischer Erweiterung

Zeitgesteuertes Ereignis starten

Details

Mit dieser Funktion wird in einem bestimmten Intervall (int1) in Millisekunden das Ereignis EvtTimer ausgelöst. Der Minimalwert von (int1) beträgt 100 ms. Bei Angabe von -1 in (int2) wird das Ereignis unbegrenzt wiederholt, ansonsten enthält (int2) die Anzahl der auszulösenden Ereignisse. Bei (int2) gleich 0 wird kein Ereignis ausgelöst.

In (handle3) kann der Deskriptor des Frame -Objekts angegeben werden, welches das Ereignis erhält. Wird (handle3) nicht angegeben oder auf 0 gesetzt, erhalten alle Top-Level-Frames (die Frames ohne Parent) das Ereignis. Eine entsprechende Prozedurfunktion für das Ereignis EvtTimer muss beim jeweiligen Frame angegeben werden.

Das Resultat ist der Deskriptor des Timers.

Das Zeitintervall beginnt erst nach der kompletten Verarbeitung von EvtTimer erneut. Damit wird verhindert, das während der Ereignisverarbeitung bereits ein weiteres Ereignis ausgelöst wird.

Die maximale Anzahl von Timern ist nicht beschränkt. Es ist zu beachten, dass ein Timer immer mit SysTimerClose () entfernt werden muss, auch wenn er keine Ereignisse mehr auslöst.

Beispiel:

// Ein Timer auf den Dialog $Frame, mit
// einem Intervall von 300 ms und einer
// unendlichen Wiederholung wird erstellt
tHdlTimer # SysTimerCreate(300, -1, $Frame);