Windows API 使用 SetTimer 定时器来持续画图

在Windows API中，SetTimer 函数用于在指定的窗口上设置一个定时器。当定时器到期时，窗口会收到一个WM_TIMER消息。以下是SetTimer函数的详细解释和用法：

函数原型

UINT_PTR SetTimer(
  HWND       hWnd,             // 窗口句柄
  UINT_PTR   nIDEvent,         // 定时器标识符
  UINT       uElapse,          // 定时器的时间间隔（毫秒）
  TIMERPROC  lpTimerFunc       // 定时器回调函数（可选）
);

参数

• hWnd：接收WM_TIMER消息的窗口句柄。如果此参数为NULL，则lpTimerFunc必须是一个有效的回调函数地址，并且WM_TIMER消息将被发送到调用线程的消息队列中，而不是发送到特定的窗口。
• nIDEvent：定时器的标识符。如果此参数设置为0，系统将为定时器提供一个唯一的标识符。
• uElapse：定时器的时间间隔（以毫秒为单位）。当经过指定的时间间隔后，定时器到期，并发送WM_TIMER消息。
• lpTimerFunc：一个指向回调函数的指针，当定时器到期时，该函数将被调用。此参数是可选的，如果为NULL，则当定时器到期时，将发送WM_TIMER消息到指定的窗口。

返回值

如果函数成功，返回值是定时器的标识符。如果函数失败，返回值是0。要获取扩展的错误信息，请调用GetLastError。

示例

下面是一个简单的示例，展示了如何在Windows应用程序中使用SetTimer：

#include <windows.h>

LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
    switch (uMsg)
    {
    case WM_TIMER:
        // 定时器到期时执行的代码
        // wParam 包含定时器的标识符
        // 在这里，你可以更新UI、执行某些操作等
        break;

    case WM_DESTROY:
        // 销毁窗口时，取消定时器
        KillTimer(hwnd, 1); // 假设定时器的标识符是1
        PostQuitMessage(0);
        break;

    default:
        return DefWindowProc(hwnd, uMsg, wParam, lParam);
    }
    return 0;
}

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, PSTR szCmdLine, int iCmdShow)
{
    // ... 创建窗口等代码 ...

    // 设置一个定时器，每1000毫秒（1秒）到期一次
    SetTimer(hwnd, 1, 1000, NULL);

    // ... 消息循环等代码 ...

    return 0;
}

注意事项

• 当不再需要定时器时，应使用KillTimer函数来取消它，以避免不必要的资源消耗。
• 如果hWnd参数为NULL，并且lpTimerFunc不为NULL，则WM_TIMER消息将被发送到调用线程的消息队列中，而不是发送到特定的窗口。在这种情况下，你需要使用GetMessage或PeekMessage等函数来检索这些消息。
• 定时器精度取决于系统时钟的分辨率，因此不应用于需要高精度计时的场景。如果需要高精度计时，请考虑使用其他方法，如QueryPerformanceCounter。

---

举例

在Windows编程中，SetTimer函数用于设置一个定时器，该定时器在指定的时间间隔后触发一个WM_TIMER消息到指定的窗口。TIMERPROC是一个回调函数类型，但通常用于SetTimer的异步版本SetWaitableTimer，而不是SetTimer。然而，对于SetTimer，你不需要提供TIMERPROC类型的回调函数，因为SetTimer是通过发送WM_TIMER消息来通知你的窗口的。

以下是使用SetTimer的基本步骤：

1. 在你的窗口的WM_CREATE消息处理程序中设置定时器。
2. 在你的窗口的WM_TIMER消息处理程序中处理定时器事件。
3. （可选）在你的窗口的WM_DESTROY或适当的消息处理程序中删除定时器。

下面是一个简单的示例代码：

#include <windows.h>

// 定时器ID（可以是任何非零值）
#define TIMER_ID 1

// 窗口过程函数
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
    switch (uMsg)
    {
    case WM_CREATE:
        // 设置一个定时器，每1000毫秒（1秒）触发一次
        SetTimer(hwnd, TIMER_ID, 1000, NULL);
        break;

    case WM_TIMER:
        // 检查是否是我们的定时器触发的消息
        if (wParam == TIMER_ID)
        {
            // 在这里处理定时器事件，比如重绘窗口的部分内容
            // ...

            // （可选）如果不再需要定时器，可以调用KillTimer来删除它
        }
        break;

    case WM_DESTROY:
        // 销毁窗口时删除定时器
        KillTimer(hwnd, TIMER_ID);
        PostQuitMessage(0);
        break;

    default:
        return DefWindowProc(hwnd, uMsg, wParam, lParam);
    }
    return 0;
}

// WinMain函数（这里只给出了框架）
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow)
{
    // ... 窗口类注册、窗口创建等代码 ...

    // 进入消息循环
    MSG msg;
    while (GetMessage(&msg, NULL, 0, 0))
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
    return msg.wParam;
}

在这个示例中，我们在窗口创建时设置了一个定时器，该定时器每1秒触发一次WM_TIMER消息。在WM_TIMER消息处理程序中，我们检查是否是我们的定时器触发的消息，并执行相应的操作（在这个例子中，我们只是注释了这部分，但你可以添加你自己的代码来重绘窗口的部分内容或执行其他任务）。当窗口销毁时，我们删除定时器以防止内存泄漏。