SetTimer

von ActiveVB-Team

Deklaration

Declare Function SetTimer Lib "user32" ( _
                 ByVal hWnd As Long, _
                 ByVal nIDEvent As Long, _
                 ByVal uElapse As Long, _
                 ByVal lpTimerFunc As Long) As Long

Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel SetTimer des API-Wikis.

SetTimer erzeugt oder modifiziert einen Timer. Ein Timer ist ein Ereignis, das von Windows in bestimmten Zeitabständen ausgeführt wird. Timer können WM_TIMER Nachrichten erzeugen oder aber direkte Callbacks in einer Anwendung ausführen.

Parameter
hWnd	Das Fenster, das dem Timer zugeordnet ist. Wenn dieser Parameter gleich Null ist, wird der Timer keinem Fenster zugeprdnet, d.h. WM_TIMER Nachrichten werden zwar in der Task-Warteschlange abgelegt, aber nicht verarbeitet.
nIDEvent	Ein numerischer Wert der dem Timer zugeordnet wird. Wenn ein neuer Bezeichner angegeben wird, wird ein Timer erzeugt. Wenn eine existierende Nummer angegeben wird, bearbeitet die Funktion die Timer-Information, statt einen neuen Timer zu erzeugen. Wenn Null angegeben wird, erzeugt das System einen nicht verwendeten Timer-Bezeichner und gibt diesen zurück.
uElapse	Gibt das zu verwendende Timer-Intervall in Millisekunden an.
lpTimerFunc	Die Callback-Funktion für die Timer-Ereignisse. Ist dieser Parameter gleich Null, werden WM_TIMER Nachrichten in die Nachrichten-Warteschlange gestellt. Wenn eine Funktions-Adresse übergeben wird, ruft das System diese Funktion für jedes Timer-Ereignis auf, statt WM_TIMER Messages zu erzeugen.

Tabelle 1

Rückgabewerte
ID	Die Timer ID.
0	Es konnte kein Timer erzeugt werden.

Tabelle 2

Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
KillTimer

Zugehörige Tipps

Längere Timerzeiten mit API-Timer [Tipp 0358]
Verzeichnis inkl. Unterverzeichnisse auf Änderungen überwachen [Tipp 0367]
Animierte GIF-Dateien mit GDI+ abspielen [Tipp 0675]

Zugehörige Microsoft Knowledge Base Artikel