SetTimer

SetTimer

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

簡介

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重新開始計算。

相關詞條

相關搜尋

熱門詞條

聯絡我們