【emWin实战教程V2.0】第37章 窗口管理器实例

席萌0209

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




                  第37章      窗口管理器实例（含自定义消息）


    为了帮助大家更好的理解窗口管理器的回调函数和消息机制，本章教程专门做了两个相关的例子，帮助大家更好的理解。
37.1  初学者重要提示
37.2 用户自定义消息类型实例
37.3 桌面窗口回调函数实例
37.4 总结

席萌0209

37.1  初学者重要提示

1、通过实例来学习emWin是最佳的学习捷径。
2、本章节举的两个例子都用到了对话框，对于初学者来说，仅需知道这是对话框即可，重点是看对话框回调函数的实现，后面章节会专门讲解对话框。
3、窗口管理器这块的API函数应该是emWin手册所有章节中函数最多的，以后需要用到什么功能了，查询就行，或者看官方的实例，哪个函数不理解了也可以查手册。下图是中文版手册里面API函数位置：

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

席萌0209

37.2 用户自定义消息类型实例


    第36章为大家讲解的都是STemWin支持的消息类型，这里我们通过一个实例来实现自定义消息，这个功能在大家以后的实际项目中都有机会用到，比较有实战价值。
    下面我们直接通过如下的代码来讲解实现方法和用到的函数（可以直接将代码复制到模拟器或者开发板上面运行）。

1. #include "DIALOG.h"
5. /*
6. *********************************************************************************************************
7. *                                         变量
8. *********************************************************************************************************
9. */
10. static GUI_COLOR _acColor[3] = {GUI_BLUE,GUI_RED,GUI_YELLOW};   //--------------（1）
11. static unsigned char ucBackColor;
13. /*
14. *********************************************************************************************************
15. *                                         宏定义
16. *********************************************************************************************************
17. */
18. #define ID_FRAMEWIN_0  (GUI_ID_USER + 0x00)
19. #define ID_BUTTON_0    (GUI_ID_USER + 0x01)
20. #define ID_SCROLLBAR_0 (GUI_ID_USER + 0x02)
21. #define ID_SLIDER_0    (GUI_ID_USER + 0x03)
23. #define WM_UPDATE      (WM_USER + 0x00) /* 自定义消息 */  // --------------（2）
26. /*
27. *********************************************************************************************************
28. *                           GUI_WIDGET_CREATE_INFO类型数组
29. *********************************************************************************************************
30. */
31. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
32.   { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 480, 272, 0, 0x64, 0 },
33.   { BUTTON_CreateIndirect, "Button", ID_BUTTON_0, 130, 28, 147, 35, 0, 0x0, 0 },
34.   { SCROLLBAR_CreateIndirect, "Scrollbar", ID_SCROLLBAR_0, 129, 74, 147, 28, 0, 0x0, 0 },
35.   { SLIDER_CreateIndirect, "Slider", ID_SLIDER_0, 133, 118, 137, 25, 0, 0x0, 0 },
36. };
38. /*
39. *********************************************************************************************************
40. *    函 数 名: _cbDialog
41. *    功能说明: 对话框回调函数        
42. *    形    参: pMsg  回调参数
43. *    返 回 值: 无
44. *********************************************************************************************************
45. */
46. static void _cbDialog(WM_MESSAGE * pMsg)
47. {
48.      WM_HWIN hItem;
49.      int     NCode;
50.      int     Id;
53.      switch (pMsg->MsgId)
54.      {
55.          case WM_INIT_DIALOG:
56.             
57.               //
58.               // 初始化 'Framewin'
59.               //
60.               hItem = pMsg->hWin;
61.               FRAMEWIN_SetFont(hItem, GUI_FONT_32B_ASCII);
62.               FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
63.               FRAMEWIN_SetText(hItem, "armfly");
64.         
65.               //
66.               // 初始化 'Button'
67.               //
68.               hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_0);
69.               BUTTON_SetFont(hItem, GUI_FONT_24B_ASCII);
70.               BUTTON_SetText(hItem, "armfly");
72.               /* 默认颜色取*/
73.               ucBackColor = 0;
74.               break;
76.          case WM_PAINT:      
77.             GUI_SetBkColor(_acColor[ucBackColor]);
78.             GUI_Clear();
79.             break;
81.          case WM_UPDATE:      //--------------（3）
82.               ucBackColor++;
83.               if (ucBackColor == 3)
84.               {
85.                    ucBackColor = 0;
86.               }
87.               WM_InvalidateWindow(pMsg->hWin);
88.               break;
89.    
91.         case WM_KEY:
92.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
93.             {
94.                 case GUI_KEY_ESCAPE:
95.                     GUI_EndDialog(pMsg->hWin, 1);
96.                     break;
98.                 case GUI_KEY_ENTER:
99.                     GUI_EndDialog(pMsg->hWin, 0);
100.                     break;
101.             }
102.               break;
104.          case WM_NOTIFY_PARENT:
105.               Id    = WM_GetId(pMsg->hWinSrc);
106.               NCode = pMsg->Data.v;
107.               switch(Id)
108.               {
109.                    case ID_BUTTON_0:
110.                        switch(NCode)
111.                        {
112.                             case WM_NOTIFICATION_CLICKED:
113.                                  break;
114.                            
115.                             case WM_NOTIFICATION_RELEASED:
116.                                  break;
117.                        }
118.                        break;
119.                   
120.                    case ID_SCROLLBAR_0:
121.                        switch(NCode)
122.                        {
123.                             case WM_NOTIFICATION_CLICKED:
124.                                  break;
125.                            
126.                             case WM_NOTIFICATION_RELEASED:
127.                                  break;
128.                            
129.                             case WM_NOTIFICATION_VALUE_CHANGED:
130.                                  break;
131.                        }
132.                        break;
133.                   
134.                    case ID_SLIDER_0:
135.                        switch(NCode)
136.                        {
137.                             case WM_NOTIFICATION_CLICKED:
138.                                  break;
139.                            
140.                             case WM_NOTIFICATION_RELEASED:
141.                                  break;
142.                            
143.                             case WM_NOTIFICATION_VALUE_CHANGED:
144.                                  break;
145.                        }
146.                        break;
147.               }
148.               break;
149.             
150.          default:
151.               WM_DefaultProc(pMsg);
152.               break;
153.      }
154. }
156. /*
157. *********************************************************************************************************
158. *    函 数 名: CreateFramewin
159. *    功能说明: 创建对话框      
160. *    形    参: 无
161. *    返 回 值: 返回对话框句柄
162. *********************************************************************************************************
163. */
164. WM_HWIN CreateFramewin(void)
165. {
166.      WM_HWIN hWin;
168.      hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), _cbDialog, WM_HBKWIN, 0, 0);
170.      return hWin;
171. }
173. /*
174. *********************************************************************************************************
175. *    函 数 名: MainTask
176. *    功能说明: GUI主函数
177. *    形    参: 无
178. *    返 回 值: 无
179. *********************************************************************************************************
180. */
181. void MainTask(void)
182. {
183.      WM_HWIN hDlg;
185.      /* 初始emWin */
186.      GUI_Init();
188.      /* 创建对话框 */
189.     hDlg = CreateFramewin();
191.      while(1)
192.      {
193.          /* 给对话框hDlg发送自定义消息WM_UPDATE */
194.          WM_SendMessageNoPara(WM_GetClientWindow(hDlg), WM_UPDATE);   // --------------（4）
195.          GUI_Delay(500);
196.      }
197. }

