产品导航

SetTimer

点击次数：1152 更新时间：2017-5-30 13:23:14 【打印此页】

原文链接 -> 传送门

函数功能：

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

提示

郴维网为您提供各类专业服务：
软件开发，电脑配件销售，WIFI路由器销售，上门电脑维修，上门安装系统，系统安装，软、硬件安装，电脑除尘清灰，显示器维修，WIFI安装调试，服务器维护，数据恢复，密码破解，网络布线，网络检修，打印机维修，打印机加碳粉，苹果电脑安装系统，苹果电脑安装双系统，监控安装维护，电脑外包，笔记本电脑维修，餐饮、美容行业软件安装等。。。。。。

点击次数：1152 更新时间：2017-5-30 13:23:14 【打印此页】

上一条：WM_TIMER 消息

下一条：KillTimer