特别说明：完整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>
   1 K( {# t2 w) J4 `; V$ ?0 g& {
2. #include "GUI.h"
   8 x) ]6 d5 T' G6 x: O! G
3. #include "DIALOG.h"
   
4. 
   
5. #include "WM.h"
   
6. #include "BUTTON.h"
   6 _1 l# x: x: i' D( A" s
7. #include "CHECKBOX.h"
   9 w/ [! y* L+ H; l5 E
8. #include "DROPDOWN.h"
   % r. i/ ]) x( b5 x) D
9. #include "EDIT.h"
   * a4 v: X3 I# E! t/ N) o- F
10. #include "FRAMEWIN.h"
    6 |0 w1 s; a2 `! T1 Q/ Y
11. #include "LISTBOX.h"
    
12. #include "MULTIEDIT.h"
    1 @2 h  k9 j4 ~6 T$ k4 m, R( v( i
13. #include "RADIO.h"
    ! f5 _% R2 `$ j0 u3 q
14. #include "SLIDER.h"
    
15. #include "TEXT.h"
    
16. #include "PROGBAR.h"
    . D8 U  p/ p/ _& k% n; a
17. #include "SCROLLBAR.h"
    / \4 M  J% Y: h$ L8 e
18. #include "LISTVIEW.h"
    
19. 
    
20. 
    
21. GUI_COLOR _acColor[3] = {GUI_BLUE,GUI_RED,GUI_YELLOW};
    % `: ~" v4 Z& }* t  u: [1 O# u
22. static  char ucBackColor;
    
23. 
    
24. /*********************************************************************
    
25. *
    
26. *       Dialog callback routine
    
27. */
    
28. static void _cbBkWindow(WM_MESSAGE * pMsg)
    
29. {
    2 v  D# l# v( Y; a& L
30.     WM_HWIN hWin = pMsg->hWin;
    
31. 
    
32.     switch (pMsg->MsgId)
    - c6 N' N7 o; h4 x) G/ p: g' `
33.     {
    5 z3 {8 B: q3 i' |2 l
34. case WM_PAINT:
    
35. ucBackColor++;
    0 K' h/ U& z) k5 j" [
36. if (ucBackColor == 3)
    4 s3 w4 K) n7 p) F1 x
37. {
    
38. ucBackColor = 0;
    
39. }
    3 t1 _" v8 @, q# @( l
40. GUI_SetBkColor(_acColor[ucBackColor]);
    ( D( B# W6 ~2 E* z, I
41. GUI_Clear();
    0 ?" ^9 @( H; i
42.             break;
    
43. case WM_TIMER: （1）
    
44. WM_RestartTimer(pMsg->Data.v, 1000);
    
45. WM_InvalidateWindow(hWin);
    
46.             break;
    . M& w8 a; O5 V* i6 W# o) u
47.         default:
    " H* v6 n; M$ e# |! P: d
48.             WM_DefaultProc(pMsg);
    ) J* V: ~" J( m
49.     }
    