复制代码

实现自定义消息的关键是函数WM_SendMessageNoPara的使用，学会了这个函数基本就学会了自定义消息的实现：
1.     定义一个数组，里面有三种颜色，再定义一个变量，用于三种颜色的切换。
2.     定义一个用户消息WM_UPDATE，一定要以WM_USER作为起始值，防止跟系统其他的数值冲突。如果还要实现其它自定义消息，在这个数值的基础上面定义即可。
3.     在回调函数中加入自定义消息WM_UPDATE，在这个消息里面切换对话框的背景色变量，然后调用函数WM_InvalidateWindow将对话框进行无效化，从而会触发窗口管理器去执行WM_PAINT消息，这样就实现了对话框背景色的变化。
4.     通过函数WM_SendMessageNoPara()每隔500ms给对话框发送WM_UPDATE消息。函数原型如下：
      void WM_SendMessageNoPara(WM_HWIN hWin, int MsgId)
    此函数用于将不带参数的消息发送到指定窗口，使用也比较简单，第一个参数hWin是要接受消息的窗口句柄，第二个参数MsgId是消息类型。其中第一个参数要特别注意，如果是给对话框发消息，且对话框的主体是框架窗口FrameWin或者直接给框架窗口FrameWin发消息，第一个参数必须要使用函数WM_GetClientWindow获得框架窗口的客户区，这一点非常重要，经常有初学者在这个地方犯错误。如果对话框的主体是Windows或者直接给Windows窗口发消息，无需使用函数WM_GetClientWindow，直接填句柄就可以了。
    此时初学者还会有个疑问，能否使用函数WM_SendMessageNoPara可以发送类似WM_PAINT的系统消息？答案是可以的，不过跟发自定义消息稍有区别:

