【STemWin教程】第37章 窗口管理器之ToolTip使用

席萌0209

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

第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>
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:
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. 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. };
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);
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控件。如果没有外接鼠标的时候，这个控件的意义就不大了。

careyou1984

能不能实现初次进入界面   如果在设定时间内没有任何动作  就自动显示Tip 告诉操作者每个控件意义

eric2013

careyou1984:能不能实现初次进入界面   如果在设定时间内没有任何动作  就自动显示Tip 告诉操作者每个控件意义 (2016-04-01 17:15) 

TIP控件在使用外置鼠标的时候比较好用。