KillTimer

Windows API函式。該函式移除先前用SetTimer設定的定時器。在定時器使用完畢後移除定時器時使用。

基本介紹

• 中文名：停止時鐘
• 外文名：KillTimer
• 聲明位置：WinUser.h
• 返回值類型：int
• 調用方式：__stdcall
• 參數類型：(HWND__*,UINT_PTR)

原型

WINUSERAPI　BOOL　WINAPI　KillTimer(_In_opt_HWNDhWnd,　_In_UINT_PTRuIDEvent);

參數

hWnd：與定時器相關聯的視窗句柄

nIDEvent： 傳遞給SetTimer的定時器ID值。

說明

銷毀以前調用SetTimer創建的用nIDEvent標識的定時器事件。不能將此定時器有關的未處理的WM_TIMER訊息都從訊息佇列中清除。

返回值

BOOL 如果函式成功,返回一個非0值,

如果失敗,返回值為0

注意: 該函式並不移除WM_TIMER 先前傳送到訊息列隊中的訊息

補充

如果使用.Net Framework 4.0版本的CWnd::KillTimer,可以這樣調用：

KillTimer(IDT_TIMERID);//IDT_TIMERID 是 對應定時器的ID，可以這樣定義：

#define IDT_TIMERID 1