SetTimer

小甲鱼

注：本文档由 Diu 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

SetTimer 函数用于创建一个具有指定超时时间的定时器。


API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选的。

UINT_PTR WINAPI SetTimer(
  _In_opt_ HWND      hWnd,
  _In_     UINT_PTR  nIDEvent,
  _In_     UINT      uElapse,
  _In_opt_ TIMERPROC lpTimerFunc
);

参数解析：

参数	含义
hWnd	1. 指定与定时器相关联的窗口的句柄 2. 该窗口必须属于调用线程 3. 如果 hWnd 的值为 NULL，同时 nIDEvent 参数指定为一个已经存在的定时器，那么这个定时器将和一个已经存在的非 NULL 的 hWnd 值的定时器一样被替换
nIDEvent	1. 非零的定时器标志符 2. 如果 hWnd 参数为 NULL，并且 nIDEvent 参数不匹配任何已经存在的定时器，那么 nIDEvent 将被忽略，并会产生一个新的定时器 ID 3. 如果 hWnd 参数不为 NULL，并且 hWnd 指定的窗口已经有一个具有 nIDEvent 值得定时器，则已经存在的定时器将会被新产生的定时器替换 4. 当 SetTimer 替换一个定时器时，定时器会被重置。因此，在达到当前超时值后一条消息将会被发送，而之前设置的超时值将会被忽略 5. 如果函数的调用不是用来替换一个已经存在的定时器，那么如果 hWnd 为 NULL，nIDEvent 应该为 0
uElapse	1. 以毫秒为单位的超时值 2. 如果 uElapse 的值小于 USER_TIMER_MINIMUM (0x0000000A)，则超时值会被设置成 USER_TIMER_MINIMUM 4. 如果 uElapse 的值大于 USER_TIMER_MAXIMUM (0x7FFFFFFF)，则超时值会被设置成 USER_TIMER_MAXIMUM
lpTimerFunc	1. 指向一个函数的指针，当经过超时值时间时，该函数将被调用 2. 有关该函数的更多信息，参见 TimerProc 3. 如果 lpTimerFunc 为 NULL，系统会传递一条 WM_TIMER 消息到应用程序消息队列。消息的 MSG 结构的 hwnd 成员包含 hWnd 参数的值

返回值：

1. 如果函数调用成功，并且 hWnd 参数为 NULL，则返回值为标识新定时器的整型值。应用程序可以传递该值给 KillTimer 函数来销毁该定时器；

2. 如果函数调用成功，并且 hWnd 参数不为 NULL，则返回值为非零的整型值，应用程序可以传递 nIDEvent 参数的值给 KillTimer 函数来销毁该定时器；

3. 如果函数创建定时器失败，则返回值为 0；

获取有关错误的更多信息，请调用 GetLastError 函数。


备注：

1. 应用程序可以通过在窗口过程中包含 WM_TIMER case 语句，或者在创建定时器时指定 TimerProc 回调函数来处理 WM_TIMER 消息。在你指定了一个 TimerProc 回调函数之后，当窗口处理 WM_TIMER 消息时，默认的窗口过程便会调用该回调函数。因此，你需要在调用线程中分派该消息，甚至在你使用 TimerProc 而不是在窗口过程中处理 WM_TIMER 消息时。

2. WM_TIMER 消息的 wParam 参数包含 nIDEvent 参数的值。

3. 定时器标志符，nIDEvent，是与窗口相关联的。不同的窗口能有相同的定时器标识符。这些定时器是不同的。

4. SetTimer 函数在 hWnd 参数的值为 NULL 的情况下能够重复使用定时器标识符。


需求：

Minimum supported client	Windows 2000 专业版 [桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [桌面应用程序]
Header	Winuser.h (包含于 Windows.h)
Library	User32.lib
DLL	User32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。

joe123

好东西想

TyCk

如果使用第三种方法调用的话，hWnd 为 NULL，nIDEvent 为 0，那么回调函数中传入的hwnd也为NULL，那么对窗口类的修改就没有效果。
如果不另外定义全局变量的话，有没有啥好的解决办法么？

defendre

可以声明一个类，要内部成员函数的参数调用，也可以在类的成员定义输入参数，只有类内可以看到，就是调用时要注意作用空间的范围规定，在大公式好人，人员复杂的环境可以在成员内执行一个私有变量，大多数情况不需要