相关函数 / 参数 / 类型
- SetTimer
- KillTimer
- WM_TIMER
- TIMERPROC
SetTimer
SetTimer 函数用于创建一个具有指定超时时间的定时器。
- API 函数原型:
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 参数的值 |
返回值:
-
如果函数调用成功,并且 hWnd 参数为 NULL,则返回值为标识新定时器的整型值。应用程序可以传递该值给 KillTimer 函数来销毁该定时器;
-
如果函数调用成功,并且 hWnd 参数不为 NULL,则返回值为非零的整型值,应用程序可以传递 nIDEvent 参数的值给 KillTimer 函数来销毁该定时器;
-
如果函数创建定时器失败,则返回值为 0;
获取有关错误的更多信息,请调用 GetLastError 函数。
备注:
-
应用程序可以通过在窗口过程中包含 WM_TIMER case 语句,或者在创建定时器时指定 TimerProc 回调函数来处理 WM_TIMER 消息。在你指定了一个 TimerProc 回调函数之后,当窗口处理 WM_TIMER 消息时,默认的窗口过程便会调用该回调函数。因此,你需要在调用线程中分派该消息,甚至在你使用 TimerProc 而不是在窗口过程中处理 WM_TIMER 消息时。
-
WM_TIMER 消息的 wParam 参数包含 nIDEvent 参数的值。
-
定时器标志符,nIDEvent,是与窗口相关联的。不同的窗口能有相同的定时器标识符。这些定时器是不同的。
-
SetTimer 函数在 hWnd 参数的值为 NULL 的情况下能够重复使用定时器标识符。
-
WM_TIMER消息是低优先级消息。 仅当线程的消息队列中没有其他高优先级消息时,GetMessage 和 PeekMessage 函数才帖子此消息。
WM_TIMER 消息
在WM_TIMER
消息内,然后根据每个计时器的ID,写想要的功能
LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
HDC hdc;
PAINTSTRUCT ps;
RECT rect;
static size_t cxClient, cyClient;
HGDIOBJ hBrush, hOldBrush;
switch (message)
{
case WM_CREATE:
SetTimer(hwnd, ID_TIMER_1, 1000, NULL);
return 0;
case WM_TIMER:
switch (wParam)
{
case ID_TIMER_1:
hBrush = CreateSolidBrush(RGB(rand() % 256, rand() % 256, rand() % 256));
SetClassLongPtr(hwnd, GCLP_HBRBACKGROUND, (LONG_PTR)hBrush);
InvalidateRect(hwnd, NULL, TRUE);
break;
default:
break;
}
case WM_SIZE:
GetClientRect(hwnd, &rect);
cxClient = LOWORD(lParam);
cyClient = HIWORD(lParam);
return 0;
case WM_PAINT:
hdc = BeginPaint(hwnd, &ps);
GetClientRect(hwnd, &rect);
EndPaint(hwnd, &ps);
return 0;
case WM_DESTROY:
KillTimer(hwnd, ID_TIMER_1);
PostQuitMessage(0);
return 0;
}
return DefWindowProc(hwnd, message, wParam, lParam);
}
回调函数
#pragma comment(lib, "User32.lib")
#pragma comment(lib, "kernel32.lib")
#pragma comment(lib, "Gdi32.lib")
#include <windows.h>
#include <cmath>
#define ID_TIMER_1 1
LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
VOID CALLBACK CALLBACK_ID_TIMER_1(HWND, UINT, UINT_PTR, DWORD);
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, PSTR szCmdLine, int iCmdShow)
{
static TCHAR szAppName[] = TEXT("NueXini");
HWND hWnd;
MSG msg;
WNDCLASS wndclass;
wndclass.style = CS_HREDRAW | CS_VREDRAW;
wndclass.lpfnWndProc = WndProc;
wndclass.cbClsExtra = 0;
wndclass.cbWndExtra = 0;
wndclass.hInstance = hInstance;
wndclass.hIcon = LoadIcon(NULL, IDI_APPLICATION);
wndclass.hCursor = LoadCursor(NULL, IDC_ARROW);
wndclass.hbrBackground = (HBRUSH)GetStockObject(WHITE_BRUSH);
wndclass.lpszMenuName = NULL;
wndclass.lpszClassName = szAppName;
if (!RegisterClass(&wndclass))
{
MessageBox(NULL, TEXT("Error"), szAppName, MB_ICONERROR | MB_OK);
return 0;
}
hWnd = CreateWindow(
szAppName,
szAppName,
WS_OVERLAPPEDWINDOW,
CW_USEDEFAULT,
CW_USEDEFAULT,
CW_USEDEFAULT,
CW_USEDEFAULT,
NULL,
NULL,
hInstance,
NULL);
ShowWindow(hWnd, iCmdShow);
UpdateWindow(hWnd);
while (GetMessage(&msg, NULL, 0, 0))
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
return msg.wParam;
}
LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
HDC hdc;
PAINTSTRUCT ps;
RECT rect;
static size_t cxClient, cyClient;
HGDIOBJ hBrush, hOldBrush;
switch (message)
{
case WM_CREATE:
SetTimer(hwnd, ID_TIMER_1, 1000, CALLBACK_ID_TIMER_1);
return 0;
case WM_TIMER:
switch (wParam)
{
case ID_TIMER_1:
break;
default:
break;
}
case WM_SIZE:
GetClientRect(hwnd, &rect);
cxClient = LOWORD(lParam);
cyClient = HIWORD(lParam);
return 0;
case WM_PAINT:
hdc = BeginPaint(hwnd, &ps);
GetClientRect(hwnd, &rect);
EndPaint(hwnd, &ps);
return 0;
case WM_DESTROY:
KillTimer(hwnd, ID_TIMER_1);
PostQuitMessage(0);
return 0;
}
return DefWindowProc(hwnd, message, wParam, lParam);
}
VOID CALLBACK CALLBACK_ID_TIMER_1(HWND hwnd, UINT message, UINT_PTR iTimerID, DWORD dwTime)
{
SetClassLongPtr(hwnd, GCLP_HBRBACKGROUND, (LONG_PTR)CreateSolidBrush(RGB(rand() % 256, rand() % 256, rand() % 256)));
InvalidateRect(hwnd, NULL, TRUE);
}
总结
设置一个计时器, 实现功能有两个方法
方法一,在WM_TIMER
中写对应功能
方法二,在回调函数
中写对应功能
enjoy it ~