SetTimer

SetTimer

SetTimer是一種API函式，位於user32.dll中。你想每隔一段時間執行一件事的的時候，你可以使用它。 使用定時器的方法比較簡單，通常告訴Windows一個時間間隔，然後Windows以此時間間隔周期性觸發程式。通常有兩種方法來實現：傳送WM_TIMER訊息和調用應用程式定義的回調函式。不需要指定定時器時，可以調用對應的KillTimer函式銷毀指定的時鐘。

基本介紹

  • 中文名：創建時鐘
  • 外文名：SetTimer
  • 簡稱：ST
  • 使用方法：編程調用
  • 觸發方式：周期性觸發程式
  • 實現方式種類：2種
簡介,函式的用法,回調函式,

簡介

SetTimer函式
創建或設定一個定時器，該函式創建的定時器與Timer控制項（定時器控制項）效果相同。

函式的用法

1.1 用WM_TIMER來設定定時器
SetTimer函式的原型
UINT_PTR SetTimer(
HWND hWnd, // 視窗句柄
UINT_PTR nIDEvent, // 定時器ID，多個定時器時，可以通過該ID判斷是哪個定時器
UINT nElapse, // 時間間隔,單位為毫秒
TIMERPROC lpTimerFunc // 回調函式
);
返回值:
類型:UINT_PTR
如果函式成功,hWnd參數為0,則返回新建立的時鐘編號,可以把這個時鐘編號傳遞給KillTimer來銷毀時鐘.
如果函式成功,hWnd參數為非0,則返回一個非零的整數,可以把這個非零的整數傳遞給KillTimer來銷毀時鐘.
如果函式失敗,返回值是零.若想獲得更多的錯誤信息,調用GetLastError函式.
例如
SetTimer(m_hWnd,1,1000,NULL); //一個1秒觸發一次的定時器
在MFC程式中SetTimer被封裝在CWnd類中，調用就不用指定視窗句柄了
於是SetTimer函式的原型變為：
UINT SetTimer(UINT nIDEvent,UINT nElapse,void(CALLBACK EXPORT *lpfnTimer)(HWND,UINT ,YINT ,DWORD))
當使用SetTimer函式的時候，就會生成一個定時器，函式中nIDEvent指的是定時器的標識，也就是名字。nElapse指的是時間間隔，也就是每隔多長時間觸發一次事件。第三個參數是一個回調函式，在這個函數裡，放入你想要做的事情的代碼，你可以將它設定為NULL，也就是使用系統默認的回調函式，系統默認的是OnTimer函式。這個函式怎么生成的呢？你需要在需要計時器的類的生成OnTimer函式：在ClassWizard里，選擇需要計時器的類，添加WM_TIMER訊息映射，就自動生成OnTimer函式了。然後在函數裡添加代碼，讓代碼實現功能。每隔一段時間就會自動執行一次。
例：
SetTimer(NULL,1,1000,NULL);
NULL 默認是主進程調用
1:計時器的名稱；
1000：時間間隔，單位是毫秒；
NULL:使用OnTimer函式。
當不需要計時器的時候調用KillTimer(nIDEvent);
例如：KillTimer(1);
1.2 調用回調函式
此方法首先寫一個如下格式的回調函式
void CALLBACK TimerProc(HWND hWnd,UINT nMsg,UINT nTimerid,DWORD dwTime);
然後再用SetTimer(1,100,TimerProc)函式來建一個定時器，第三個參數就是回調函式地址。
二. 或許你會問，如果我要加入兩個或者兩個以上的 timer怎么辦？
繼續用SetTimer函式吧，上次的timer的ID是1，這次可以是2，3，4。。。。
SetTimer(2,1000,NULL);
SetTimer(3,500,NULL);
嗯，WINDOWS會協調他們的。當然OnTimer函式體也要發生變化，要在函式體內添加每一個timer的處理代碼：
OnTimer(nIDEvent)
{
switch(nIDEvent)
{
case 1:........;
break;
case 2:.......;
break;
case 3:......;
break;
}
}
Timer事件，即定時器事件，是在遊戲編程中，經常使用的一個事件。藉助它可以產生定時執行動作的效果。這篇文章，就和大家一起探討一下如何使用SetTimer()函式。
1、SetTimer定義在哪裡？
SetTimer表示的是定義個定時器。根據定義指定的視窗，在指定的視窗（CWnd）中實現OnTimer事件，這樣，就可以相應事件了。
SetTimer有兩個函式。一個是全局的函式::SetTimer()
UINT SetTimer(
HWND hWnd, // handle of window for timer messages
UINT nIDEvent, // timer identifier
UINT uElapse, // time-out value
TIMERPROC lpTimerFunc // address of timer procedure
);
其中hWnd 是指向CWnd的指針，即處理Timer事件的視窗類。說到視窗類（CWnd），我們有必要來看一下CWnd的繼承情況：CWnd有以下子類：CFrameWnd,CDialog,CView,CControlBar等類。這也意味這些類中都可以定義SetTimer事件。
同時，SetTimer（）在CWnd中也有定義，即SetTimer（）是CWnd的一個成員函式。CWnd的子類可以調用該函式，來設定觸發器。
UINT SetTimer( UINT nIDEvent, UINT nElapse, void (CALLBACK EXPORT* lpfnTimer)(HWND, UINT, UINT, DWORD) );
參數含義：
nIDEvent:是指設定這個定時器的iD，即身份標誌，這樣在OnTimer（）事件中，才能根據不同的定時器，來做不同的事件回響。這個ID是一個無符號的整型。
nElapse
是指時間延遲。單位是毫秒。這意味著，每隔nElapse毫秒系統調用一次OnTimer（）。
void (CALLBACK EXPORT* lpfnTimer)(HWND, UINT, UINT, DWORD)
Specifies the address of the application-supplied TimerProc callback function that processes the WM_TIMER messages. If this parameter is NULL, the WM_TIMER messages are placed in the application’s message queue and handled by the CWnd object。
意思是，指定應用程式提供的TimerProc回調函式的地址，來處里這個Timer事件。如果是NULL，處理這個Timer事件的定義這個Timer的CWnd對象。他將WM_TIMER訊息傳遞給這個對象，通過實現這個對象的OnTimer（）事件來處理這個Timer事件。
所以，一般情況下，我們將這個值設為NULL，有設定該定時器的對象中的OnTimer（）函式來處理這個事件。
同樣的，我們再看看KillTimer（）和OnTimer（）的定義:
KillTimer同SetTimer（）一樣，他也有兩個，一個是全局的::KillTimer(),另一個是CWnd的一個函式。他的聲明如下：
//全局函式
BOOL KillTimer(
HWND hWnd, // handle of window that installed timer
UINT uIDEvent // timer identifier
);
//CWnd函式
BOOL KillTimer( int nIDEvent );
這兩個函式表示的意思是將iD為nIDEVENT的定時器移走。使其不再作用。其用法如同SetTimer（）一樣。
再看看OnTimer()
CWnd::OnTimer
afx_msg void OnTimer( UINT nIDEvent );
OnTimer()是回響CWnd對象產生的WM_Timer訊息。nIDEvent表示要回響TIMER事件的ID。
二、Timer事件的使用：
由以上的分析，我們應該很清楚，如何來使用Timer事件。假定我們在視圖上畫一個漸變的動畫。我們首先在選單欄上添加一個選單項，給這個選單添加命令回響：
pView->SetTimer(1,1000,NULL);//pView是視圖類的指針，這裡是在視圖類當中設定一個定時器。
添加完畢，再給視圖類添加一個WM_Timer事件的回響。在OnTimer()函式中編寫函式，進行回響。
Timer的精度：
Timer使用的是時間中斷回響計時，windows的時間中斷每1/18秒觸發一次，所以Timer最低精度約在55ms，低於這個時間則精度不夠。

回調函式

函式聲明
VOID CALLBACK TimerProc(
_In_HWND hwnd,
_In_UINT uMsg,
_In_UINT_PTR idEvent,
_In_DWORD dwTime
);
參數
hwnd [in]
與定時器關聯的視窗句柄。
uMsg [in]
值為WM_TIMER。
idEvent [in]
定時器的ID。
dwTime [in]
值為從啟動系統開始，經歷的時間。單位為毫秒。最大值約為49.7天，若系統連續運行超過49.7天，dwTime的值會回到0重新開始計算。

相關詞條

熱門詞條

聯絡我們