CWnd::SetTimer

UINT SetTimer ( UINT nIDEvent, UINT nElapse, nichtig (Rückruf EXPORT * LpfnTimer) (HWND, UINT, UINT, DWORD) );

Rückgabewert

Der Zeitgeber Bezeichner des neuen Zeitgebers wenn die Funktion erfolgreich ist. Eine Anwendung übergibt diesen Wert an die KillTimer -Memberfunktion um den Zeitgeber zu töten. Ungleich NULL, wenn erfolgreich; andernfalls 0.

Parameter

nIDEvent

Gibt einen Wert ungleich NULL Zeitgeber Bezeichner.

nElapse

Gibt den Timeoutwert in Millisekunden.

lpfnTimer

Gibt die Adresse von der Anwendung bereitgestellte TimerProc Callback-Funktion, die die WM_TIMER -Meldungen verarbeitet. Wenn dieser Parameter NULList, sind die WM_TIMER -Meldungen in der Anwendung-Warteschlange platziert und von der CWnd -Objekt behandelt.

Bemerkungen

Installiert einen Systemzeitgeber. Ein Timeoutwert angegeben ist, und jedes Mal, wenn ein Timeout auftritt, sendet das System eine WM_TIMER -Nachricht, um die Installation von Anwendung die Nachrichtenwarteschlange oder übergibt die Nachricht an eine anwendungsdefinierte Rückruffunktion für TimerProc .

Muss die LpfnTimer -Rückruffunktion nicht TimerProcbenannt werden, aber es muss wie folgt definiert werden:

void CALLBACK EXPORT TimerProc)
 &Nbsp; HWND hWnd, / / handle von CWnd, die SetTimer aufgerufen
   UINT nMsg, / / WM_TIMER
   UINT nIDEvent / / Timer-Identifizierung
   DWORD DwTime / / Systemzeit
)

Timer sind eine begrenzte globale Ressource; Deshalb ist es wichtig, dass eine Anwendung, den Rückgabewert von der Memberfunktion SetTimer überprüfen zu überprüfen, ob ein Timer tatsächlich verfügbar ist.

CWnd Übersicht |nbsp; Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp; WM_TIMER, CWnd::KillTimer, ::SetTimer

Index