在Windows API中,SetTimer
函数用于在指定的窗口上设置一个定时器。当定时器到期时,窗口会收到一个WM_TIMER
消息。以下是SetTimer
函数的详细解释和用法:
函数原型
UINT_PTR SetTimer(
HWND hWnd, // 窗口句柄
UINT_PTR nIDEvent, // 定时器标识符
UINT uElapse, // 定时器的时间间隔(毫秒)
TIMERPROC lpTimerFunc // 定时器回调函数(可选)
);
参数
hWnd
:接收WM_TIMER
消息的窗口句柄。如果此参数为NULL,则lpTimerFunc
必须是一个有效的回调函数地址,并且WM_TIMER
消息将被发送到调用线程的消息队列中,而不是发送到特定的窗口。nIDEvent
:定时器的标识符。如果此参数设置为0,系统将为定时器提供一个唯一的标识符。uElapse
:定时器的时间间隔(以毫秒为单位)。当经过指定的时间间隔后,定时器到期,并发送WM_TIMER
消息。lpTimerFunc
:一个指向回调函数的指针,当定时器到期时,该函数将被调用。此参数是可选的,如果为NULL,则当定时器到期时,将发送WM_TIMER
消息到指定的窗口。
返回值
如果函数成功,返回值是定时器的标识符。如果函数失败,返回值是0。要获取扩展的错误信息,请调用GetLastError
。
示例
下面是一个简单的示例,展示了如何在Windows应用程序中使用SetTimer
:
#include <windows.h>
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
switch (uMsg)
{
case WM_TIMER