50. }
    8 i6 [& w% M3 S& n, a+ t9 z
51. 
    6 u+ u# W) o) T' ?9 r" ?/ u
52. /*********************************************************************
    " T, N# {8 O5 ^% h1 A' {
53. *
    : ^+ l+ e% D+ l! b1 z
54. *       MainTask
    
55. *
    . Y7 A+ G$ r+ d0 _. `7 W% ]
56. **********************************************************************
    
57. */
    
58. void MainTask(void)
    
59. {
    % o! c$ y; R* y! t* A
60. WM_HTIMER hTimer;
    
61. 
    ; B# |2 z& a0 b8 u, k0 I
62. GUI_Init();
    
63.     /* 设置桌面窗口回调函数 */
    
64. WM_SetCallback(WM_HBKWIN, _cbBkWindow);
    
65. hTimer = WM_CreateTimer(WM_HBKWIN, 0, 1000, 0);（2）
    ; D. U& F; r" b0 ^  w2 V/ Z* g
66. while (1)
    - k4 `3 y4 X# O) Z) `
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"
   , L; H& H$ l1 z  Q
3. #include "GUI.h"
   : i1 y7 q" _$ x! A9 b/ K
4. #include "DIALOG.h"
   
5. 
   
6. #include "WM.h"
   0 d. L( n: y" j* _4 j1 b. ~
7. #include "BUTTON.h"
   
8. #include "CHECKBOX.h"
   5 l8 I2 W7 ?1 L" L9 W6 y8 u+ z
9. #include "DROPDOWN.h"
   # P2 U% c. t& n: B1 `9 P5 Q
10. #include "EDIT.h"
    1 n' U5 P: w; d
11. #include "FRAMEWIN.h"
    ; R7 }+ O4 m! `4 _) c+ z5 ^, H
12. #include "LISTBOX.h"
    
13. #include "MULTIEDIT.h"
    # r  n5 t6 o" h: x& ^. [3 o
14. #include "RADIO.h"
    
15. #include "SLIDER.h"
    
16. #include "TEXT.h"
    # V7 _, {' p& {8 @% {" K
17. #include "PROGBAR.h"
    7 [) M0 w  i4 r0 f
18. #include "SCROLLBAR.h"
    ( _# e9 U' Q( n% G0 @
19. #include "LISTVIEW.h"
    
20. 
    
21. static int Count;
    
22. /*********************************************************************
    
23. *
    
24. *       Dialog resource
    
25. *
    : H( S2 e! A7 \" v' e
26. * This table conatins the info required to create the dialog.
    # @+ n; k: M. S* k- \
27. * It has been created by ucGUIbuilder.
    2 r9 R3 X2 j5 `3 Z6 ^, |- h$ A! h
28. */
    
29. 
    
30. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
    : O2 G# t, n- c7 L. M
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},
    - ?) L1 @0 i+ Q
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}
    ( W4 P' I* c4 g2 j5 a4 X
35. };
    
36. 
    4 f) ]& E2 b' L
37. /*****************************************************************
    $ H. x6 x! I5 f) D4 E, C& V
38. **      FunctionName:void PaintDialog(WM_MESSAGE * pMsg)
    
39. **      Function: to initialize the Dialog items
    
40. **                                                      
    
41. **      call this function in _cbCallback --> WM_PAINT
    1 h* N) J) x8 ~
42. *****************************************************************/
    ) l3 W$ d# a, S
43. 
    , U; X. W: S) m' p0 f' E
44. void PaintDialog(WM_MESSAGE * pMsg)
    
45. {
    ; K" H; N8 Q7 {: g
46.     WM_HWIN hWin = pMsg->hWin;
    
47. 
    1 n; i) P2 x: t* ^
48. }
    
49. 
    
50. /*****************************************************************
    
51. **      FunctionName:void InitDialog(WM_MESSAGE * pMsg)
    6 \1 D, D6 o& _: z/ z1 l0 l8 ^
52. **      Function: to initialize the Dialog items
    
53. **                                                      
    
54. **      call this function in _cbCallback --> WM_INIT_DIALOG
    - \- S" @" j) S& k
55. *****************************************************************/
    
56. 
    - w, |! a" _7 _4 I
57. void InitDialog(WM_MESSAGE * pMsg)
    
58. {
    
59.     WM_HWIN hWin = pMsg->hWin;
    
60.     //
    . e' P% k) j" ]8 N3 \$ b
61.     //FRAMEWIN
    ( E1 s4 {0 @" c) ?& M
62.     //
      s' J0 ~1 P' J
63.     FRAMEWIN_SetFont(hWin,&GUI_Font24B_ASCII);
      b" p/ Q+ K1 L% K5 h& k
64.     FRAMEWIN_SetTextAlign(hWin,GUI_TA_VCENTER|GUI_TA_CENTER);
    % H& f% M: B% D( S: n
65.     FRAMEWIN_AddCloseButton(hWin, FRAMEWIN_BUTTON_RIGHT, 0);
    ) p; G9 u9 k( R( }0 s
66.     FRAMEWIN_AddMaxButton(hWin, FRAMEWIN_BUTTON_RIGHT, 1);
    3 P# e( p3 M  x7 p3 m
67.     FRAMEWIN_AddMinButton(hWin, FRAMEWIN_BUTTON_RIGHT, 2);
    7 a5 z% R+ T5 @$ t1 V& j8 r1 o
68.     FRAMEWIN_SetTitleHeight(hWin,30);
    
69. 
    
70. //
    , V& X1 K, J) j# c+ W8 b) Z& J
71.     //GUI_ID_TEXT0
      _; m* M# Z6 @9 m; ~5 i  ?
72.     //
    
73.     TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0),&GUI_FontD36x48);
    
74. 
    
75. }
    
