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

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

    37. 1 ToolTips介绍

    37. 2 ToolTips实例

    37. 3 总结

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

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

37.2 ToolTips实例

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

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:
    
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. static const TOOLTIP_INFO _aInfo[] = {（1）
     
161. { GUI_ID_BUTTON0, "I am Button 0"},
     
162. { GUI_ID_BUTTON1, "I am Button 1" },
     
163. { GUI_ID_TEXT0, "I am TEXT 0" },
     
164. };
     
165. 
     
166. /*********************************************************************
     
167. *
     
168. *       MainTask
     
169. *
     
170. **********************************************************************
     
171. */
     
172. void MainTask(void)
     
173. {
     
174.     WM_HWIN hDlg;
     
175. WM_HTIMER hTimer;
     
176. WM_TOOLTIP_HANDLE hInfo;
     
177. WM_TOOLTIP_HANDLE hToolTip;
     
178. Count = 0;
     
179. /*
     
180.    使能窗口使用内存设备，这样可以有效避免闪烁 放在GUI_Init前面就包括桌面
     
181.    窗口，如果放在后面就不包括桌面窗口。
     
182. */
     
183. WM_SetCreateFlags(WM_CF_MEMDEV);  
     
184. GUI_Init();
     
185. WM_SetDesktopColor(GUI_BLUE);      /* Automacally update desktop window */
     
186. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     
187. FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
     
188. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     
189. BUTTON_SetDefaultSkin(BUTTON_SKIN_FLEX);
     
190. CHECKBOX_SetDefaultSkin(CHECKBOX_SKIN_FLEX);
     
191. DROPDOWN_SetDefaultSkin(DROPDOWN_SKIN_FLEX);
     
192. SCROLLBAR_SetDefaultSkin(SCROLLBAR_SKIN_FLEX);
     
193. SLIDER_SetDefaultSkin(SLIDER_SKIN_FLEX);
     
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);
     
198. hTimer = WM_CreateTimer(WM_GetClientWindow(hDlg), 0, 100, 0);
     
199. 
     
200. hInfo = WM_TOOLTIP_Create(hDlg, _aInfo, GUI_COUNTOF(_aInfo));（2）
     
201. hToolTip = WM_TOOLTIP_Create(hDlg, NULL, 0);（3）
     
202. WM_TOOLTIP_AddTool(hToolTip, WM_GetClientWindow(hDlg), "I am a ToolTip");（4）
     
203. while (1)
     
204. {
     
205. GUI_Delay(500);
     
206. }
     
207. }

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

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

3. 再创建一个TOOLTIP。

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

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

37.3  总结

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