特别说明：完整STemWin的1-60期教程和配套实例下载地址：链接

第36章 窗口管理器之定时器使用

    本期教程跟大家讲一下STemWin自带的定时器使用方法，这个定时器使用起来非常简单，而且很实用。在需要定时更新的时候可以用这个定时器。

    36. 1  定时器功能介绍

    36. 2 桌面窗口上使用定时器实例

    36. 3 对话框上使用定时器实例

    36. 4 总结

36.1 定时器功能介绍

    STemWin中有四个定时器相关的API函数供用户调用。

函数	功能描述
WM_CreateTimer()	创建向窗口发送WM_TIMER消息的定时器
WM_DeleteTimer()	删除定时器
WM_GetTimerId()	获取给定定时器的Id
WM_RestartTimer()	重启定时器

这四个函数都是简单易用，下面通过两个例子跟大家讲解一下定时器的使用。

36.2 桌面窗口上使用定时器实例

    源代码如下（可以将其直接的复制到开发板或者模拟器上面运行）

1. #include <stddef.h>
   
2. #include "GUI.h"
   
3. #include "DIALOG.h"
   
4. 
   
5. #include "WM.h"
   
6. #include "BUTTON.h"
   
7. #include "CHECKBOX.h"
   
8. #include "DROPDOWN.h"
   
9. #include "EDIT.h"
   
10. #include "FRAMEWIN.h"
    
11. #include "LISTBOX.h"
    
12. #include "MULTIEDIT.h"
    
13. #include "RADIO.h"
    
14. #include "SLIDER.h"
    
15. #include "TEXT.h"
    
16. #include "PROGBAR.h"
    
17. #include "SCROLLBAR.h"
    
18. #include "LISTVIEW.h"
    
19. 
    
20. 
    
21. GUI_COLOR _acColor[3] = {GUI_BLUE,GUI_RED,GUI_YELLOW};
    
22. static  char ucBackColor;
    
23. 
    
24. /*********************************************************************
    
25. *
    
26. *       Dialog callback routine
    
27. */
    
28. static void _cbBkWindow(WM_MESSAGE * pMsg)
    
29. {
    
30.     WM_HWIN hWin = pMsg->hWin;
    
31. 
    
32.     switch (pMsg->MsgId)
    
33.     {
    
34. case WM_PAINT:
    
35. ucBackColor++;
    
36. if (ucBackColor == 3)
    
37. {
    
38. ucBackColor = 0;
    
39. }
    
40. GUI_SetBkColor(_acColor[ucBackColor]);
    
41. GUI_Clear();
    
42.             break;
    
43. case WM_TIMER: （1）
    
44. WM_RestartTimer(pMsg->Data.v, 1000);
    
45. WM_InvalidateWindow(hWin);
    
46.             break;
    
47.         default:
    
48.             WM_DefaultProc(pMsg);
    
49.     }
    
50. }
    
51. 
    
52. /*********************************************************************
    
53. *
    
54. *       MainTask
    
55. *
    
56. **********************************************************************
    
57. */
    
58. void MainTask(void)
    
59. {
    
60. WM_HTIMER hTimer;
    
61. 
    
62. GUI_Init();
    
63.     /* 设置桌面窗口回调函数 */
    
64. WM_SetCallback(WM_HBKWIN, _cbBkWindow);
    
65. hTimer = WM_CreateTimer(WM_HBKWIN, 0, 1000, 0);（2）
    
66. while (1)
    
67. {
    
68. GUI_Delay(500);
    
69. }
    
70. }

复制代码

这个Demo主要是实现每隔1000ms改变一下桌面窗口的颜色。

1. 定时器消息，这里要特别注意，如果想要定时器每隔一段时间执行一次，而不是只执行一次，必须得调用WM_RestartTimer()。在这个消息里面将桌面窗口无效进而会执行桌面窗口的重绘消息。

2. 创建定时器函数

     WM_CreateTimer(WM_HBKWIN, //接受信息的窗口的句柄，注意是窗口而不是对话框

                                    0,  //用户定义的Id。如果不对同一窗口使用多个定时器，此值可以设置为零。

                                    1000,  //周期，此周期过后指定窗口应收到消息。

                                     0) //保留，留作将来使用

这个Demo的实际显示效果如下：

36.3 对话框上使用定时器实例

    这个Demo的主要功能是在对话框上面实现一个计数功能。下面是源码（可以将其直接的复制到开发板或者模拟器上面运行）