76. 
    
77. /*********************************************************************
    2 i4 X) E/ ~; j7 ?5 j6 V
78. *
      {# t  ~  _0 f" r  }' _( r
79. *       Dialog callback routine
    1 K* S) ?2 a; @: m( C* S4 b" T
80. */
    . t5 E* t$ o! v, F1 W& T9 o2 B& u
81. static void _cbCallback(WM_MESSAGE * pMsg)
    7 R- o0 E$ M4 ?
82. {
    9 |4 p4 q( ]% l9 C; L  c/ @
83.     int NCode, Id;
    
84. char buf[10];
    
85.     WM_HWIN hWin = pMsg->hWin;
    
86. 
    
87.     switch (pMsg->MsgId)
    ( I& r+ }! ~9 p: c" ]8 D
88.     {
    & l- Z8 e8 T+ R2 A, I
89. case WM_TIMER:（1）
    
90.             Count++;
    
91. sprintf(buf, "%04d", Count);
    - J* Q; \+ V+ g0 ^8 o! T: g
92. TEXT_SetText(WM_GetDialogItem(hWin,GUI_ID_TEXT0), (const char *)buf);
    # L: v# F! \9 K* n# C+ I6 X
93. WM_RestartTimer(pMsg->Data.v, 100);
    8 X3 K* k. ^9 Y( a3 ^  h2 g  D4 _
94.             break;
    7 R4 y0 R2 }& Y& S/ ?7 f9 G
95. case WM_PAINT:
    
96.             PaintDialog(pMsg);
    
97.             break;
    % i1 n6 b6 ^2 ?! ]& u8 O- P
98.         case WM_INIT_DIALOG:
    
99.             InitDialog(pMsg);
    
100.             break;
     0 x6 F1 u' e6 f% y3 Z
101.         case WM_KEY:
     
102.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
     
103.             {
     
104.                 case GUI_KEY_ESCAPE:
     : C; N) O& p) R. |
105.                     GUI_EndDialog(hWin, 1);
     
106.                     break;
     , I! ~7 Y. |% |" T8 ~+ }+ W
107.                 case GUI_KEY_ENTER:
     
108.                     GUI_EndDialog(hWin, 0);
     
109.                     break;
     . ?7 h9 W! z& G% ]: w% p
110.             }
     * a. p4 P* S3 t. A$ f$ a' Y7 X
111.             break;
     " }0 ?' V) P; j% F
112.         case WM_NOTIFY_PARENT:
     
113.             Id = WM_GetId(pMsg->hWinSrc);
     : \) {  N+ I! Q) [& P  M( C8 R
114.             NCode = pMsg->Data.v;        
     + F4 t3 b2 m4 `  ]0 |5 {% v0 u
115.             switch (Id)
       Z, g6 d; }6 i& T( T+ J
116.             {
     
117.                 case GUI_ID_OK:
     
118.                     if(NCode==WM_NOTIFICATION_RELEASED)
     
119.                         GUI_EndDialog(hWin, 0);
     " K- S0 l4 h! s  p% i
120.                     break;
     
121.                 case GUI_ID_CANCEL:
     ! u; U" l2 c8 |; O% i# u9 b
122.                     if(NCode==WM_NOTIFICATION_RELEASED)
     
123.                         GUI_EndDialog(hWin, 0);
     & W; t3 \& F9 L# u9 O
124.                     break;
     
125.                 case GUI_ID_BUTTON0:
     ( v! G9 M, x0 v4 L: v8 H
126.                     switch(NCode)
     " b' t; u8 p. b2 q; w0 G  T
127.                     {
     8 `' M: }/ o3 @7 h! \0 ]& U" F
128.                         case WM_NOTIFICATION_CLICKED:
     3 d- A; Y5 y6 r7 |
129.                             break;
     
130.                         case WM_NOTIFICATION_RELEASED:
     
131. 
     
132.                             break;
     
133.                         case WM_NOTIFICATION_MOVED_OUT:
     
134. 
     
135.                             break;
     
136.                     }
     1 @8 u9 ^) O! X# g- _  e2 Z
137.                     break;
     # ]9 w% t* a0 u
