MiniGUI

定时器回调函数原型

typedef BOOL (* TIMERPROC)(HWND, int, DWORD);

第1个参数：窗口句柄；

第2个参数：定时器ID；

第3个参数：定时器被触发时的系统滴答值；

当TIMERPROC返回值为FALSE时，自动删除该定时器，该功能用于创建单次(one-shot)定时器

 

设置定时器，可以设置定时器回调函数

BOOL GUIAPI SetTimerEx (HWND hWnd, int id, unsigned int speed, TIMERPROC timer_proc); 

重置定时器的间隔，可以设置定时器回调函数

BOOL GUIAPI ResetTimerEx (HWND hWnd, int id, unsigned int speed, TIMERPROC timer_proc); 

 

#define SetTimer(hwnd, id, speed)    SetTimerEx(hwnd, id, speed, NULL) 

#define ResetTimer(hwnd, id, speed)     ResetTimerEx(hwnd, id, speed, (TIMERPROC)0xFFFFFFFF)

 

默认以 10 毫秒为单位，speed取值 100 即 1 秒

当定时器到期时，定时器指定窗口会收到一个MSG_TIMER消息

 

删除定时器

BOOL GUIAPI KillTimerEx (HWND hWnd, int id); 

 

检查某个定时器是否被安装到指定窗口

BOOL GUIAPI IsTimerInstalled (HWND hWnd, int id);

 

检查系统是否还有可用定时器资源

BOOL GUIAPI HaveFreeTimer (void);

 

获取自MiniGUI启动到现在的滴答值

unsigned int GUIAPI GetTickCount (void);

 

限制：

1. MiniGUI-Threads模式下，每个消息队列最多能管理 32个定时器，每个线程对应一个消息队列，每个应用程序最多也只能设置 32 个定时器；

2. MiniGUI-Processes 模式下，每个进程只有一个消息队列，这个消息队列最多可以管理 32 个定时器；

3. 当一个MSG_TIMER消息尚未处理而新的消息到来，则忽略新消息；

4. 定时器消息是优先级最低的消息类型，只有消息队列中不存在其它类型的消息（比如邮寄消息、通知消息、退出消 息、绘图消息）时，系统才会去检查是否有定时器到期

5. MiniGUI-Processes 的服务器进程，即 mginit 程序已经调用 setitimer 系统调用安装了定时器， 应用程序自己实现的 mginit 程序不应该再使用 setitimer 实现自己的定时器，但MiniGUI-Processes 的客户程序仍可以调用 setitimer 函数，MiniGUI-Threads 则没有这样的限制；

 

定时器示例

#include <stdio.h>
#include <time.h>

#include <minigui/common.h>
#include <minigui/minigui.h>
#include <minigui/gdi.h>
#include <minigui/window.h>
#include <minigui/control.h>

#define _ID_TIMER 100
#define _ID_TIME_STATIC 101

static char* mk_time (char* buff)
{
    time_t t;
    struct tm * tm;

    time (&t);
    tm = localtime (&t);
    sprintf (buff, "%02d:%02d:%02d", tm->tm_hour, tm->tm_min, tm->tm_sec);
    
    return buff;
}

static int TimerDemoProc(HWND  hWnd, int message, WPARAM wParam, LPARAM lParam)
{
    char buff [20];
    
    switch (message)
    {
        case MSG_CREATE:
        {
            CreateWindow (CTRL_STATIC, mk_time (buff), 
                WS_CHILD | WS_BORDER | WS_VISIBLE | SS_CENTER,
                _ID_TIME_STATIC, 
                50, 50,
                100, 20, 
                hWnd, 0);

            SetTimer (hWnd, _ID_TIMER, 100);
            break;
        }
        case MSG_TIMER:
        { 
            if(wParam == _ID_TIMER)
            {
                SetDlgItemText (hWnd, _ID_TIME_STATIC, mk_time (buff));
            }

            break;
        }
        case MSG_CLOSE: 
        {
            KillTimer (hWnd, _ID_TIMER);
            DestroyAllControls (hWnd);
            DestroyMainWindow (hWnd);
            PostQuitMessage (hWnd);
            return 0;
        }
    }
    
    return DefaultMainWinProc(hWnd,message,wParam,lParam);
}

int MiniGUIMain(int argc, const char* argv[])
{
    MSG msg;
    MAINWINCREATE CreateInfo;
    HWND hMainWnd;
    
#ifdef _MGRM_PROCESSES
    JoinLayer(NAME_DEF_LAYER , "main" , 0 , 0);
#endif

    CreateInfo.dwStyle = WS_VISIBLE | WS_BORDER | WS_CAPTION;
    CreateInfo.dwExStyle = WS_EX_NONE;
    CreateInfo.spCaption = "Timer Demo";
    CreateInfo.hMenu = 0;
    CreateInfo.hCursor = GetSystemCursor(0);
    CreateInfo.hIcon = 0;
    CreateInfo.MainWindowProc = TimerDemoProc;
    CreateInfo.lx = 0;
    CreateInfo.ty = 0;
    CreateInfo.rx = g_rcScr.right / 2;
    CreateInfo.by = g_rcScr.bottom / 2;
    CreateInfo.iBkColor = COLOR_lightwhite;
    CreateInfo.dwAddData = 0;
    CreateInfo.hHosting = HWND_DESKTOP;
    
    hMainWnd = CreateMainWindow(&CreateInfo);
    if (hMainWnd == HWND_INVALID)
        return -1;
    
    ShowWindow(hMainWnd, SW_SHOWNORMAL);
    
    while (GetMessage(&msg,hMainWnd)) 
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
    
    MainWindowThreadCleanup(hMainWnd);
    
    return 0;
}

#ifndef _MGRM_PROCESSES
#include <minigui/dti.c>
#endif