【emWin实战教程V2.0】第40章 窗口管理器之To

席萌0209

完整65章+12章附件教程下载地址：
http://www.armbbs.cn/forum.php?mod=viewthread&tid=19834




第40章      窗口管理器之ToolTip的使用


        本章节为大家讲解STemWin自带的ToolTip使用方法，对于外接鼠标设备的时候，这个控件就比较的有用，如果是用触摸进行操作的话，这个控件就用不上了，但作为emWin的知识点也跟大家进行简单的讲解，知道有这么个控件即可。
        40.1 初学者重要提示
        40.2 ToolTips介绍
        40.3 ToolTips实例
        40.4 总结

席萌0209

40.1  初学者重要提示


u  本章节作为一个介绍性的知识跟大家进行讲解，以后的项目中用到的机会很小。
u  窗口管理器这块的API函数应该是emWin手册所有章节中函数最多的，ToolTip的API函数也属于这部分。下图是中文版手册里面API函数位置：

下图是英文版手册里面API函数的位置：

席萌0209

40.2 ToolTips介绍


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

                                             

现在STemWin5.32版本支持的API如下：
                                                  
关于这几个函数的就不给大家依次做介绍了，我们直接通过实例来看如何操作这些函数。

席萌0209

40.3 ToolTips实例


       这个Demo主要是实现为对话框上面的两个按钮控件和一个文本控件都添加了ToolTip提示功能，源代码如下（可以将其直接复制到开发板或者模拟器上面运行）。

1. #include "DIALOG.h"
5. /*
6. *********************************************************************************************************
7. *                              变量
8. *********************************************************************************************************
9. */
10. static const TOOLTIP_INFO _aInfo[] = //--------------（1）
11. {
12.      { GUI_ID_BUTTON0, "I am Button 0"},
13.      { GUI_ID_BUTTON1, "I am Button 1" },
14.      { GUI_ID_TEXT0, "I am TEXT 0" },
15. };
17. /*
18. *********************************************************************************************************
19. *                           GUI_WIDGET_CREATE_INFO类型数组
20. *********************************************************************************************************
21. */
22. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
23.     { FRAMEWIN_CreateIndirect,  "armfly",   0,               0,  0,  320,240,0,0},
24.      { TEXT_CreateIndirect,      "ARM",     GUI_ID_TEXT0,    30,30,300,25, 0,0},
25.      { BUTTON_CreateIndirect,    "BUTTON0",  GUI_ID_BUTTON0,  30, 70,120,40, 0,0},
26.     { BUTTON_CreateIndirect,    "BUTTON1",  GUI_ID_BUTTON1,  30,125,120,40, 0,0},
28. };
30. /*
31. *********************************************************************************************************
32. *    函 数 名: _cbCallback
33. *    功能说明: 对话框回调函数        
34. *    形    参: pMsg  回调参数
35. *    返 回 值: 无
36. *********************************************************************************************************
37. */
38. static void _cbCallback(WM_MESSAGE * pMsg)
39. {
40.     int NCode, Id;
41.     WM_HWIN hWin = pMsg->hWin;
43.     switch (pMsg->MsgId)
44.     {
45.         case WM_INIT_DIALOG:
47.               //
48.               //初始化框架窗口
49.               //
50.               FRAMEWIN_SetFont(hWin,&GUI_Font24B_ASCII);
51.               FRAMEWIN_SetTextAlign(hWin,GUI_TA_VCENTER|GUI_TA_CENTER);
52.               FRAMEWIN_SetTitleHeight(hWin,30);
54.               //
55.               //初始化文本控件
56.               //
57.               TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0), &GUI_Font24B_ASCII);
58.             break;
59.             
60.         case WM_KEY:
61.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
62.             {
63.                 case GUI_KEY_ESCAPE:
64.                     GUI_EndDialog(hWin, 1);
65.                     break;
66.                 case GUI_KEY_ENTER:
67.                     GUI_EndDialog(hWin, 0);
68.                     break;
69.             }
70.             break;
71.             
72.         case WM_NOTIFY_PARENT:
73.             Id = WM_GetId(pMsg->hWinSrc);
74.             NCode = pMsg->Data.v;      
75.             switch (Id)
76.             {
77.                 case GUI_ID_OK:
78.                     if(NCode==WM_NOTIFICATION_RELEASED)
79.                         GUI_EndDialog(hWin, 0);
80.                     break;
81.                 case GUI_ID_CANCEL:
82.                     if(NCode==WM_NOTIFICATION_RELEASED)
83.                         GUI_EndDialog(hWin, 0);
84.                     break;
85.             }
86.             break;
87.             
88.         default:
89.             WM_DefaultProc(pMsg);
90.     }
91. }
93. /*
94. *********************************************************************************************************
95. *    函 数 名: MainTask
96. *    功能说明: GUI主函数
97. *    形    参: 无
98. *    返 回 值: 无
99. *********************************************************************************************************
100. */
101. void MainTask(void)
102. {
103.     WM_HWIN hDlg;
104.      WM_TOOLTIP_HANDLE hInfo;
106.    
107.      /* 初始emWin */
108.      GUI_Init();
109.    
110.      /* 窗口使能使用内存设备，防止闪烁 */
111.      WM_SetCreateFlags(WM_CF_MEMDEV);
113.     /* 创建一个对话框 */
114.     hDlg = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
116.      /* 给对话框上的文件控件和两个按钮控件都添加ToolTip */
117.      hInfo = WM_TOOLTIP_Create(hDlg, _aInfo, GUI_COUNTOF(_aInfo)); //--------------（2）
119.      while (1)
120.      {
121.          GUI_Delay(10);
122.      }
123. }

复制代码

1.     创建一个TOOLTIP_INFO类型的数组，用于给两个按钮和一个文本框使用。
        TOOLTIP_INFO类型结构体的定义如下：

2.     创建一个属于hDlg对话框的ToolTip，
        控件ID为GUI_ID_BUTTON0的按钮显示的文本是"I am Button 0"。
        控件ID为GUI_ID_BUTTON1的按钮显示的文本是"I am Button 1"。
        控件ID为GUI_ID_TEXT0的按钮显示的文本是"I am TEXT 0"。
实际现象效果如下，这个是鼠标放到按钮上面时的提示效果：

席萌0209

40.4   总结


        本章节简单的为大家介绍了ToolTip功能，对于初学者来说，知道有这么个功能即可。一般情况下，
在外接鼠标时，才能有效的利用ToolTip功能，如果没有外接鼠标的时候，这个功能的意义就不大了。