1. /* 设置要用于绘制操作的活动窗口 */
2. WM_SelectWindow(WM_GetClientWindow(hDlg));
4. /* 给对话框hDlg发送系统消息WM_PAINT */
5. WM_SendMessageNoPara(WM_GetClientWindow(hDlg), WM_PAINT);
7. /* 切换回默认的桌面窗口 */
8. WM_SelectWindow(WM_HBKWIN);

复制代码

   另外还有一个带参数的消息发送函数WM_SendMessage，在第38章会有一个例子调用这个函数。最后，本程序的显示效果如下（分辨率480*272）,每500ms更新一次对话框的客户区背景色：

席萌0209

37.3 桌面窗口回调函数实例


        这个例子为大家讲解如何给桌面窗口配置回调函数。实现源码如下（可以直接将代码复制到模拟器或者开发板上面运行）。

1. #include "DIALOG.h"
5. /*
6. *********************************************************************************************************
7. *                                         宏定义
8. *********************************************************************************************************
9. */
10. #define ID_FRAMEWIN_0  (GUI_ID_USER + 0x00)
11. #define ID_BUTTON_0    (GUI_ID_USER + 0x01)
12. #define ID_SCROLLBAR_0 (GUI_ID_USER + 0x02)
13. #define ID_SLIDER_0    (GUI_ID_USER + 0x03)
16. /*
17. *********************************************************************************************************
18. *                           GUI_WIDGET_CREATE_INFO类型数组
19. *********************************************************************************************************
20. */
21. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {   //--------------（1）
22.   { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 480, 272, FRAMEWIN_CF_MOVEABLE, 0x64, 0 },
23.   { BUTTON_CreateIndirect, "Button", ID_BUTTON_0, 130, 28, 147, 35, 0, 0x0, 0 },
24.   { SCROLLBAR_CreateIndirect, "Scrollbar", ID_SCROLLBAR_0, 129, 74, 147, 28, 0, 0x0, 0 },
25.   { SLIDER_CreateIndirect, "Slider", ID_SLIDER_0, 133, 118, 137, 25, 0, 0x0, 0 },
26. };
28. /*
29. *********************************************************************************************************
30. *    函 数 名: _cbDialog
31. *    功能说明: 对话框回调函数        
32. *    形    参: pMsg  回调参数
33. *    返 回 值: 无
34. *********************************************************************************************************
35. */
36. static void _cbDialog(WM_MESSAGE * pMsg)
37. {
38.      WM_HWIN hItem;
39.      int     NCode;
40.      int     Id;
43.      switch (pMsg->MsgId)
44.      {
45.          case WM_INIT_DIALOG:
46.             
47.               //
48.               // 初始化 'Framewin'
49.               //
50.               hItem = pMsg->hWin;
51.               FRAMEWIN_SetFont(hItem, GUI_FONT_32B_ASCII);
52.               FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
53.               FRAMEWIN_SetText(hItem, "armfly");
54.         
55.               //
56.               // 初始化 'Button'
57.               //
58.               hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_0);
59.               BUTTON_SetFont(hItem, GUI_FONT_24B_ASCII);
60.               BUTTON_SetText(hItem, "armfly");
61.               break;
63.          case WM_PAINT:
64.               GUI_SetBkColor(GUI_RED);
65.               GUI_Clear();
66.               break;
68.         case WM_KEY:
69.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
70.             {
71.                 case GUI_KEY_ESCAPE:
72.                     GUI_EndDialog(pMsg->hWin, 1);
73.                     break;
75.                 case GUI_KEY_ENTER:
76.                     GUI_EndDialog(pMsg->hWin, 0);
77.                     break;
78.             }
79.               break;
81.          case WM_NOTIFY_PARENT:
82.               Id    = WM_GetId(pMsg->hWinSrc);
83.               NCode = pMsg->Data.v;
84.               switch(Id)
85.               {
86.                    case ID_BUTTON_0:
87.                        switch(NCode)
88.                        {
89.                             case WM_NOTIFICATION_CLICKED:
90.                                  break;
91.                            
92.                             case WM_NOTIFICATION_RELEASED:
93.                                  break;
94.                        }
95.                        break;
96.                   
97.                    case ID_SCROLLBAR_0:
98.                        switch(NCode)
99.                        {
100.                             case WM_NOTIFICATION_CLICKED:
101.                                  break;
102.                            
103.                             case WM_NOTIFICATION_RELEASED:
104.                                  break;
105.                            
106.                             case WM_NOTIFICATION_VALUE_CHANGED:
107.                                  break;
108.                        }
109.                        break;
110.                   
111.                    case ID_SLIDER_0:
112.                        switch(NCode)
113.                        {
114.                             case WM_NOTIFICATION_CLICKED:
115.                                  break;
116.                            
117.                             case WM_NOTIFICATION_RELEASED:
118.                                  break;
119.                            
120.                             case WM_NOTIFICATION_VALUE_CHANGED:
121.                                  break;
122.                        }
123.                        break;
124.               }
125.               break;
126.             
127.          default:
128.               WM_DefaultProc(pMsg);
129.               break;
130.      }
131. }
133. /*
134. *********************************************************************************************************
135. *    函 数 名: CreateFramewin
136. *    功能说明: 创建对话框      
137. *    形    参: 无
138. *    返 回 值: 返回对话框句柄
139. *********************************************************************************************************
140. */
141. WM_HWIN CreateFramewin(void)
142. {
143.      WM_HWIN hWin;
145.      hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), _cbDialog, WM_HBKWIN, 0, 0);
147.      return hWin;
148. }
150. /*
151. *********************************************************************************************************
152. *    函 数 名: _cbBkWindow
153. *    功能说明: 桌面窗口回调函数      
154. *    形    参: 无
155. *    返 回 值: 返回对话框句柄
156. *********************************************************************************************************
157. */
158. static void _cbBkWindow(WM_MESSAGE * pMsg) //--------------（2）
159. {
160.     WM_HWIN hWin = pMsg->hWin;
162.     switch (pMsg->MsgId)
163.     {
164.          case WM_PAINT:
165.               GUI_SetBkColor(GUI_BLUE);
166.               GUI_Clear();
167.               break;
169.         default:
170.             WM_DefaultProc(pMsg);
171.     }
172. }
174. /*
175. *********************************************************************************************************
176. *    函 数 名: MainTask
177. *    功能说明: GUI主函数
178. *    形    参: 无
179. *    返 回 值: 无
180. *********************************************************************************************************
181. */
182. void MainTask(void)
183. {
184.      WM_HWIN hDlg;
186.      /*
187.         使能窗口使用内存设备，这样可以有效避免闪烁, 放在GUI_Init前面就包括桌面
188.         窗口，如果放在后面就不包括桌面窗口。
189.      */
190.      WM_SetCreateFlags(WM_CF_MEMDEV);  //--------------（3）
192.      /* 初始emWin */
193.      GUI_Init();
195.      /* 设置桌面窗口的回调函数 */
196.      WM_SetCallback(WM_HBKWIN, _cbBkWindow); //--------------（4）
198.      /* 创建对话框 */
199.     hDlg = CreateFramewin();
201.      while(1)
202.      {
203.          GUI_Delay(10);
204.      }
205. }