1. #include <stddef.h>
   
2. #include "stdio.h"
   
3. #include "GUI.h"
   
4. #include "DIALOG.h"
   
5. 
   
6. #include "WM.h"
   
7. #include "BUTTON.h"
   
8. #include "CHECKBOX.h"
   
9. #include "DROPDOWN.h"
   
10. #include "EDIT.h"
    
11. #include "FRAMEWIN.h"
    
12. #include "LISTBOX.h"
    
13. #include "MULTIEDIT.h"
    
14. #include "RADIO.h"
    
15. #include "SLIDER.h"
    
16. #include "TEXT.h"
    
17. #include "PROGBAR.h"
    
18. #include "SCROLLBAR.h"
    
19. #include "LISTVIEW.h"
    
20. 
    
21. static int Count;
    
22. /*********************************************************************
    
23. *
    
24. *       Dialog resource
    
25. *
    
26. * This table conatins the info required to create the dialog.
    
27. * It has been created by ucGUIbuilder.
    
28. */
    
29. 
    
30. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
    
31.     { FRAMEWIN_CreateIndirect,  "armfly",            0,                       0,  0,  800,480,FRAMEWIN_CF_MOVEABLE,0},
    
32.     { BUTTON_CreateIndirect,    "BUTTON0",           GUI_ID_BUTTON0,          82, 122,162,37, 0,0},
    
33.     { BUTTON_CreateIndirect,    "BUTTON1",           GUI_ID_BUTTON1,          357,123,152,35, 0,0},
    
34. { TEXT_CreateIndirect,      "0000",              GUI_ID_TEXT0,            278,264,300,48, 0,0}
    
35. };
    
36. 
    
37. /*****************************************************************
    
38. **      FunctionName:void PaintDialog(WM_MESSAGE * pMsg)
    
39. **      Function: to initialize the Dialog items
    
40. **                                                      
    
41. **      call this function in _cbCallback --> WM_PAINT
    
42. *****************************************************************/
    
43. 
    
44. void PaintDialog(WM_MESSAGE * pMsg)
    
45. {
    
46.     WM_HWIN hWin = pMsg->hWin;
    
47. 
    
48. }
    
49. 
    
50. /*****************************************************************
    
51. **      FunctionName:void InitDialog(WM_MESSAGE * pMsg)
    
52. **      Function: to initialize the Dialog items
    
53. **                                                      
    
54. **      call this function in _cbCallback --> WM_INIT_DIALOG
    
55. *****************************************************************/
    
56. 
    
57. void InitDialog(WM_MESSAGE * pMsg)
    
58. {
    
59.     WM_HWIN hWin = pMsg->hWin;
    
60.     //
    
61.     //FRAMEWIN
    
62.     //
    
63.     FRAMEWIN_SetFont(hWin,&GUI_Font24B_ASCII);
    
64.     FRAMEWIN_SetTextAlign(hWin,GUI_TA_VCENTER|GUI_TA_CENTER);
    
65.     FRAMEWIN_AddCloseButton(hWin, FRAMEWIN_BUTTON_RIGHT, 0);
    
66.     FRAMEWIN_AddMaxButton(hWin, FRAMEWIN_BUTTON_RIGHT, 1);
    
67.     FRAMEWIN_AddMinButton(hWin, FRAMEWIN_BUTTON_RIGHT, 2);
    
68.     FRAMEWIN_SetTitleHeight(hWin,30);
    
69. 
    
70. //
    
71.     //GUI_ID_TEXT0
    
72.     //
    
73.     TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0),&GUI_FontD36x48);
    
74. 
    
75. }
    
76. 
    
77. /*********************************************************************
    
78. *
    
79. *       Dialog callback routine
    
80. */
    
81. static void _cbCallback(WM_MESSAGE * pMsg)
    
