特别说明：完整STemWin的1-60期教程和配套实例下载地址：链接
6 s) J0 x5 [* |7 Z

第37章 窗口管理器之ToolTip使用

    本期教程跟大家讲一下STemWin自带的tooltip使用方法，对于外接鼠标设备的时候，这个控件就比较的有用。如果是用触摸进行操作的话，这个控件就用不上了。

    37. 1 ToolTips介绍

    37. 2 ToolTips实例

    37. 3 总结

37.1 ToolTips介绍

     关于ToolTips，大家应该比较的熟悉，只是不知道它专业的名字。下面这个就是ToolTips：

    现在STemWin5.22版本支持的API如下：

37.2 ToolTips实例

   下面通过一个实例跟大家讲解一下ToolTips的使用，这个例子可以直接复制到模拟器或者开发板上面运行。

1. #include <stddef.h>
   - L! T9 o0 `& b! B: b$ p
2. #include "stdio.h"
   
3. #include "GUI.h"
   - ^1 U; F& Z/ L3 A. X0 |4 G
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"
    ' d, ]9 e( J4 G( r6 Z9 @/ T
11. #include "FRAMEWIN.h"
    
12. #include "LISTBOX.h"
    
13. #include "MULTIEDIT.h"
    , e: c" s$ R0 |% }$ e9 I9 D- E6 d
14. #include "RADIO.h"
    
15. #include "SLIDER.h"
    ) i% H8 u* c; t1 m: M9 a9 ^$ v
16. #include "TEXT.h"
    : Y+ ]; Z7 ?7 N) f3 b; y5 s, V
17. #include "PROGBAR.h"
    3 `1 d, ~* A4 }4 m/ n5 v1 a
18. #include "SCROLLBAR.h"
    
19. #include "LISTVIEW.h"
    
20. 
    2 u* x" X! M5 T
21. static int Count;
    
22. /*********************************************************************
    * ]5 ?& d$ z7 ]" L3 l4 F2 L; U3 O
23. *
    
24. *       Dialog resource
    
25. *
    
26. * This table conatins the info required to create the dialog.
    
27. * It has been created by ucGUIbuilder.
    ) k2 m  H% ^8 ]
28. */
    , G# Q( m4 p, u2 B
29. 
    8 o5 g4 Q5 X, i) c$ J
30. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
    ) H+ o9 y- [4 P0 u' e+ C9 L
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},
    8 N: `2 [" J( g
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. **                                                      
    6 W. _# \2 r% G" t0 {9 k$ w
41. **      call this function in _cbCallback --> WM_PAINT
    % H) U. y4 P! ]/ [7 \* ~
42. *****************************************************************/
    
43. 
    4 }3 \* j! Y7 J! X* V6 J# d
44. void PaintDialog(WM_MESSAGE * pMsg)
    ( r2 [/ q3 Q% A+ Y# [
45. {
    " ?/ a5 d. x5 l2 U. s; a8 z$ M/ w
46.     WM_HWIN hWin = pMsg->hWin;
    
47. 
    6 b& s, g' W' U  z
48. }
    
49. 
    + d/ I0 x* t' _! L  ~& a$ O
50. /*****************************************************************
    9 `2 Z+ _, Y; z5 _' U) m4 J
51. **      FunctionName:void InitDialog(WM_MESSAGE * pMsg)
    
52. **      Function: to initialize the Dialog items
    
53. **                                                      
    
54. **      call this function in _cbCallback --> WM_INIT_DIALOG
    , M. N4 E) I2 B3 t* w; D. V. r
55. *****************************************************************/
    
56. 
    
57. void InitDialog(WM_MESSAGE * pMsg)
    
58. {
    , E3 x. O( Q1 @0 }7 M  e
59.     WM_HWIN hWin = pMsg->hWin;
    
60.     //
    * I/ b. u, d3 e% L
61.     //FRAMEWIN
    
62.     //
    0 q  P, j. g6 U$ q
63.     FRAMEWIN_SetFont(hWin,&GUI_Font24B_ASCII);
    
64.     FRAMEWIN_SetTextAlign(hWin,GUI_TA_VCENTER|GUI_TA_CENTER);
    + o) L* l: x, \, _9 p( i) t% @
65.     FRAMEWIN_AddCloseButton(hWin, FRAMEWIN_BUTTON_RIGHT, 0);
    
66.     FRAMEWIN_AddMaxButton(hWin, FRAMEWIN_BUTTON_RIGHT, 1);
    & E+ R$ e% v/ X9 Y! t' ]: n; N( C7 K
67.     FRAMEWIN_AddMinButton(hWin, FRAMEWIN_BUTTON_RIGHT, 2);
    3 E) \0 |8 g/ B$ v" `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. 
    9 S0 |( g+ p! ?
75. }
    