138.                 case GUI_ID_BUTTON1:
     / C0 t( g- v3 E+ f
139.                     switch(NCode)
     1 S0 h3 y5 z- w' i' O: s2 s
140.                     {
     
141.                         case WM_NOTIFICATION_CLICKED:
     ' u: q& w6 `$ u* Z
142. 
     
143.                             break;
     ( D; F5 l; H4 `  L$ B
144.                         case WM_NOTIFICATION_RELEASED:
     + g1 |! g' b% i, h& P, u! ~
145. 
     
146.                             break;
     # B; [6 A$ O. @+ p# C2 O6 T7 `
147.                         case WM_NOTIFICATION_MOVED_OUT:
     ; F: L9 F) P6 B( \) X: }
148. 
     . X7 A4 A+ a+ X$ L# h
149.                             break;
     
150.                     }
     6 j! f& ^! j& `! b5 h
151.                     break;
     , R1 T  F) \$ |) m
152. 
     + P* A: P- p8 J5 ?! X7 T1 u  g0 i
153.             }
     + ?9 O, q+ {: {' K) B
154.             break;
     " d: \  D: x- Z" Y+ U
155.         default:
     
156.             WM_DefaultProc(pMsg);
     
157.     }
     ! ^+ `8 y( L- C8 X+ ]
158. }
     ) J1 R+ y! E6 n8 O. v* f- Y
159. 
     
160. /*********************************************************************
     
161. *
     
162. *       MainTask
     9 G) P( c2 V) Q8 p& o/ G" e6 @8 ?
163. *
     3 L3 T3 \9 D& M6 v! s7 t
164. **********************************************************************
     
165. */
     4 ]* |+ B% W3 D* b
166. void MainTask(void)
     7 q) O/ w5 B0 P7 F; v5 p6 ?
167. {
     / Y9 N1 Q& v: u
168.     WM_HWIN hDlg;
     
169. WM_HTIMER hTimer;
     # W4 t6 ~( T: J% z
170. Count = 0;
     
171. /*
     
172.    使能窗口使用内存设备，这样可以有效避免闪烁 放在GUI_Init前面就包括桌面
     ; J2 [; L7 \- ^! ]0 a+ e! U
173.    窗口，如果放在后面就不包括桌面窗口。
     
174. */
     
175. WM_SetCreateFlags(WM_CF_MEMDEV);  
     6 q/ q0 @6 c, l) @4 V
176. GUI_Init();
     # l* K/ h! G  i
177. WM_SetDesktopColor(GUI_BLUE);      /* Automacally update desktop window */
     2 g! d3 a0 K6 q
178. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     
179. FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
     
180. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     " C) }- v& d% q, V6 ~# Q. @% I) p
181. BUTTON_SetDefaultSkin(BUTTON_SKIN_FLEX);
     
182. CHECKBOX_SetDefaultSkin(CHECKBOX_SKIN_FLEX);
     8 m' R1 X! f0 i( |6 Y9 b% [
183. DROPDOWN_SetDefaultSkin(DROPDOWN_SKIN_FLEX);
     6 Z& D  L8 R' f- J
184. SCROLLBAR_SetDefaultSkin(SCROLLBAR_SKIN_FLEX);
     $ R- t! }6 X1 Z/ a0 x/ `3 H7 s8 w# H4 P
185. SLIDER_SetDefaultSkin(SLIDER_SKIN_FLEX);
     
186. HEADER_SetDefaultSkin(HEADER_SKIN_FLEX);
     
187. RADIO_SetDefaultSkin(RADIO_SKIN_FLEX);
       w) d! m" _9 g# k' Q7 ~- L+ {$ B
188. ///* 创建一个对话框 */
     
189.     hDlg = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
     
190. hTimer = WM_CreateTimer(WM_GetClientWindow(hDlg), 0, 100, 0);（2）
     # c5 R! ~$ I# _4 n6 v0 L: k
191. while (1)
     0 ?" W( c0 n% O) n4 F
192. {
     
193. GUI_Delay(500);
     2 ?% w. P( U$ j( f
194. }
     % x$ `, Z$ Y) Y( @0 d: }
195. }

复制代码

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

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

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

36.4 总结

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

: E: I, H% {  t* V- k4 H  c- ~

谢谢分享

好资料啊，收藏一下