复制代码

1.     对话框资源列表第一个选项FrameWin设置了一个参数FRAMEWIN_CF_MOVEABLE，这样对话框就是可以移动的，方便查看桌面窗口回调函数的刷新。关于对话框的使用会在后面章节为大家详细讲解，这里有个感性的认识即可。
2.     桌面窗口的回调函数（桌面窗口是emWin最底层的窗口，是初始化后自动创建的），这里仅实现了一个WM_PAINT消息。
3.     使用函数WM_SetCreateFlags(WM_CF_MEMDEV)分两种情况，如果此函数是放在函数GUI_Init前面，那么所有的窗口将自动使用内存设备，使用内存设备的好处是有效避免闪烁感。如果此函数是放在函数GUI_Init后面调用，那么桌面窗口是没有使用内存设备的，这点要特别注意。
4.     通过函数WM_SetCallback来设置桌面窗口的回调函数，实现的功能比较简单，仅设置重绘消息。这里的功能基本等同于调用函数WM_SetDesktopColor(GUI_BLUE)。实现的效果是一样的，都是可以自动重绘桌面窗口。
        另外，测试中还发现一点，如果用户将函数WM_SetCreateFlags(WM_CF_MEMDEV)放在GUI_Init前面，桌面窗口也是可以自动重绘的，这样就可以不需要使用WM_SetCallback来设置桌面窗口回调函数或者使用函数WM_SetDesktopColor(GUI_BLUE)，不过重绘的颜色固定为灰色。
----------------------------
        这个程序的显示效果如下（分辨率480*272）：

用户可以拖动这个窗口，鼠标点击到标题栏就可以拖动了，跟操作电脑端软件是一样的：

如果不设置桌面窗口回调函数，且函数WM_SetCreateFlags(WM_CF_MEMDEV)没有放在GUI_Init前面调用，那么拖动窗口的话，显示效果就是这个样子的：

显示成这个样子是因为桌面窗口没有执行重绘，导致拖动对话框的时候一直有上次显示的残影。

席萌0209

37.4   总结


    本章节就跟大家讲这么多，希望通过本章教程让大家对窗口管理器有更好的认识，不过还需要大家在模拟器或者开发板上面多做这方面的练习，将其它的窗口管理器API函数也调用测试下。