【STemWin教程】第36章 窗口管理器之定时器使用

席萌0209

特别说明：完整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"
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"
21. GUI_COLOR _acColor[3] = {GUI_BLUE,GUI_RED,GUI_YELLOW};
22. static  char ucBackColor;
24. /*********************************************************************
25. *
26. *       Dialog callback routine
27. */
28. static void _cbBkWindow(WM_MESSAGE * pMsg)
29. {
30.     WM_HWIN hWin = pMsg->hWin;
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. }
52. /*********************************************************************
53. *
54. *       MainTask
55. *
56. **********************************************************************
57. */
58. void MainTask(void)
59. {
60. WM_HTIMER hTimer;
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"
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"
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. */
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. };
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. *****************************************************************/
44. void PaintDialog(WM_MESSAGE * pMsg)
45. {
46.     WM_HWIN hWin = pMsg->hWin;
48. }
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. *****************************************************************/
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);
70. //
71.     //GUI_ID_TEXT0
72.     //
73.     TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0),&GUI_FontD36x48);
75. }
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;
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:
132.                             break;
133.                         case WM_NOTIFICATION_MOVED_OUT:
135.                             break;
136.                     }
137.                     break;
138.                 case GUI_ID_BUTTON1:
139.                     switch(NCode)
140.                     {
141.                         case WM_NOTIFICATION_CLICKED:
143.                             break;
144.                         case WM_NOTIFICATION_RELEASED:
146.                             break;
147.                         case WM_NOTIFICATION_MOVED_OUT:
149.                             break;
150.                     }
151.                     break;
153.             }
154.             break;
155.         default:
156.             WM_DefaultProc(pMsg);
157.     }
158. }
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 总结
    大家学完本期教程后，可以考虑在实际项目中使用这个功能，很实用。

zhangww

[s:152]