82. {
    
83.     int NCode, Id;
    
84. char buf[10];
    
85.     WM_HWIN hWin = pMsg->hWin;
    
86. 
    
87.     switch (pMsg->MsgId)
    
88.     {
    
89. case WM_TIMER:（1）
    
90.             Count++;
    
91. sprintf(buf, "%04d", Count);
    
92. TEXT_SetText(WM_GetDialogItem(hWin,GUI_ID_TEXT0), (const char *)buf);
    
93. WM_RestartTimer(pMsg->Data.v, 100);
    
94.             break;
    
95. case WM_PAINT:
    
96.             PaintDialog(pMsg);
    
97.             break;
    
98.         case WM_INIT_DIALOG:
    
99.             InitDialog(pMsg);
    
100.             break;
     
101.         case WM_KEY:
     
102.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
     
103.             {
     
104.                 case GUI_KEY_ESCAPE:
     
105.                     GUI_EndDialog(hWin, 1);
     
106.                     break;
     
107.                 case GUI_KEY_ENTER:
     
108.                     GUI_EndDialog(hWin, 0);
     
109.                     break;
     
110.             }
     
111.             break;
     
112.         case WM_NOTIFY_PARENT:
     
113.             Id = WM_GetId(pMsg->hWinSrc);
     
114.             NCode = pMsg->Data.v;        
     
115.             switch (Id)
     
116.             {
     
117.                 case GUI_ID_OK:
     
118.                     if(NCode==WM_NOTIFICATION_RELEASED)
     
119.                         GUI_EndDialog(hWin, 0);
     
120.                     break;
     
121.                 case GUI_ID_CANCEL:
     
122.                     if(NCode==WM_NOTIFICATION_RELEASED)
     
123.                         GUI_EndDialog(hWin, 0);
     
124.                     break;
     
125.                 case GUI_ID_BUTTON0:
     
126.                     switch(NCode)
     
127.                     {
     
128.                         case WM_NOTIFICATION_CLICKED:
     
129.                             break;
     
130.                         case WM_NOTIFICATION_RELEASED:
     
131. 
     
132.                             break;
     
133.                         case WM_NOTIFICATION_MOVED_OUT:
     
134. 
     
135.                             break;
     
136.                     }
     
137.                     break;
     
138.                 case GUI_ID_BUTTON1:
     
139.                     switch(NCode)
     
140.                     {
     
141.                         case WM_NOTIFICATION_CLICKED:
     
142. 
     
143.                             break;
     
144.                         case WM_NOTIFICATION_RELEASED:
     
145. 
     
146.                             break;
     
147.                         case WM_NOTIFICATION_MOVED_OUT:
     
148. 
     
149.                             break;
     
150.                     }
     
151.                     break;
     
152. 
     
153.             }
     
154.             break;
     
155.         default:
     
156.             WM_DefaultProc(pMsg);
     
157.     }
     
158. }
     
159. 
     
160. /*********************************************************************
     
161. *
     
162. *       MainTask
     
163. *
     
164. **********************************************************************
     
165. */
     
166. void MainTask(void)
     
167. {
     
168.     WM_HWIN hDlg;
     
169. WM_HTIMER hTimer;
     
170. Count = 0;
     
171. /*
     
172.    使能窗口使用内存设备，这样可以有效避免闪烁 放在GUI_Init前面就包括桌面
     
173.    窗口，如果放在后面就不包括桌面窗口。
     
174. */
     
175. WM_SetCreateFlags(WM_CF_MEMDEV);  
     
176. GUI_Init();
     
177. WM_SetDesktopColor(GUI_BLUE);      /* Automacally update desktop window */
     
178. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     
179. FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
     
180. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     
181. BUTTON_SetDefaultSkin(BUTTON_SKIN_FLEX);
     
182. CHECKBOX_SetDefaultSkin(CHECKBOX_SKIN_FLEX);
     
183. DROPDOWN_SetDefaultSkin(DROPDOWN_SKIN_FLEX);
     
184. SCROLLBAR_SetDefaultSkin(SCROLLBAR_SKIN_FLEX);
     
185. SLIDER_SetDefaultSkin(SLIDER_SKIN_FLEX);
     
186. HEADER_SetDefaultSkin(HEADER_SKIN_FLEX);
     
187. RADIO_SetDefaultSkin(RADIO_SKIN_FLEX);
     
188. ///* 创建一个对话框 */
     
189.     hDlg = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
     
190. hTimer = WM_CreateTimer(WM_GetClientWindow(hDlg), 0, 100, 0);（2）
     
191. while (1)
     
192. {
     
193. GUI_Delay(500);
     
194. }
     
195. }

复制代码

1. 定时器消息，在定时器消息中实现文件控件计数值的更新。

2. 给对话框创建一个定时器，特别注意这里需要获取对话框中窗口的句柄才可以使用。

这个例子的实际显示效果如下（分辨率800*480）：

36.4 总结

    大家学完本期教程后，可以考虑在实际项目中使用这个功能，很实用。

谢谢分享

好资料啊，收藏一下