MFC:定时器
1. 定时器设置
API:CWnd::SetTimer()
函数原型:UINT SetTimer(UINT nIDEvent, UINT nElapse, void (CALLBACK EXPORT*lpfnTimer) (HWND, UINT, UINT, DWORD) );
返回值:
如果函数成功,则返回新定时器的标识符。应用程序可以将这个值传递给KillTimer成员函数以销毁定时器。如果成功,则返回非零值;否则返回0。
参数:
nIDEvent | 指定了不为零的定时器标识符。 |
nElapse | 指定了定时值;以毫秒为单位。 |
lpfnTimer | 指定了应用程序提供的TimerProc回调函数的地址,该函数被用于处理WM_TIMER消息。如果这个参数为NULL,则WM_TIMER消息被放入应用程序的消息队列并由CWnd对象来处理。 |
说明:
这个函数设置一个系统定时器。指定了一个定时值,每当发生超时,则系统就向设置定时器的应用程序的消息队列发送一个WM_TIMER消息,或者将消息传递给应用程序定义的TimerProc回调函数。
lpfnTimer回调函数不需要被命名为TimerProc,但是它必须按照如下方式定义:
void
CALLBACK EXPORT TimerProc(
HWND hWnd, //
调用SetTimer的CWnd的句柄
UINT nMsg, // WM_TIMER
UINT
nIDEvent // 定时器标识
DWORD dwTime //
系统时间
);
定时器是有限的全局资源;因此对于应用程序来说,检查SetTimer返回的值以确定定时器是否可用是很重要的。
2. 关闭定时器
API:KillTimer();
3. 定时器处理消息
a) WM_TIMER
映射入口 | 函数原型 |
ON_WM_TIMER( ) | afx_msg void OnTimer( UINT ) |
b) CWnd::OnTimer
afx_msg void OnTimer( UINT nIDEvent );
参数:
nIDEvent | 指定定时器的标识符。 |
说明:
当在SetTimer成员函数中指定的每一个时间间隔都被用来安装一个定时器之后,框架调用这个成员函数。
当在应用程序的消息队列中没有其它的消息时,Windows函数DispatchMessage发送一个WM_TIMER消息。
注意
框架调用这个成员函数来使你的应用程序可以处理一个Windows消息。传递给你的函数的参数反映了在消息收到时框架收到的参数。如果你调用了这个函数的基类实现,这个实现将使用最初随着消息传递过来的参数,而不是使用你提供给函数的参数。