76. 
    
77. /*********************************************************************
    
78. *
    & K% ]' G4 v) g: E) C9 h
79. *       Dialog callback routine
    $ r# B. U! J0 u3 r& B: C
80. */
    5 d8 R2 z4 E5 m7 x5 j
81. static void _cbCallback(WM_MESSAGE * pMsg)
    
82. {
    
83.     int NCode, Id;
    , K6 q- e0 h2 h% L4 b
84. char buf[10];
    8 c; R/ V% z% r. I7 c
85.     WM_HWIN hWin = pMsg->hWin;
    
86. 
    
87.     switch (pMsg->MsgId)
    % F8 p/ g* H5 V
88.     {
    $ K1 m/ J# m9 |9 H2 t
89. case WM_TIMER:
    0 m+ D; F' Q# _9 B( l2 L, w# D
90.             Count++;
    4 m- S3 j/ E( ?! x7 V
91. sprintf(buf, "%04d", Count);
    0 [% r, N+ D8 l6 s8 F
92. TEXT_SetText(WM_GetDialogItem(hWin,GUI_ID_TEXT0), (const char *)buf);
    
93. WM_RestartTimer(pMsg->Data.v, 100);
    . W; d: h1 r" E& x) Z$ _
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:
     / v7 T( L3 \  F0 V, t8 w) H. T
102.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
     / }% J+ ]0 E- j0 V, n) {2 W
103.             {
     
104.                 case GUI_KEY_ESCAPE:
     2 q# c# E" ~# e( _7 a2 z( r
105.                     GUI_EndDialog(hWin, 1);
     
106.                     break;
     # c* N* N7 [% I' H
107.                 case GUI_KEY_ENTER:
     
108.                     GUI_EndDialog(hWin, 0);
     : F9 m  F+ F+ K5 Y9 }3 |
109.                     break;
     / H( m8 S5 z1 K0 m
110.             }
     ; a3 Y( q( {- ^0 _( @
111.             break;
     ( O  y8 D6 I# @& W  S
112.         case WM_NOTIFY_PARENT:
     , ^6 C1 t" _; l( S
113.             Id = WM_GetId(pMsg->hWinSrc);
     ' i# H5 K' Q! e
114.             NCode = pMsg->Data.v;        
     - a6 K6 I6 e% y+ u  _  t  O+ d& R5 m
115.             switch (Id)
     
116.             {
     
117.                 case GUI_ID_OK:
     3 G* L$ V  g" s* c1 g/ e8 q. a: |
118.                     if(NCode==WM_NOTIFICATION_RELEASED)
     
119.                         GUI_EndDialog(hWin, 0);
     
120.                     break;
     ( ^5 V# t: B% ~: f# B
121.                 case GUI_ID_CANCEL:
     . d$ R6 d+ j0 J5 F. D( D
122.                     if(NCode==WM_NOTIFICATION_RELEASED)
     
123.                         GUI_EndDialog(hWin, 0);
     % z9 ?- P) L1 H9 N" R5 W7 G' t
124.                     break;
     7 N3 S0 N( `# h/ m  Y# n
125.                 case GUI_ID_BUTTON0:
     : K- j$ S! A% t+ P5 y3 {
126.                     switch(NCode)
     
127.                     {
     ' |, l3 @+ e7 d
128.                         case WM_NOTIFICATION_CLICKED:
     $ m. `) w( u. b: ~& E" S! @
129.                             break;
     ! I2 O1 u5 j! }  ~
130.                         case WM_NOTIFICATION_RELEASED:
     
131. 
     ' ~( A5 p/ b( _4 b* R
132.                             break;
     
133.                         case WM_NOTIFICATION_MOVED_OUT:
     - p; P% L) k* D3 z2 @
134. 
     ( [6 ~  d7 _; X+ F0 j
135.                             break;
     
136.                     }
     
137.                     break;
     
138.                 case GUI_ID_BUTTON1:
     
139.                     switch(NCode)
     
140.                     {
     2 {' i9 k- F% l1 a, m- i! H
141.                         case WM_NOTIFICATION_CLICKED:
     
142. 
     6 ~7 p2 V; ?& E' Z
143.                             break;
     - w" C' [6 Z' A" v$ I$ n
144.                         case WM_NOTIFICATION_RELEASED:
     
145. 
     5 m' e/ L; l1 q7 n8 N- e! R* ]+ M/ ]
146.                             break;
     
147.                         case WM_NOTIFICATION_MOVED_OUT:
     
148. 
     5 a& b5 Y( b( {3 N
149.                             break;
     
150.                     }
     
151.                     break;
     0 a6 D) P* S! _1 A7 M
152. 
     
153.             }
     9 U" G9 c: P' Z& J- z
154.             break;
     / n$ o6 N* s7 F8 |& F. ^% a
155.         default:
     0 O& k1 a; m5 A3 u6 T6 C
156.             WM_DefaultProc(pMsg);
     
157.     }
     ' E5 R% w4 N. S: f: F# A( D
158. }
     
159. 
     
160. static const TOOLTIP_INFO _aInfo[] = {（1）
     8 Q5 v* |4 n1 @- \
161. { GUI_ID_BUTTON0, "I am Button 0"},
     
162. { GUI_ID_BUTTON1, "I am Button 1" },
     7 d, c  v" J% i2 A0 S
163. { GUI_ID_TEXT0, "I am TEXT 0" },
     : i" X* x6 s% _, u
164. };
     
165. 
     ; |4 F/ N- v2 O
166. /*********************************************************************
     
167. *
     . T7 C" _1 z7 d, B" @7 U  k
168. *       MainTask
     - t+ d% a3 D; y
169. *
     
170. **********************************************************************
     
171. */
     
172. void MainTask(void)
     4 w4 e" ^, g0 z: x6 z6 O
173. {
     0 E" o3 W5 E) v' V: j# k
174.     WM_HWIN hDlg;
     
175. WM_HTIMER hTimer;
     
176. WM_TOOLTIP_HANDLE hInfo;
     
177. WM_TOOLTIP_HANDLE hToolTip;
     " }; \4 H. j- Y( J# h' n
178. Count = 0;
     
179. /*
     
180.    使能窗口使用内存设备，这样可以有效避免闪烁 放在GUI_Init前面就包括桌面
     
181.    窗口，如果放在后面就不包括桌面窗口。
     + ^# k' J% @+ T7 B) u! ]+ t
182. */
     
183. WM_SetCreateFlags(WM_CF_MEMDEV);  
     ' z) p3 B% ?# r  R
184. GUI_Init();
     # _% U( a* ]1 U1 V
185. WM_SetDesktopColor(GUI_BLUE);      /* Automacally update desktop window */
     ' s+ s- q! y/ X( C. {. G0 s
186. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     
187. FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
     
188. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     0 X* R4 m* C9 L
189. BUTTON_SetDefaultSkin(BUTTON_SKIN_FLEX);
     - N+ v" H  T& ]1 h1 {
190. CHECKBOX_SetDefaultSkin(CHECKBOX_SKIN_FLEX);
     
191. DROPDOWN_SetDefaultSkin(DROPDOWN_SKIN_FLEX);
     " r6 I) [; m/ R1 E$ M
192. SCROLLBAR_SetDefaultSkin(SCROLLBAR_SKIN_FLEX);
     5 `& z0 B8 E8 {/ s7 G5 h( Q; h
193. SLIDER_SetDefaultSkin(SLIDER_SKIN_FLEX);
     $ M. r: i4 C* [( b
194. HEADER_SetDefaultSkin(HEADER_SKIN_FLEX);
     
195. RADIO_SetDefaultSkin(RADIO_SKIN_FLEX);
     
196. /* 创建一个对话框 */
     
197.     hDlg = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
     ! {( h) Q5 E  R8 H, z$ V
198. hTimer = WM_CreateTimer(WM_GetClientWindow(hDlg), 0, 100, 0);
     
199. 
     / ^& M- u# u. e. ~
200. hInfo = WM_TOOLTIP_Create(hDlg, _aInfo, GUI_COUNTOF(_aInfo));（2）
     
201. hToolTip = WM_TOOLTIP_Create(hDlg, NULL, 0);（3）
     " q) ~9 y- o  `% W, y: k0 _
202. WM_TOOLTIP_AddTool(hToolTip, WM_GetClientWindow(hDlg), "I am a ToolTip");（4）
     
203. while (1)
     9 p; k$ }9 V  f6 r. U
204. {
     - K% Y) C$ f  q
205. GUI_Delay(500);
     
206. }
     
207. }

复制代码

1. 创建一个TOOLTIP_INFO类型的数组。用于给两个按钮和一个文本框使用。

2. 创建一个属于hDlg对话框的TOOLTIP。用于给两个按钮和一个文本框提供提示。

3. 再创建一个TOOLTIP。

4. 这句比较的关键，这里是给对话框中的window控件添加TOOLTIP功能。

实际现象效果如下，这个是鼠标放到按钮上面时的提示效果：

37.3 总结

    在外接鼠标的时候，才能有效的利用TOOLTIP控件。如果没有外接鼠标的时候，这个控件的意义就不大了。

! r- y. V4 G0 \

多谢分享

留下脚印，感谢分享