【emWin实战教程V2.0】第55章 MULTIPAGE-多页控件

席萌0209

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

第55章     MULTIPAGE-多页控件

         本章节为大家讲解STemWin支持的多页控件，通过使用多页控件，可以很方便的在窗口上面扩展出多个页面，这样就可以集成更多的功能到这个窗口上面，使用此控件的最大好处也就在这里了。
55.1 初学者重要提示
55.2 多页控件基础知识
55.3 使用GUIBuilder创建多页控件并用模拟器显示出来
55.4 官方WIDGET_Multipage.c实例
55.5 实验例程说明（RTOS）
55.6 实验例程说明（裸机）
55.7 总结

席萌0209

55.1  初学者重要提示


u  初学者爱问的问题简单汇总：
        问题1：多页控件选项卡的位置是否可以任意设置
        答：可以的，函数MULTIPAGE_SetAlign配合MULTIPAGE_SetRotation就可以实现。
2、本教程配套的emWin版本是5.32，从emWin5.28版本开始，皮肤色是自动使能的，所以部分多页控件的API函数是失效的，主要是多页控件颜色设置函数，此问题也经常被初学者问。
3、实际项目中，建议用户将对话框附加到多页控件的页面窗口上，这样页面窗口的管理将非常方便，而且这个对话框也可以使用GUIBuilder进行创建，本章节配套的例子都是采用的这种方法。
4、多页控件的所有API函数在emWin手册中都有讲解，下图是中文版手册里面API函数位置：

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

席萌0209

55.2 多页控件基础知识

       先通过下面的图表看看多页控件是什么样子的：

相信大家在电脑端经常见到这种类似的控件，通过使用多页控件，可以很方便的在窗口上面扩展出多个页面，这样就可以集成更多的功能到这个窗口上面，使用此控件的最大好处也就在这里了。另外，如果窗口中无法显示所有选项卡，就如上表第二个图中创建了6个页面，选项卡无法全部显示出来，右下角就会显示出一个滚动条。

        下面接着说说多页控件的组成结构，一个多页控件是由1个MultiPage窗口，1个客户端窗口和n个用户所创建的页面窗口组成，n的大小由用户决定，用户创建了几个，n就是几：
                     （1）1个MULTIPAGE窗口
                     （2）1个客户端窗口
                     （3）N个页面窗口
页面窗口是被添加到客户端窗口上的，具体的层次关系如下：

用户的应用程序是创建到各个页面窗口上的。
---------------------------------------------------------------------------------------------------------

不开启皮肤色时，多页控件的显示效果就是上面图表中所示的，开启皮肤后显示效果如下：

55.2.1    多页控件支持的通知代码

        多页控件支持的通知代码主要是用来处理多页控件消息用的，多页控件主要支持四种消息事件，点击消息，释放消息，移开消息(点击了多页控件，且从多页控件所在的区域移开了但没有释放)和多页控件选项卡的内容被更改消息。比如用户通过触摸屏点击了多页控件，窗口管理器会给多页控件父窗口回调函数发送消息WM_NOTIFY_PARENT来通知父窗口，进而再区分是四种消息中的哪一种，用户就可以在相应的消息代码里面加入要实现的功能。

        以下事件是作为WM_NOTIFY_PARENT消息的一部分由多页控件发送给其父窗口，用来区分不同的多页控件消息。

注意，实际测试发现消息WM_NOTIFICATION_VALUE_CHANGED很奇葩，点击选项卡或者切换选项卡，这个消息都会被触发，感觉这个消息没有什么用，有些多余了。

55.2.2   多页控件支持的键盘反应（输入聚焦）


        多页控件支持输入聚焦，也支持外置键盘或者类似外置键盘的输入设备给多页控件发消息。当前仅支持以下两种按键消息：
        （输入聚焦是一个重要的知识点，使用外置键盘或者类似外置键盘的输入设备要用到）

特别注意一点，对于多页控件来说，要先聚焦到这个控件上了，给多页控件发送按键消息才会有反应。

55.2.3   多页控件API函数


        多行文本控件的API函数比较多，但调用都不难。我们这里把以下两个比较相似的函数特别解释下：
MULTIPAGE_AddPage
        此函数用于将窗口添加到多页控件的页面窗口。
MULTIPAGE_AddEmptyPage
        此函数也是用于将窗口添加到多页控件的页面窗口，跟函数MULTIPAGE_AddPage的区别是此函数可以在无窗口需要添加时，可以将窗口句柄参数设置为0。
----------------------------------------------------------------------------------------------------------
        本章节教程配套例子是将多页控件配合对话框一起使用的，实际项目中也推荐大家这么做，可以很方便的进行界面管理。在对话框上面使用多页控件是通过函数MULTIPAGE_CreateIndirect()来实现的。根据第41章41.7.1小节讲解的<WIDGET>_CreateIndirect()函数，GUI_WIDGET_CREATE_INFO结构体类型定义如下：

1. typedef struct {
2. GUI_WIDGET_CREATE_FUNC * pfCreateIndirect;    // 间接创建函数
3. const char * pName;                           // 控件名(不是所有控件都需要)
4. I16 Id;                                       // 控件ID
5. I16 x0, y0, xSize, ySize;                     // 控件的坐标位置和大小
6. I16 Flags;                                    // 控件用到的标志，没有就写0
7. I32 Para;                                     // 控件用到的参数，没有就写0
8. U32 NumExtraBytes;                            // 函数 <WIDGET>_SetUserData & <WIDGET>_GetUserData用到的
9. // 额外字节。
10. } GUI_WIDGET_CREATE_INFO;

复制代码

        上面结构体成员里面的标记Flags和参数Para是可选的，函数MULTIPAGE_CreateIndirect()没有用到参数Para，但用到了标记Flags，与函数MULTIPAGE_CreateEx的形参ExFlags是等效的，具体形参ExFlags支持哪些标记参看emWin官方手册中的说明即可。
        这里举一个对话框资源列表里面创建多页控件的例子，帮助大家更好的理解：

1. /*
2. *********************************************************************************************************
3. *                           宏定义
4. *********************************************************************************************************
5. */
6. #define ID_FRAMEWIN_0  (GUI_ID_USER + 0x00)
7. #define ID_MULTIPAGE_0 (GUI_ID_USER + 0x01)
9. /*
10. *********************************************************************************************************
11. *                           GUI_WIDGET_CREATE_INFO类型数组
12. *********************************************************************************************************
13. */
14. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
15. {
16. { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 800, 480, 0, 0x0, 0 },
17.   { MULTIPAGE_CreateIndirect, "Multipage", ID_MULTIPAGE_0, 23, 25, 400, 240, 0, 0x0, 0 },
18. };

复制代码

上面的对话框资源列表里面依次创建了框架窗口控件，多页控件。多页控件的参数和GUI_WIDGET_CREATE_INFO结构成员的对应关系如下：

pfCreateIndirect = MULTIPAGE_CreateIndirect;
pName = "Multipage";
Id = ID_MULTIPAGE_0;
x0 = 23;
y0 = 25;
xSize = 400;
ySzie = 240;
Flags = 0;
Para = 0x0;
NumExtraBytes = 0;
对于这个对应关系要注意以下两点：
1、这里的x0和y0坐标位置是相对于对话框资源列表中框架窗口的客户端窗口的位置坐标。
2、Id号，这里的Id号是用户自定义的，emWin在GUI.h文件中也定义了部分多行文本控件的Id号，用户是可以直接使用的：

1. #define GUI_ID_MULTIPAGE0 0x230
2. #define GUI_ID_MULTIPAGE1 0x231
3. #define GUI_ID_MULTIPAGE2 0x232
4. #define GUI_ID_MULTIPAGE3 0x233

复制代码

席萌0209

55.3 使用GUIBuilder创建多页控件并用模拟器显示出来

        （这句话放在开头说，GUIBuilder仅仅能够创建多页控件的框架，具体应用需要用户在页面窗口上面去实现）

        首先需要大家按照第2章2.3.4小节的说明下载STemWin的软件包，其中GUIBuilder5.32位于路径：STM32Cube_FW_F4_V1.13.0\\Middlewares\\ST\\STemWin\\Software里面

55.3.1   第一步：建立一个对话框，主体是框架窗口


1、找到GUIBuilder后，打开这个软件，并按照如下方式建立一个对话框。

2、修改框架窗口大小为800*480。

3、下面设置对话框标题的字体，对齐方式，和显示的文本。首先，在建立的对话框上面右击鼠标，选择Set font。

        弹出如下界面，并选择字体GUI_FONT_32B_ASCII，点击OK。

设置好字体以后再设置对齐方式，还是右击鼠标，选择Set text alignment，并选择居中

配置完成后，上面的文本Framewin会居中显示，然后还是鼠标右击，选择Set title text，并更改Framewin为armfly，修改的地方在左下角：

设置好以后，对话框就算建立完毕。

55.3.2   第二步：在对话框上面建立多页控件


多页控件的建立方法和上面的对话框是一样的。先将多页控件拖到对话框上面，建立后的效果如下所示：

对于建立的多行文本控件，用户可以任意拖动，并通过鼠标调整其大小，调整方法如下：先左击选中相应控件，会出现绿色的边框，在边框的地方拖动鼠标即可修改大小

这里我们直接左键选中多页控件后，通过左下角的属性框中设置长度是400*240。

设置完毕后，还需要单独添加页面窗口，还是鼠标左键选中此控件，然后鼠标右击选择Add page，最后在左下角的属性框里面可以设置选项卡上面显示的内容，我们这里就设置为STM32-V4,。

相同的方法，我们再添加两个页面窗口，选项卡分别命名为STM32-V5和STM32-V6。

55.3.3   第三步：建立好后点击File-save


        保存方法如下：

保存后生成的文件在GUIBuilder5.32软件所在的文件夹里面：

55.3.4   第四步：在模拟器上运行GUIBuilder生成的代码


        在模拟器上面如何演示GUIBuilder生成的代码已经在第6章的6.3小节详细讲述了，这里不再赘述。可以在模拟器上面运行的完整代码如下，此代码对应的例子是V6-581_STemWin实验_MultiPage多页控件（模拟器）：


（由于GUIBuilder创建多页控件的功能有限，我们这里要添加的代码稍多，为多页控件的三个页面窗口都添加了对话框，实际项目中，建议用户将对话框附加到多页控件的页面窗口上，这样页面窗口的管理将非常方便，而且这个对话框也可以使用GUIBuilder进行创建）

1. /*********************************************************************
2. *                                                                    *
3. *                SEGGER Microcontroller GmbH & Co. KG                *
4. *        Solutions for real time microcontroller applications        *
5. *                                                                    *
6. **********************************************************************
7. *                                                                    *
8. * C-file generated by:                                               *
9. *                                                                    *
10. *        GUI_Builder for emWin version 5.32                          *
11. *        Compiled Oct  8 2015, 11:59:02                              *
12. *        (c) 2015 Segger Microcontroller GmbH & Co. KG               *
13. *                                                                    *
14. **********************************************************************
15. *                                                                    *
16. *        Internet: www.segger.com  Support: support@segger.com       *
17. *                                                                    *
18. **********************************************************************
19. */
21. // USER START (Optionally insert additional includes)
22. // USER END
24. #include "DIALOG.h"
27. /*
28. ************************************************************************************************
29. *                             添加到多页控件第一个页面窗口的对话框                    //--------------（1）
30. ************************************************************************************************
31. */
32. /*********************************************************************
33. *
34. *       Defines
35. *
36. **********************************************************************
37. */
38. #define ID_WINDOW_01 (GUI_ID_USER + 0x10)
39. #define ID_BUTTON_01 (GUI_ID_USER + 0x11)
42. // USER START (Optionally insert additional static data)
43. // USER END
45. /*********************************************************************
46. *
47. *       _aDialogCreate
48. */
49. static const GUI_WIDGET_CREATE_INFO _aDialogCreatePage1[] = {
50.   { WINDOW_CreateIndirect, "Window", ID_WINDOW_01, 0, 0, 400, 200, 0, 0x0, 0 },
51.   { BUTTON_CreateIndirect, "Button", ID_BUTTON_01, 127, 68, 129, 43, 0, 0x0, 0 },
52. };
54. /*********************************************************************
55. *
56. *       Static code
57. *
58. **********************************************************************
59. */
61. // USER START (Optionally insert additional static code)
62. // USER END
64. /*********************************************************************
65. *
66. *       _cbDialog
67. */
68. static void _cbDialogPage1(WM_MESSAGE * pMsg) {
69.   WM_HWIN hItem;
70.   int     NCode;
71.   int     Id;
72.   // USER START (Optionally insert additional variables)
73.   // USER END
75.   switch (pMsg->MsgId) {
76.   case WM_INIT_DIALOG:
77.     //
78.     // Initialization of 'Button'
79.     //
80.     hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_01);
81.     BUTTON_SetFont(hItem, GUI_FONT_16B_ASCII);
82.     BUTTON_SetText(hItem, "Page1");
83.     // USER START (Optionally insert additional code for further widget initialization)
84.     // USER END
85.     break;
86.   case WM_NOTIFY_PARENT:
87.     Id    = WM_GetId(pMsg->hWinSrc);
88.     NCode = pMsg->Data.v;
89.     switch(Id) {
90.     case ID_BUTTON_01: // Notifications sent by 'Button'
91.       switch(NCode) {
92.       case WM_NOTIFICATION_CLICKED:
93.         // USER START (Optionally insert code for reacting on notification message)
94.         // USER END
95.         break;
96.       case WM_NOTIFICATION_RELEASED:
97.         // USER START (Optionally insert code for reacting on notification message)
98.         // USER END
99.         break;
100.       // USER START (Optionally insert additional code for further notification handling)
101.       // USER END
102.       }
103.       break;
104.     // USER START (Optionally insert additional code for further Ids)
105.     // USER END
106.     }
107.     break;
108.   default:
109.     WM_DefaultProc(pMsg);
110.     break;
111.   }
112. }
114. /*********************************************************************
115. *
116. *       CreateWindowPage1
117. */
118. WM_HWIN CreateWindowPage1(void) {
119.   WM_HWIN hWin;
121.   hWin = GUI_CreateDialogBox(_aDialogCreatePage1, GUI_COUNTOF(_aDialogCreatePage1), _cbDialogPage1,
122. WM_HBKWIN, 0, 0);
123.   return hWin;
124. }
126. /*
127. ************************************************************************************************
128. *                             添加到多页控件第二个页面窗口的对话框                   //--------------（2）
129. ************************************************************************************************
130. */
131. /*********************************************************************
132. *
133. *       Defines
134. *
135. **********************************************************************
136. */
137. #define ID_WINDOW_02 (GUI_ID_USER + 0x20)
138. #define ID_BUTTON_02 (GUI_ID_USER + 0x21)
141. // USER START (Optionally insert additional static data)
142. // USER END
144. /*********************************************************************
145. *
146. *       _aDialogCreate
147. */
148. static const GUI_WIDGET_CREATE_INFO _aDialogCreatePage2[] = {
149.   { WINDOW_CreateIndirect, "Window", ID_WINDOW_02, 0, 0, 400, 200, 0, 0x0, 0 },
150.   { BUTTON_CreateIndirect, "Button", ID_BUTTON_02, 127, 68, 129, 43, 0, 0x0, 0 },
151. };
153. /*********************************************************************
154. *
155. *       Static code
156. *
157. **********************************************************************
158. */
160. // USER START (Optionally insert additional static code)
161. // USER END
163. /*********************************************************************
164. *
165. *       _cbDialog
166. */
167. static void _cbDialogPage2(WM_MESSAGE * pMsg) {
168.   WM_HWIN hItem;
169.   int     NCode;
170.   int     Id;
171.   // USER START (Optionally insert additional variables)
172.   // USER END
174.   switch (pMsg->MsgId) {
175.   case WM_INIT_DIALOG:
176.     //
177.     // Initialization of 'Button'
178.     //
179.     hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_02);
180.     BUTTON_SetFont(hItem, GUI_FONT_16B_ASCII);
181.     BUTTON_SetText(hItem, "Page2");
182.     // USER START (Optionally insert additional code for further widget initialization)
183.     // USER END
184.     break;
185.   case WM_NOTIFY_PARENT:
186.     Id    = WM_GetId(pMsg->hWinSrc);
187.     NCode = pMsg->Data.v;
188.     switch(Id) {
189.     case ID_BUTTON_02: // Notifications sent by 'Button'
190.       switch(NCode) {
191.       case WM_NOTIFICATION_CLICKED:
192.         // USER START (Optionally insert code for reacting on notification message)
193.         // USER END
194.         break;
195.       case WM_NOTIFICATION_RELEASED:
196.         // USER START (Optionally insert code for reacting on notification message)
197.         // USER END
198.         break;
199.       // USER START (Optionally insert additional code for further notification handling)
200.       // USER END
201.       }
202.       break;
203.     // USER START (Optionally insert additional code for further Ids)
204.     // USER END
205.     }
206.     break;
207.   default:
208.     WM_DefaultProc(pMsg);
209.     break;
210.   }
211. }
213. /*********************************************************************
214. *
215. *       CreateWindowPage2
216. */
217. WM_HWIN CreateWindowPage2(void) {
218.   WM_HWIN hWin;
220.   hWin = GUI_CreateDialogBox(_aDialogCreatePage2, GUI_COUNTOF(_aDialogCreatePage2), _cbDialogPage2,
221. WM_HBKWIN, 0, 0);
222.   return hWin;
223. }
225. /*
226. ************************************************************************************************
227. *                             添加到多页控件第三个页面窗口的对话框                      //--------------（3）
228. ************************************************************************************************
229. */
230. /*********************************************************************
231. *
232. *       Defines
233. *
234. **********************************************************************
235. */
236. #define ID_WINDOW_03 (GUI_ID_USER + 0x30)
237. #define ID_BUTTON_03 (GUI_ID_USER + 0x31)
240. // USER START (Optionally insert additional static data)
241. // USER END
243. /*********************************************************************
244. *
245. *       _aDialogCreate
246. */
247. static const GUI_WIDGET_CREATE_INFO _aDialogCreatePage3[] = {
248.   { WINDOW_CreateIndirect, "Window", ID_WINDOW_03, 0, 0, 400, 200, 0, 0x0, 0 },
249.   { BUTTON_CreateIndirect, "Button", ID_BUTTON_03, 127, 68, 129, 43, 0, 0x0, 0 },
250. };
252. /*********************************************************************
253. *
254. *       Static code
255. *
256. **********************************************************************
257. */
259. // USER START (Optionally insert additional static code)
260. // USER END
262. /*********************************************************************
263. *
264. *       _cbDialog
265. */
266. static void _cbDialogPage3(WM_MESSAGE * pMsg) {
267.   WM_HWIN hItem;
268.   int     NCode;
269.   int     Id;
270.   // USER START (Optionally insert additional variables)
271.   // USER END
273.   switch (pMsg->MsgId) {
274.   case WM_INIT_DIALOG:
275.     //
276.     // Initialization of 'Button'
277.     //
278.     hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_03);
279.     BUTTON_SetFont(hItem, GUI_FONT_16B_ASCII);
280.     BUTTON_SetText(hItem, "Page3");
281.     // USER START (Optionally insert additional code for further widget initialization)
282.     // USER END
283.     break;
284.   case WM_NOTIFY_PARENT:
285.     Id    = WM_GetId(pMsg->hWinSrc);
286.     NCode = pMsg->Data.v;
287.     switch(Id) {
288.     case ID_BUTTON_03: // Notifications sent by 'Button'
289.       switch(NCode) {
290.       case WM_NOTIFICATION_CLICKED:
291.         // USER START (Optionally insert code for reacting on notification message)
292.         // USER END
293.         break;
294.       case WM_NOTIFICATION_RELEASED:
295.         // USER START (Optionally insert code for reacting on notification message)
296.         // USER END
297.         break;
298.       // USER START (Optionally insert additional code for further notification handling)
299.       // USER END
300.       }
301.       break;
302.     // USER START (Optionally insert additional code for further Ids)
303.     // USER END
304.     }
305.     break;
306.   default:
307.     WM_DefaultProc(pMsg);
308.     break;
309.   }
310. }
312. /*********************************************************************
313. *
314. *       CreateWindowPage3
315. */
316. WM_HWIN CreateWindowPage3(void) {
317.   WM_HWIN hWin;
319.   hWin = GUI_CreateDialogBox(_aDialogCreatePage3, GUI_COUNTOF(_aDialogCreatePage3), _cbDialogPage3,
320. WM_HBKWIN, 0, 0);
321.   return hWin;
322. }
324. /*********************************************************************
325. *
326. *       Defines
327. *
328. **********************************************************************
329. */
330. #define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
331. #define ID_MULTIPAGE_0 (GUI_ID_USER + 0x01)
334. // USER START (Optionally insert additional defines)
335. // USER END
337. /*********************************************************************
338. *
339. *       Static data
340. *
341. **********************************************************************
342. */
344. // USER START (Optionally insert additional static data)
345. // USER END
347. /*********************************************************************
348. *
349. *       _aDialogCreate
350. */
351. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
352.   { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 800, 480, 0, 0x0, 0 },
353.   { MULTIPAGE_CreateIndirect, "Multipage", ID_MULTIPAGE_0, 23, 25, 400, 240, 0, 0x0, 0 }, //--------（4）
354.   // USER START (Optionally insert additional widgets)
355.   // USER END
356. };
358. /*********************************************************************
359. *
360. *       Static code
361. *
362. **********************************************************************
363. */
365. // USER START (Optionally insert additional static code)
366. // USER END
368. /*********************************************************************
369. *
370. *       _cbDialog
371. */
372. static void _cbDialog(WM_MESSAGE * pMsg) {
373.   WM_HWIN hItem;
374.   WM_HWIN hWinPage;
375.   int     NCode;
376.   int     Id;
377.   // USER START (Optionally insert additional variables)
378.   // USER END
380.   switch (pMsg->MsgId) {
381.   case WM_INIT_DIALOG:
382.     //
383.     // Initialization of 'Framewin'
384.     //
385.     hItem = pMsg->hWin;
386. FRAMEWIN_SetFont(hItem, GUI_FONT_32B_ASCII);
387. FRAMEWIN_SetText(hItem, "armfly");
388.     FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
389.     //
390.     // Initialization of 'Multipage'
391.     //
392.     hItem = WM_GetDialogItem(pMsg->hWin, ID_MULTIPAGE_0); //--------------（5）
393.      MULTIPAGE_SetFont(hItem, GUI_FONT_16_ASCII);         //--------------（6）
395.      hWinPage = CreateWindowPage1();                      //--------------（7）
396.     MULTIPAGE_AddEmptyPage(hItem, hWinPage, "STM32-V4");  //--------------（8）
398.      hWinPage = CreateWindowPage2();                      //--------------（9）
399.     MULTIPAGE_AddEmptyPage(hItem, hWinPage, "STM32-V5");  //--------------（10）
401.      hWinPage = CreateWindowPage3();                      //--------------（11）
402.     MULTIPAGE_AddEmptyPage(hItem, hWinPage, "STM32-V6");  //--------------（12）
403.     // USER START (Optionally insert additional code for further widget initialization)
404.     // USER END
405.     break;
406.   case WM_NOTIFY_PARENT:
407.     Id    = WM_GetId(pMsg->hWinSrc);
408.     NCode = pMsg->Data.v;
409.     switch(Id) {
410.     case ID_MULTIPAGE_0: // Notifications sent by 'Multipage'
411.       switch(NCode) {
412.       case WM_NOTIFICATION_CLICKED:                     //--------------（13）
413.         // USER START (Optionally insert code for reacting on notification message)
414.         // USER END
415.         break;
416.       case WM_NOTIFICATION_RELEASED:                   //--------------（14）
417.         // USER START (Optionally insert code for reacting on notification message)
418.         // USER END
419.         break;
420.       case WM_NOTIFICATION_MOVED_OUT:                 //--------------（15）
421.         // USER START (Optionally insert code for reacting on notification message)
422.         // USER END
423.         break;
424.       case WM_NOTIFICATION_VALUE_CHANGED:             //--------------（16）
425.         // USER START (Optionally insert code for reacting on notification message)
426.         // USER END
427.         break;
428.       // USER START (Optionally insert additional code for further notification handling)
429.       // USER END
430.       }
431.       break;
432.     // USER START (Optionally insert additional code for further Ids)
433.     // USER END
434.     }
435.     break;
436.   // USER START (Optionally insert additional message handling)
437.   // USER END
438.   default:
439.     WM_DefaultProc(pMsg);
440.     break;
441.   }
442. }
444. /*********************************************************************
445. *
446. *       Public code
447. *
448. **********************************************************************
449. */
450. /*********************************************************************
451. *
452. *       CreateFramewin
453. */
454. WM_HWIN CreateFramewin(void);
455. WM_HWIN CreateFramewin(void) {
456.   WM_HWIN hWin;
458.   hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), _cbDialog, WM_HBKWIN, 0, 0);
459.   return hWin;
460. }
462. // USER START (Optionally insert additional public code)
463. // USER END
465. /*************************** End of file ****************************/
468. /*********************************************************************
469. *
470. *       MainTask
471. */
472. void MainTask(void)
473. {
475.      /* 初始化 */
476.      GUI_Init();
478.      /* 窗口自动使用存储设备 */
479.      WM_SetCreateFlags(WM_CF_MEMDEV);
481.      /* 创建对话框，使用GUIBulder5.32生成的对话框创建函数 */
482.      CreateFramewin();
484.      while(1)
485.      {
486.          GUI_Delay(50);
487.      }
488. }
490. /*************************** End of file ****************************/

复制代码

创建的这个例子相对稍麻烦，主要实现了在对话框上面创建一个多页控件，并为多页控件创建了三个页面窗口，每个窗口添加了一个对话框。

1.     创建的第一个对话框，添加到多页控件的第一个页面窗口上。这里是使用GUIBuilder创建的对话框，主体窗口是Window，界面大小是400*200。

2.     创建的第二个对话框，添加到多页控件的第二个页面窗口上。这里是使用GUIBuilder创建的对话框，主体窗口是Window，界面大小是400*200。

3.     创建的第三个对话框，添加到多页控件的第三个页面窗口上。这里是使用GUIBuilder创建的对话框，主体窗口是Window，界面大小是400*200。

4.     在对话框的资源列表中创建一个多页控件。

5.     通过函数WM_GetDialogItem获得对话框上ID为ID_MULTIPAGE_0的多页控件句柄。

6.     通过函数MULTIPAGE_SetFont设置多页控件选项卡中文本的字体。

7.     调用函数CreateWindowPage1创建第一个对话框。

8.     通过函数MULTIPAGE_AddEmptyPage将第一个对话框添加到多页控件的第一个页面窗口，并将选项卡命名为STM32-V4。

9.     调用函数CreateWindowPage2创建第二个对话框。

10.  通过函数MULTIPAGE_AddEmptyPage将第二个对话框添加到多页控件的第二个页面窗口，并将选项卡命名为STM32-V5。

11.  调用函数CreateWindowPage3创建第三个对话框。

12.  通过函数MULTIPAGE_AddEmptyPage将第三个对话框添加到多页控件的第三个页面窗口，并将选

项卡命名为STM32-V6。

13.  多页控件ID_ MULTIPAGE_0的点击消息WM_NOTIFICATION_CLICKED，如果用户需要点击多页控件后执行某项功能，就可以在这个消息里面加入用户功能。

14.  多页控件ID_ MULTIPAGE_0的释放消息WM_NOTIFICATION_RELEASED，如果用户需要多页控件释放后执行某项功能，就可以在这个消息里面加入用户功能。

15.  多页控件ID_ MULTIPAGE_0的移开消息WM_NOTIFICATION_MOVED_OUT，如果用户需要进入此消息后执行某项功能，就可以在这个消息里面加入用户功能。

16.  多页控件ID_ MULTIPAGE_0的消息WM_NOTIFICATION_VALUE_CHANGED，如果用户需要进入此消息后执行某项功能，就可以在这个消息里面加入用户功能。

实际显示效果如下，分辨率800*480：

对于这个创建和演示过程，强烈建议初学者实际动手操作。

席萌0209

55.4  官方WIDGET_Multipage.c实例讲解

        这个例子在模拟器中的位置：

主要功能介绍：
        这个例子比较容易理解，适合初学者学习参考，主要实现了在框架窗口上面创建一个多页控件，并给多页控件创建了6个页面窗口，每个页面窗口上都添加了对话框。
程序代码如下：

1. #include <stdlib.h>
3. #include "GUI.h"
4. #include "MULTIPAGE.h"
6. /*********************************************************************
7. *
8. *       Defines
9. *
10. **********************************************************************
11. */
12. //
13. // Recommended memory to run the sample with adequate performance
14. //
15. #define RECOMMENDED_MEMORY (1024L * 20)
17. /*********************************************************************
18. *
19. *       Static data
20. *
21. **********************************************************************
22. */
23. /*********************************************************************
24. *
25. *       Dialog resource
26. *
27. *  These tables contain the information required to create the dialogs.
28. *  It has been created manually, but could also be created by the GUIBuilder.
29. */
30. static const GUI_WIDGET_CREATE_INFO _aDialogCreate1[] = {
31.   { WINDOW_CreateIndirect,    "Dialog 1", 0,                   0,   0, 260, 100, FRAMEWIN_CF_MOVEABLE },
32.   { BUTTON_CreateIndirect,    "Button",   GUI_ID_BUTTON0,      5,  30,  80,  20, 0},
33.   { TEXT_CreateIndirect,      "Dialog 1", 0,                   5,  10,  50,  20, TEXT_CF_LEFT }
34. };
36. static const GUI_WIDGET_CREATE_INFO _aDialogCreate2[] = {
37.   { WINDOW_CreateIndirect,    "Dialog 2", 0,                   0,   0, 260, 100, FRAMEWIN_CF_MOVEABLE },
38.   { CHECKBOX_CreateIndirect,  "",         GUI_ID_CHECK0,       5,  30,   0,   0, 0},
39.   { CHECKBOX_CreateIndirect,  "",         GUI_ID_CHECK1,       5,  50,   0,   0, 0},
40.   { TEXT_CreateIndirect,      "Select 0", GUI_ID_TEXT0,       25,  30,  50,  15, TEXT_CF_LEFT },
41.   { TEXT_CreateIndirect,      "Select 1", GUI_ID_TEXT1,       25,  50,  50,  15, TEXT_CF_LEFT },
42.   { TEXT_CreateIndirect,      "Dialog 2", 0,                   5,  10,  50,  20, TEXT_CF_LEFT }
43. };
45. static const GUI_WIDGET_CREATE_INFO _aDialogCreate3[] = {
46.   { WINDOW_CreateIndirect,    "Dialog 3", 0,                   0,   0, 260, 100, FRAMEWIN_CF_MOVEABLE },
47.   { RADIO_CreateIndirect,     "",         GUI_ID_RADIO0,       5,  30,   0,   0, 0, 3},
48.   { TEXT_CreateIndirect,      "Option 1", GUI_ID_TEXT0,       25,  30,  50,  15, TEXT_CF_LEFT },
49.   { TEXT_CreateIndirect,      "Option 2", GUI_ID_TEXT1,       25,  50,  50,  15, TEXT_CF_LEFT },
50.   { TEXT_CreateIndirect,      "Option 3", GUI_ID_TEXT2,       25,  70,  50,  15, TEXT_CF_LEFT },
51.   { TEXT_CreateIndirect,      "Dialog 3", 0,                   5,  10,  50,  20, TEXT_CF_LEFT }
52. };
54. static const GUI_WIDGET_CREATE_INFO _aDialogCreate4[] = {
55.   { WINDOW_CreateIndirect,    "Dialog 4", 0,                   0,   0, 260, 100, FRAMEWIN_CF_MOVEABLE },
56.   { MULTIEDIT_CreateIndirect, "Text",     GUI_ID_MULTIEDIT0,   5,  30, 200,  40  },
57.   { TEXT_CreateIndirect,      "Dialog 4", 0,                   5,  10,  50,  20, TEXT_CF_LEFT }
58. };
60. static const GUI_WIDGET_CREATE_INFO _aDialogCreate5[] = {
61.   { WINDOW_CreateIndirect,    "Dialog 5", 0,                   0,   0, 260, 100, FRAMEWIN_CF_MOVEABLE },
62.   { SLIDER_CreateIndirect,    "",         GUI_ID_SLIDER0,      5,  30, 200,  40  },
63.   { TEXT_CreateIndirect,      "Dialog 5", 0,                   5,  10,  50,  20, TEXT_CF_LEFT }
64. };
66. static const GUI_WIDGET_CREATE_INFO _aDialogCreate6[] = {
67.   { WINDOW_CreateIndirect,    "Dialog 6", 0,                   0,   0, 260, 100, FRAMEWIN_CF_MOVEABLE },
68.   { SCROLLBAR_CreateIndirect, "",         GUI_ID_SCROLLBAR0,   5,  30, 200,  40  },
69.   { TEXT_CreateIndirect,      "Dialog 6", 0,                   5,  10,  50,  20, TEXT_CF_LEFT }
70. };
72. /*********************************************************************
73. *
74. *       Static code
75. *
76. **********************************************************************
77. */
78. /*********************************************************************
79. *
80. *       _cbDialog4
81. */
82. static void _cbDialog4(WM_MESSAGE * pMsg) {
83.   WM_HWIN hItem;
84.   WM_HWIN hDlg;
86.   hDlg = pMsg->hWin;
87.   switch (pMsg->MsgId) {
88.   case WM_INIT_DIALOG:
89.     hItem = WM_GetDialogItem(hDlg, GUI_ID_MULTIEDIT0);
90.     MULTIEDIT_SetText(hItem, "MULTIEDIT widget");
91.     MULTIEDIT_SetInsertMode(hItem, 1);
92.     break;
93.   default:
94.     WM_DefaultProc(pMsg);
95.   }
96. }
98. /*********************************************************************
99. *
100. *       _cbBkWindow
101. *
102. *  Function description
103. *    Callback routine of the background window.
104. *    It shows the sample title and draws the background.
105. */
106. static void _cbBkWindow(WM_MESSAGE * pMsg) {
107.   switch (pMsg->MsgId) {
108.   case WM_PAINT:
109.     GUI_SetBkColor(GUI_BLUE);
110.     GUI_Clear();
111.     GUI_SetColor(GUI_WHITE);
112.     GUI_SetFont(&GUI_Font24_ASCII);
113.     GUI_DispStringHCenterAt("WIDGET_Multipage - Sample", 160, 5);
114.     break;
115.   default:
116.     WM_DefaultProc(pMsg);
117.   }
118. }
120. /*********************************************************************
121. *
122. *       Public code
123. *
124. **********************************************************************
125. */
126. /*********************************************************************
127. *
128. *       MainTask
129. */
130. void MainTask(void) {
131.   WM_HWIN hMultiPage;
132.   WM_HWIN hFrameWin;
133.   WM_HWIN hDialog;
135.   //
136.   // Enable use of memory devices
137.   //
138.   WM_SetCreateFlags(WM_CF_MEMDEV);
139.   GUI_Init();
140.   //
141.   // Check if recommended memory for the sample is available
142.   //
143.   if (GUI_ALLOC_GetNumFreeBytes() < RECOMMENDED_MEMORY) {
144.     GUI_ErrorOut("Not enough memory available.");
145.     return;
146.   }
147.   WM_SetCallback(WM_HBKWIN, _cbBkWindow);
148.   //
149.   // Create the frame window
150.   //
151.   hFrameWin = FRAMEWIN_Create("FrameWindow", NULL, WM_CF_SHOW, 40, 44, 240, 152);  //--------------（1）
152.   FRAMEWIN_SetClientColor(hFrameWin, GUI_GREEN);
153.   FRAMEWIN_SetActive(hFrameWin, 1);
154.   FRAMEWIN_SetMoveable(hFrameWin, 1);
155.   //
156.   // Create the MULTIPAGE widget
157.   //
158.   hMultiPage = MULTIPAGE_CreateEx(7, 6, 220, 120, WM_GetClientWindow(hFrameWin), WM_CF_SHOW, 0, 0); //---（2）
159.   GUI_Delay(500);
160.   //
161.   // Create and attach the MULTIPAGE dialog windows
162.   //
163.   hDialog = GUI_CreateDialogBox(_aDialogCreate1, GUI_COUNTOF(_aDialogCreate1), NULL,     
164. WM_UNATTACHED, 0, 0);  //--------------（3）
165.   MULTIPAGE_AddPage(hMultiPage, hDialog, "Page 1");     //--------------（4）
166.   GUI_Delay(500);
168.   hDialog = GUI_CreateDialogBox(_aDialogCreate2, GUI_COUNTOF(_aDialogCreate2), NULL,     
169. WM_UNATTACHED, 0, 0);
170.   MULTIPAGE_AddPage(hMultiPage, hDialog, "Page 2");     //--------------（5）
171.   GUI_Delay(500);
173.   hDialog = GUI_CreateDialogBox(_aDialogCreate3, GUI_COUNTOF(_aDialogCreate3), NULL,     
174. WM_UNATTACHED, 0, 0);
175.   MULTIPAGE_AddPage(hMultiPage, hDialog, "Page 3");     //--------------（6）
176.   GUI_Delay(500);
178.   hDialog = GUI_CreateDialogBox(_aDialogCreate4, GUI_COUNTOF(_aDialogCreate4), _cbDialog4,
179. WM_UNATTACHED, 0, 0);
180.   MULTIPAGE_AddPage(hMultiPage, hDialog, "Page 4");     //--------------（7）
181.   GUI_Delay(500);
183.   hDialog = GUI_CreateDialogBox(_aDialogCreate5, GUI_COUNTOF(_aDialogCreate5), NULL,      
184. WM_UNATTACHED, 0, 0);
185.   MULTIPAGE_AddPage(hMultiPage, hDialog, "Page 5");     //--------------（8）
186.   GUI_Delay(500);
188.   hDialog = GUI_CreateDialogBox(_aDialogCreate6, GUI_COUNTOF(_aDialogCreate6), NULL,      
189. WM_UNATTACHED, 0, 0);
190.   MULTIPAGE_AddPage(hMultiPage, hDialog, "Page 6");     //--------------（9）
191.   GUI_Delay(500);
193.   //
194.   // Demonstrate the use of MULTIPAGE_SetAlign
195.   //
196.   MULTIPAGE_SetAlign(hMultiPage, MULTIPAGE_ALIGN_RIGHT);  //--------------（10）
197.   GUI_Delay(500);
198.   MULTIPAGE_SetAlign(hMultiPage, MULTIPAGE_ALIGN_RIGHT | MULTIPAGE_ALIGN_BOTTOM);  //--------------（11）
199.   GUI_Delay(500);
200.   MULTIPAGE_SetAlign(hMultiPage, MULTIPAGE_ALIGN_LEFT | MULTIPAGE_ALIGN_BOTTOM);  //--------------（12）
201.   while (1) {
202.     GUI_Delay(100);
203.   }
204. }
206. /*************************** End of file ****************************/

复制代码

1.     通过函数FRAMEWIN_Create创建框架窗口。
2.     通过函数MULTIPAGE_CreateEx将多页控件创建到框架窗口，特别注意，多页控件是要创建框架窗口的客户端窗口上，所以父窗口是WM_GetClientWindow(hFrameWin)。
3.     创建对话框，并将父窗口的参数设置为WM_UNATTACHED，表示当前未设置父窗口，或者说未附加到任何窗口上。
4.     通过函数MULTIPAGE_AddPage将对话框附加到多页控件的第1个页面窗口。
5.     通过函数MULTIPAGE_AddPage将第2次创建对话框附加到多页控件的第2个页面窗口。
6.     通过函数MULTIPAGE_AddPage将第3次创建对话框附加到多页控件的第3个页面窗口。
7.     通过函数MULTIPAGE_AddPage将第4次创建对话框附加到多页控件的第4个页面窗口。
8.     通过函数MULTIPAGE_AddPage将第5次创建对话框附加到多页控件的第5个页面窗口。
9.     通过函数MULTIPAGE_AddPage将第6次创建对话框附加到多页控件的第6个页面窗口。
10.  通过函数MULTIPAGE_SetAlign设置多页控件的选项卡右对齐。
11.  通过函数MULTIPAGE_SetAlign设置多页控件的选项卡右下角对齐。
12.  通过函数MULTIPAGE_SetAlign设置多页控件的选项卡左下角对齐。
实际显示效果如下：

席萌0209

55.5 实验例程说明（RTOS）


配套例子：
        V6-579_STemWin实验_MultiPage多页控件（RTOS）
实验目的：
        1.     本实验主要学习多行文本控件的使用。
        2.     emWin功能的实现在MainTask.c文件里面。
实验内容：
        1.     K1按键按下，串口打印任务执行情况（波特率115200，数据位8，奇偶校验位无，停止位1）。
        2.     K2按键按下，实现截图功能，将图片以BMP格式保存到SD卡中。
        3.     GUI任务主要在对话框上面创建了一个多页控件，控件上创建了三个页面窗口，每个页面窗口，添加了一个对话框。并且为每个对话框上面都添加了按钮控件，点击按钮控件实现LED的亮灭反转，三个对话框上的按钮控件分别控制的是LED1，LED2和LED3。
        4.     各个任务实现的功能如下：
              App Task Start   任务：实现按键和触摸扫描。
              App Task MspPro任务 ：实现截图功能，将图片以BMP格式保存到SD卡中。
              App Task UserIF  任务：按键消息处理。
              App Task COM   任务：暂未使用。
              App Task GUI    任务：GUI任务。
μCOS-III任务调试信息（按K1按键，串口打印）：

STemWin界面显示效果：
        800*480分辨率界面效果。

STemWin动态内存配置：
        GUIConf.c文件中的配置如下：

1. #define EX_SRAM   1/*1 used extern sram, 0 used internal sram */
3. #if EX_SRAM
4. #define GUI_NUMBYTES  (1024*1024*8)
5. #else
6. #define GUI_NUMBYTES  (100*1024)
7. #endif

复制代码

        通过宏定义来配置使用内部SRAM还是外部的SDRAM做为emWin的动态内存，当配置：
#define EX_SRAM    1 表示使用外部SDRAM作为emWin动态内存，大小8MB。
#define EX_SRAM    0 表示使用内部SRAM作为emWin动态内存，大小100KB。
默认情况下，本教程配套的所有emWin例子都是用外部SDRAM作为emWin动态内存。
STemWin底层接口配置：
        LCDConf_Lin_Template.c文件中共12项emWin配置：

1. /*
2. **********************************************************************************************************
3.                                           用户可以配置的选项
4. **********************************************************************************************************
5. */
6. /* 0. 在官方代码的基础上再做优化，官方的部分函数效率低，耗内存, 0表示优化 */
7. #define emWin_Optimize   0
9. /*
10.   1. 显示屏的物理分辨率，驱动已经做了显示屏自适应，支持4.3寸，5寸和7寸屏
11.      这里填写自适应显示屏中的最大分辨率。
12. */
13. #define XSIZE_PHYS       800
14. #define YSIZE_PHYS       480
16. /* 2. 多缓冲 / 虚拟屏，多缓冲和虚拟屏不可同时使用，emWin不支持 */
17. #define NUM_BUFFERS      3 /* 定义多缓冲个数，仅可以设置1,2和3，也就是最大支持三缓冲 */
18. #define NUM_VSCREENS     1 /* 定义虚拟屏个数 */
20. /* 3. 没有图层激活时，背景色设置, 暂时未用到 */
21. #define BK_COLOR         GUI_DARKBLUE
23. /*
24.    4. 重定义图层数，对于STM32F429/439，用户可以选择一个图层或者两个图层，不支持三图层
25.       (1). 设置GUI_NUM_LAYERS = 1时，即仅使用图层1时，默认触摸值是发送给图层1的。
26.        (2). 设置GUI_NUM_LAYERS = 2时，即图层1和图层2都已经使能，此时图层2是顶层，
27.             用户需要根据自己的使用情况设置如下两个地方。
28.             a. 在bsp_touch.c文件中的函数TOUCH_InitHard里面设置参数State.Layer = 1，1就表示
29.                给图层2发送触摸值。
30.             b. 调用GUI_Init函数后，调用函数GUI_SelectLayer(1), 设置当前操作的是图层2。
31. */
32. #undef  GUI_NUM_LAYERS
33. #define GUI_NUM_LAYERS    1
35. /*
36.    5. 设置图层1和图层2对应的显存地址
37.       (1) EXT_SDRAM_ADDR 是SDRAM的首地址。
38.       (2) LCD_LAYER0_FRAME_BUFFER 是图层1的显存地址。
39.        (3) LCD_LAYER1_FRAME_BUFFER 是图层2的显存地址。
40.        (4) 每个图层的显存大小比较考究，这里进行下简单的说明。
41.            如果用户选择的颜色模式 = 32位色ARGB8888，显存的大小：
42.            XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS * NUM_BUFFERS
43.          
44.            颜色模式 = 24位色RGB888，显存的大小：
45.            XSIZE_PHYS * YSIZE_PHYS * 3 * NUM_VSCREENS * NUM_BUFFERS
46.          
47.            颜色模式 = 16位色RGB566，ARGB1555, ARGB4444，AL88，那么显存的大小就是：
48.            XSIZE_PHYS * YSIZE_PHYS * 2 * NUM_VSCREENS * NUM_BUFFERS
50.            颜色模式 = 8位色L8，AL44，那么显存的大小就是：
51.            XSIZE_PHYS * YSIZE_PHYS * 1 * NUM_VSCREENS * NUM_BUFFERS  
52.      
53.       这里为了方便起见，将开发板配套的16MB的SDRAM前8MB分配给LCD显存使用，后8MB用于emWin动态内存。
54.        对于24位色，16位色，8位色，用户可以对其使能三缓冲，并且使能双图层。但是32位色也使能三缓冲和双
55.        图层的话会超出8MB，所以用户根据自己的情况做显存和emWin动态内存的分配调整。
56.          举一个例子，对于800*480分辨率的显示屏，使能32位色，三缓冲，那么最终一个图层需要的大小就是
57.       800 * 480 * 4 * 3  = 4.394MB的空间，如果是双图层，已经超出8MB的分配范围。
58.      
59.       (5)为了方便起见，图层2的宏定义LCD_LAYER1_FRAME_BUFFER中的参数4是按照32位色设置的，如果用户的图层1
60.          使用的是8位色，这里填数字1,如果是16位色，这里填2，如果是24位色，这里填3。
61. */
62. #define LCD_LAYER0_FRAME_BUFFER  EXT_SDRAM_ADDR
63. #define LCD_LAYER1_FRAME_BUFFER  (LCD_LAYER0_FRAME_BUFFER + XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS *
64. NUM_BUFFERS)
66. /*
67.    6. STM32F429/439支持的颜色模式，所有模式都支持，用户可任意配置。
68.       特别注意如下两个问题：
69.        (1) 如果用户选择了ARGB8888或者RGB888模式，LCD闪烁比较厉害的话，
70.            请降低LTDC的时钟大小，在文件bsp_tft_429.c的函数LCD_ConfigLTDC里面设置。
71.            a. 一般800*480分辨率的显示屏，ARGB8888或者RGB888模式LTDC时钟选择10-20MHz即可。
72.            b. 480*272分辨率的可以高些，取20MHz左右即可。
73.        (2) 16位色或者8位色模式，LTDC的时钟频率一般可以比24位色或者32位色的高一倍。
74. */
75. #define _CM_ARGB8888      1
76. #define _CM_RGB888        2
77. #define _CM_RGB565        3
78. #define _CM_ARGB1555      4
79. #define _CM_ARGB4444      5
80. #define _CM_L8            6
81. #define _CM_AL44          7
82. #define _CM_AL88          8
84. /* 7. 配置图层1的颜色模式和分辨率大小 */
85. #define COLOR_MODE_0      _CM_RGB565
86. #define XSIZE_0           XSIZE_PHYS
87. #define YSIZE_0           YSIZE_PHYS
89. /* 8. 配置图层2的的颜色模式和分辨率大小 */
90. #define COLOR_MODE_1      _CM_RGB565
91. #define XSIZE_1           XSIZE_PHYS
92. #define YSIZE_1           YSIZE_PHYS
94. /* 9. 单图层情况下，根据用户选择的颜色模式可自动选择图层1的emWin的驱动和颜色模式 */
95. #if   (COLOR_MODE_0 == _CM_ARGB8888)
96.   #define COLOR_CONVERSION_0 GUICC_M8888I
97.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_32
98. #elif (COLOR_MODE_0 == _CM_RGB888)
99.   #define COLOR_CONVERSION_0 GUICC_M888
100.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_24
101. #elif (COLOR_MODE_0 == _CM_RGB565)
102.   #define COLOR_CONVERSION_0 GUICC_M565
103.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
104. #elif (COLOR_MODE_0 == _CM_ARGB1555)
105.   #define COLOR_CONVERSION_0 GUICC_M1555I
106.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
107. #elif (COLOR_MODE_0 == _CM_ARGB4444)
108.   #define COLOR_CONVERSION_0 GUICC_M4444I
109.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
110. #elif (COLOR_MODE_0 == _CM_L8)
111.   #define COLOR_CONVERSION_0 GUICC_8666
112.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
113. #elif (COLOR_MODE_0 == _CM_AL44)
114.   #define COLOR_CONVERSION_0 GUICC_1616I
115.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
116. #elif (COLOR_MODE_0 == _CM_AL88)
117.   #define COLOR_CONVERSION_0 GUICC_88666I
118.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
119. #else
120.   #error Illegal color mode 0!
121. #endif
123. /* 10. 双图层情况下，根据用户选择的颜色模式可自动选择图层2的emWin的驱动和颜色模式 */
124. #if (GUI_NUM_LAYERS > 1)
126. #if   (COLOR_MODE_1 == _CM_ARGB8888)
127.   #define COLOR_CONVERSION_1 GUICC_M8888I
128.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_32
129. #elif (COLOR_MODE_1 == _CM_RGB888)
130.   #define COLOR_CONVERSION_1 GUICC_M888
131.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_24
132. #elif (COLOR_MODE_1 == _CM_RGB565)
133.   #define COLOR_CONVERSION_1 GUICC_M565
134.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
135. #elif (COLOR_MODE_1 == _CM_ARGB1555)
136.   #define COLOR_CONVERSION_1 GUICC_M1555I
137.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
138. #elif (COLOR_MODE_1 == _CM_ARGB4444)
139.   #define COLOR_CONVERSION_1 GUICC_M4444I
140.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
141. #elif (COLOR_MODE_1 == _CM_L8)
142.   #define COLOR_CONVERSION_1 GUICC_8666
143.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
144. #elif (COLOR_MODE_1 == _CM_AL44)
145.   #define COLOR_CONVERSION_1 GUICC_1616I
146.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
147. #elif (COLOR_MODE_1 == _CM_AL88)
148.   #define COLOR_CONVERSION_1 GUICC_88666I
149.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
150. #else
151.   #error Illegal color mode 1!
152. #endif
154. #else
156. #undef XSIZE_0
157. #undef YSIZE_0
158. #define XSIZE_0       XSIZE_PHYS
159. #define YSIZE_0       YSIZE_PHYS
161. #endif
163. /*11. 配置选项检测，防止配置错误或者某些选项没有配置 */
164. #ifndef   XSIZE_PHYS
165.   #error Physical X size of display is not defined!
166. #endif
167. #ifndef   YSIZE_PHYS
168.   #error Physical Y size of display is not defined!
169. #endif
170. #ifndef   NUM_VSCREENS
171.   #define NUM_VSCREENS 1
172. #else
173.   #if (NUM_VSCREENS <= 0)
174.     #error At least one screeen needs to be defined!
175.   #endif
176. #endif
177. #if (NUM_VSCREENS > 1) && (NUM_BUFFERS > 1)
178.   #error Virtual screens and multiple buffers are not allowed!
179. #endif

复制代码

        对于这12个配置选项，注释说明已经比较详细。默认情况下，本教程配套的emWin例子都是用的三缓冲，RGB565格式，且仅使用单图层。
程序设计：
任务栈大小分配：
         μCOS-III任务栈大小在os_cfg.h文件中配置：
#define  APP_CFG_TASK_START_STK_SIZE                     512u
#define  APP_CFG_TASK_MsgPro_STK_SIZE                    512u
#define  APP_CFG_TASK_COM_STK_SIZE                       512u
#define  APP_CFG_TASK_USER_IF_STK_SIZE                    512u
#define  APP_CFG_TASK_GUI_STK_SIZE                        1024u
        任务栈大小的单位是4字节，那么每个任务的栈大小如下：
App Task Start   任务：2048字节。
       App Task MspPro任务 ：2048字节。
       App Task UserIF  任务：2048字节。
       App Task COM   任务：2048字节。
App Task GUI    任务：4096字节。
系统栈大小分配：
        μCOS-III的系统栈大小在os_cfg_app.h文件中配置：
        #define  OS_CFG_ISR_STK_SIZE                      512u      
          系统栈大小的单位是4字节，那么这里就是配置系统栈大小为2KB。
μCOS-III初始化：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main(void)
10. {
11.     OS_ERR  err;
12.    
13.      /* 初始化uC/OS-III 内核 */
14.     OSInit(&err);
16.      /* 创建一个启动任务（也就是主任务）。启动任务会创建所有的应用程序任务 */
17.      OSTaskCreate((OS_TCB       *)&AppTaskStartTCB,  /* 任务控制块地址 */           
18.                  (CPU_CHAR     *)"App Task Start",  /* 任务名 */
19.                  (OS_TASK_PTR   )AppTaskStart,      /* 启动任务函数地址 */
20.                  (void         *)0,                 /* 传递给任务的参数 */
21.                  (OS_PRIO       )APP_CFG_TASK_START_PRIO, /* 任务优先级 */
22.                  (CPU_STK      *)&AppTaskStartStk[0],     /* 堆栈基地址 */
23.                  (CPU_STK_SIZE  )APP_CFG_TASK_START_STK_SIZE / 10, /* 堆栈监测区，这里表示后10%作为监测区 */
24.                  (CPU_STK_SIZE  )APP_CFG_TASK_START_STK_SIZE,      /* 堆栈空间大小 */
25.                  (OS_MSG_QTY    )0,  /* 本任务支持接受的最大消息数 */
26.                  (OS_TICK       )0,  /* 设置时间片 */
27.                  (void         *)0,  /* 堆栈空间大小 */
28.                  (OS_OPT        )(OS_OPT_TASK_STK_CHK | OS_OPT_TASK_STK_CLR),
29.         
30.                     /*  定义如下：
31.                        OS_OPT_TASK_STK_CHK      使能检测任务栈，统计任务栈已用的和未用的
32.                        OS_OPT_TASK_STK_CLR      在创建任务时，清零任务栈
33.                        OS_OPT_TASK_SAVE_FP      如果CPU有浮点寄存器，则在任务切换时保存浮点寄存器的内容
34.                     */
35.                  (OS_ERR       *)&err);
37.      /* 启动多任务系统，控制权交给uC/OS-III */
38.     OSStart(&err);                                             
39.    
40.     (void)&err;
41.    
42.     return (0);
43. }

复制代码

硬件外设初始化
        硬件外设的初始化是在bsp.c文件实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: bsp_Init
4. *    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
5. *    形    参：无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void bsp_Init(void)
10. {
11.      /*
12.          由于ST固件库的启动文件已经执行了CPU系统时钟的初始化，所以不必再次重复配置系统时钟。
13.          启动文件配置了CPU主时钟频率、内部Flash访问速度和可选的外部SRAM FSMC初始化。
15.          系统时钟缺省配置为168MHz，如果需要更改，可以修改 system_stm32f4xx.c 文件
16.      */
17.      /* 使能CRC 因为使用STemWin前必须要使能 */
18.     RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_CRC, ENABLE);
19.    
20.      /* 优先级分组设置为4，可配置0-15级抢占式优先级，0级子优先级，即不存在子优先级。*/
21.      NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);
22.    
23.      SystemCoreClockUpdate();    /* 根据PLL配置更新系统时钟频率变量 SystemCoreClock */
25.      bsp_InitUart();        /* 初始化串口 */
26.      bsp_InitKey();         /* 初始化按键变量（必须在 bsp_InitTimer() 之前调用） */
27.    
28.      bsp_InitExtIO();       /* FMC总线上扩展了32位输出IO, 操作LED等外设必须初始化 */
29.      bsp_InitLed();         /* 初始LED指示灯端口 */
30.    
31.      bsp_InitI2C();         /* 配置I2C总线 */
32.      bsp_InitSPIBus();       /* 配置SPI总线 */
33.    
34.      bsp_InitSFlash();       /* 初始化SPI Flash */
35.    
36.      bsp_InitExtSDRAM();   /* 初始化SDRAM */
37.      bsp_DetectLcdType();  /* 检测触摸板和LCD面板型号, 结果存在全局变量 g_TouchType, g_LcdType */
38.    
39.      TOUCH_InitHard();    /* 初始化配置触摸芯片 */
40.      LCD_ConfigLTDC();     /* 初始化配置LTDC */
41.    
42.      result = f_mount(&fs, "0:/", 0);     /* 挂载文件系统 */
43. }

复制代码

五个μCOS-III任务的实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskStart
4. *    功能说明: 这是一个启动任务，在多任务系统启动后，必须初始化滴答计数器。本任务主要实现按键和触摸检测。
5. *    形    参: p_arg 是在创建该任务时传递的形参
6. *    返 回 值: 无
7.      优 先 级: 2
8. *********************************************************************************************************
9. */
10. static  void  AppTaskStart (void *p_arg)
11. {
12.      OS_ERR      err;
13.      uint8_t  ucCount = 0;
14.      uint8_t  ucCount1 = 0;
15.    
16.     /* 仅用于避免编译器告警，编译器不会产生任何目标代码 */  
17.     (void)p_arg;
18.    
19.      /* BSP 初始化。 BSP = Board Support Package 板级支持包，可以理解为底层驱动。*/
20.      CPU_Init();  /* 此函数要优先调用，因为外设驱动中使用的us和ms延迟是基于此函数的 */
21.      bsp_Init();      
22.      BSP_Tick_Init();
23.    
24. #if OS_CFG_STAT_TASK_EN > 0u
25.      OSStatTaskCPUUsageInit(&err);  
26. #endif
28. #ifdef CPU_CFG_INT_DIS_MEAS_EN
29.     CPU_IntDisMeasMaxCurReset();
30. #endif
31.         
32.      /* 创建应用程序的任务 */
33.      AppTaskCreate();
34.    
35.      /* 创建任务通信 */
36.      AppObjCreate();
37.    
38.     while(1)
39.     {
40.          /* 1ms一次触摸扫描，电阻触摸屏 */
41.          if(g_tTP.Enable == 1)
42.          {
43.               TOUCH_Scan();
44.             
45.               /* 按键扫描 */
46.               ucCount++;
47.               if(ucCount == 10)
48.               {
49.                    ucCount = 0;
50.                    bsp_KeyScan();
51.               }
52.              OSTimeDly(1, OS_OPT_TIME_DLY, &err);         
53.          }
54.         
55.          /* 20ms一次触摸扫描，电容触摸屏GT811
56.              GT811取20ms比较稳定，取10ms偶尔会有跳动。
57.          */
58.          if(g_GT811.Enable == 1)
59.          {
60.               bsp_KeyScan();
61.               ucCount1++;
62.               if(ucCount1 == 2)
63.               {
64.                    ucCount1 = 0;
65.                    GT811_OnePiontScan();
66.               }
67.              OSTimeDly(10, OS_OPT_TIME_DLY, &err);     
68.          }
69.         
70.          /* 10ms一次触摸扫描，电容触摸屏FT5X06 */
71.          if(g_tFT5X06.Enable == 1)
72.          {
73.               bsp_KeyScan();
74.               FT5X06_OnePiontScan();
75.              OSTimeDly(10, OS_OPT_TIME_DLY, &err);
76.          }
77.     }   
78. }
80. /*
81. *********************************************************************************************************
82. *    函 数 名: AppTaskMsgPro
83. *    功能说明: 实现截图功能，将图片以BMP格式保存到SD卡中
84. *    形    参: p_arg 是在创建该任务时传递的形参
85. *    返 回 值: 无
86.      优 先 级: 3
87. *********************************************************************************************************
88. */
89. static void AppTaskMsgPro(void *p_arg)
90. {
91.      uint32_t ulStart, ulEnd;
92.      OS_ERR      err;
93.      uint8_t       Pic_Name = 0;
94.      char buf[20];
96.      (void)p_arg;
97.          
98.      while(1)
99.      {   
100.           /* 等待获取信号量同步消息，接收到后执行串口打印 */
101.          OSSemPend((OS_SEM *)&SEM_SYNCH,
102.                      (OS_TICK )0,
103.                      (OS_OPT  )OS_OPT_PEND_BLOCKING,
104.                      (CPU_TS  )0,
105.                      (OS_ERR *)&err);
106.         
107.          if(err == OS_ERR_NONE)
108.          {   
109.               sprintf(buf,"0:/PicSave/%d.bmp",Pic_Name);
110.             
111.               /* 记录截图前起始时间 */
112.               ulStart = OSTimeGet(&err);
113.             
114.               /* 开启调度锁 */
115.               OSSchedLock(&err);
116.             
117.               /* 如果SD卡中没有PicSave文件，会进行创建 */
118.               result = f_mkdir("0:/PicSave");
119.             
120.               /* 创建截图 */
121.               result = f_open(&file,buf, FA_WRITE|FA_CREATE_ALWAYS);
122.             
123.               /* 向SD卡绘制BMP图片 */
124.               GUI_BMP_Serialize(_WriteByte2File, &file);
125.             
126.               /* 创建完成后关闭file */
127.              result = f_close(&file);
128.             
129.               /* 开启调度锁 */
130.               OSSchedUnlock(&err);
131.             
132.               /* 记录截图后时间并获取截图过程耗时 */
133.               ulEnd = OSTimeGet(&err);
134.               ulEnd -= ulStart;
135.             
136.               App_Printf("截图完成，耗时 = %dms\\r\\n", ulEnd);
137.               Pic_Name++;      
138.          }                                                                                                                  
139.      }  
140. }
142. /*
143. *********************************************************************************************************
144. *    函 数 名: AppTaskUserIF
145. *    功能说明: 按键消息处理
146. *    形    参: p_arg 是在创建该任务时传递的形参
147. *    返 回 值: 无
148.      优 先 级: 4
149. *********************************************************************************************************
150. */
151. static void AppTaskUserIF(void *p_arg)
152. {
153.      OS_ERR      err;
154.      uint8_t  ucKeyCode;
155.    
156.      (void)p_arg;                /* 避免编译器报警 */
157.    
159.      while (1)
160.      {      
161.          ucKeyCode = bsp_GetKey();
162.         
163.          if (ucKeyCode != KEY_NONE)
164.          {
165.               switch (ucKeyCode)
166.               {
167.                    case KEY_DOWN_K1:             /* K1键按下 打印任务执行情况 */
168.                        DispTaskInfo();        
169.                        break;
170.                   
171.                    case KEY_DOWN_K2:             /* K2键按下 向消息队列发送数据 */
172.                        OSSemPost((OS_SEM *)&SEM_SYNCH,
173.                                   (OS_OPT  )OS_OPT_POST_1,
174.                                   (OS_ERR *)&err);
175.                        break;
176.                   
177.                    default:                     /* 其他的键值不处理 */
178.                        break;
179.               }
180.          }
181.         
182.          OSTimeDly(20, OS_OPT_TIME_DLY, &err);
183.      }
184. }
186. /*
187. *********************************************************************************************************
188. *    函 数 名: AppTaskCom
189. *    功能说明: 暂未使用
190. *    形    参: p_arg 是在创建该任务时传递的形参
191. *    返 回 值: 无
192.      优 先 级: 5
193. *********************************************************************************************************
194. */
195. static void AppTaskCOM(void *p_arg)
196. {
197.      OS_ERR  err;      
198.    
199.      (void)p_arg;
200.    
201.      while(1)
202.      {   
203.          OSTimeDly(500, OS_OPT_TIME_DLY, &err);
204.      }                                                                                                
205. }
207. /*
208. *********************************************************************************************************
209. *    函 数 名: AppTaskGUI
210. *    功能说明: GUI任务，最低优先级                        
211. *    形    参：p_arg 是在创建该任务时传递的形参
212. *    返 回 值: 无
213. *   优 先 级：OS_CFG_PRIO_MAX - 4u
214. *********************************************************************************************************
215. */
216. static void AppTaskGUI(void *p_arg)
217. {
218.     (void)p_arg;       /* 避免编译器告警 */
219.         
220.      while (1)
221.      {
222.          MainTask();
223.      }
224. }

复制代码

emWin任务的具体实现（在MainTask.c文件里面）：

1. #include "MainTask.h"
2. #include "includes.h"
6. /*
7. *********************************************************************************************************
8. *                             添加到多页控件第一个页面窗口的对话框
9. *********************************************************************************************************
10. */
11. /*
12. *********************************************************************************************************
13. *                                         宏定义
14. *********************************************************************************************************
15. */
16. #define ID_WINDOW_01 (GUI_ID_USER + 0x10)
17. #define ID_BUTTON_01 (GUI_ID_USER + 0x11)
20. /*
21. *********************************************************************************************************
22. *                           GUI_WIDGET_CREATE_INFO类型数组
23. *********************************************************************************************************
24. */
25. static const GUI_WIDGET_CREATE_INFO _aDialogCreatePage1[] =
26. {
27.      { WINDOW_CreateIndirect, "Window", ID_WINDOW_01, 0, 0, 400, 200, 0, 0x0, 0 },
28.      { BUTTON_CreateIndirect, "Button", ID_BUTTON_01, 127, 68, 129, 43, 0, 0x0, 0 },
29. };
31. /*
32. *********************************************************************************************************
33. *    函 数 名: _cbDialogPage1
34. *    功能说明: 对话框回调函数        
35. *    形    参: pMsg  回调参数
36. *    返 回 值: 无
37. *********************************************************************************************************
38. */
39. static void _cbDialogPage1(WM_MESSAGE * pMsg)
40. {
41.      WM_HWIN hItem;
42.      int     NCode;
43.      int     Id;
46.      switch (pMsg->MsgId)
47.      {
48.          case WM_INIT_DIALOG:
49.             
50.               //
51.               // 初始化按钮控件
52.               //
53.               hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_01);
54.               BUTTON_SetFont(hItem, GUI_FONT_16B_ASCII);
55.               BUTTON_SetText(hItem, "LED1");
56.               break;
57.         
58.          case WM_NOTIFY_PARENT:
59.               Id    = WM_GetId(pMsg->hWinSrc);
60.               NCode = pMsg->Data.v;
61.               switch(Id)
62.               {
63.                    case ID_BUTTON_01:
64.                    switch(NCode)
65.                    {
66.                        case WM_NOTIFICATION_CLICKED:
67.                             bsp_LedToggle(1);
68.                             break;
69.                      
70.                        case WM_NOTIFICATION_RELEASED:
71.                             break;
72.                    }
73.                    break;
74.               }
75.               break;
76.             
77.          default:
78.               WM_DefaultProc(pMsg);
79.               break;
80.      }
81. }
83. /*
84. *********************************************************************************************************
85. *    函 数 名: CreateWindowPage1
86. *    功能说明: 创建对话框      
87. *    形    参: 无
88. *    返 回 值: 返回对话框句柄
89. *********************************************************************************************************
90. */
91. WM_HWIN CreateWindowPage1(void)
92. {
93.      WM_HWIN hWin;
95.      hWin = GUI_CreateDialogBox(_aDialogCreatePage1, GUI_COUNTOF(_aDialogCreatePage1), _cbDialogPage1,
96. WM_HBKWIN, 0, 0);
97.      return hWin;
98. }
100. /*
101. *********************************************************************************************************
102. *                             添加到多页控件第二个页面窗口的对话框
103. *********************************************************************************************************
104. */
105. /*
106. *********************************************************************************************************
107. *                                         宏定义
108. *********************************************************************************************************
109. */
110. #define ID_WINDOW_02 (GUI_ID_USER + 0x20)
111. #define ID_BUTTON_02 (GUI_ID_USER + 0x21)
114. /*
115. *********************************************************************************************************
116. *                           GUI_WIDGET_CREATE_INFO类型数组
117. *********************************************************************************************************
118. */
119. static const GUI_WIDGET_CREATE_INFO _aDialogCreatePage2[] =
120. {
121.      { WINDOW_CreateIndirect, "Window", ID_WINDOW_02, 0, 0, 400, 200, 0, 0x0, 0 },
122.      { BUTTON_CreateIndirect, "Button", ID_BUTTON_02, 127, 68, 129, 43, 0, 0x0, 0 },
123. };
125. /*
126. *********************************************************************************************************
127. *    函 数 名: _cbDialogPage1
128. *    功能说明: 对话框回调函数        
129. *    形    参: pMsg  回调参数
130. *    返 回 值: 无
131. *********************************************************************************************************
132. */
133. static void _cbDialogPage2(WM_MESSAGE * pMsg)
134. {
135.      WM_HWIN hItem;
136.      int     NCode;
137.      int     Id;
140.      switch (pMsg->MsgId)
141.      {
142.          case WM_INIT_DIALOG:
143.             
144.               //
145.               // 初始化按钮控件
146.               //
147.               hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_02);
148.               BUTTON_SetFont(hItem, GUI_FONT_16B_ASCII);
149.               BUTTON_SetText(hItem, "LED2");
150.               break;
151.         
152.          case WM_NOTIFY_PARENT:
153.               Id    = WM_GetId(pMsg->hWinSrc);
154.               NCode = pMsg->Data.v;
155.               switch(Id)
156.               {
157.                    case ID_BUTTON_02:
158.                    switch(NCode)
159.                    {
160.                        case WM_NOTIFICATION_CLICKED:
161.                             bsp_LedToggle(2);
162.                             break;
163.                      
164.                        case WM_NOTIFICATION_RELEASED:
165.                             break;
166.                    }
167.                    break;
168.               }
169.               break;
170.             
171.          default:
172.               WM_DefaultProc(pMsg);
173.               break;
174.      }
175. }
177. /*
178. *********************************************************************************************************
179. *    函 数 名: CreateWindowPage2
180. *    功能说明: 创建对话框      
181. *    形    参: 无
182. *    返 回 值: 返回对话框句柄
183. *********************************************************************************************************
184. */
185. WM_HWIN CreateWindowPage2(void)
186. {
187.      WM_HWIN hWin;
189.      hWin = GUI_CreateDialogBox(_aDialogCreatePage2, GUI_COUNTOF(_aDialogCreatePage2), _cbDialogPage2,
190. WM_HBKWIN, 0, 0);
191.      return hWin;
192. }
194. /*
195. *********************************************************************************************************
196. *                             添加到多页控件第三个页面窗口的对话框
197. *********************************************************************************************************
198. */
199. /*
200. *********************************************************************************************************
201. *                                         宏定义
202. *********************************************************************************************************
203. */
204. #define ID_WINDOW_03 (GUI_ID_USER + 0x30)
205. #define ID_BUTTON_03 (GUI_ID_USER + 0x31)
208. /*
209. *********************************************************************************************************
210. *                           GUI_WIDGET_CREATE_INFO类型数组
211. *********************************************************************************************************
212. */
213. static const GUI_WIDGET_CREATE_INFO _aDialogCreatePage3[] =
214. {
215.      { WINDOW_CreateIndirect, "Window", ID_WINDOW_03, 0, 0, 400, 200, 0, 0x0, 0 },
216.      { BUTTON_CreateIndirect, "Button", ID_BUTTON_03, 127, 68, 129, 43, 0, 0x0, 0 },
217. };
219. /*
220. *********************************************************************************************************
221. *    函 数 名: _cbDialogPage3
222. *    功能说明: 对话框回调函数        
223. *    形    参: pMsg  回调参数
224. *    返 回 值: 无
225. *********************************************************************************************************
226. */
227. static void _cbDialogPage3(WM_MESSAGE * pMsg)
228. {
229.      WM_HWIN hItem;
230.      int     NCode;
231.      int     Id;
234.      switch (pMsg->MsgId)
235.      {
236.          case WM_INIT_DIALOG:
237.             
238.               //
239.               // 初始化按钮控件
240.               //
241.               hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_03);
242.               BUTTON_SetFont(hItem, GUI_FONT_16B_ASCII);
243.               BUTTON_SetText(hItem, "LED3");
244.               break;
245.         
246.          case WM_NOTIFY_PARENT:
247.               Id    = WM_GetId(pMsg->hWinSrc);
248.               NCode = pMsg->Data.v;
249.               switch(Id)
250.               {
251.                    case ID_BUTTON_03:
252.                    switch(NCode)
253.                    {
254.                        case WM_NOTIFICATION_CLICKED:
255.                             bsp_LedToggle(3);
256.                             break;
257.                      
258.                        case WM_NOTIFICATION_RELEASED:
259.                             break;
260.                    }
261.                    break;
262.               }
263.               break;
264.             
265.          default:
266.               WM_DefaultProc(pMsg);
267.               break;
268.      }
269. }
271. /*
272. *********************************************************************************************************
273. *    函 数 名: CreateWindowPage3
274. *    功能说明: 创建对话框      
275. *    形    参: 无
276. *    返 回 值: 返回对话框句柄
277. *********************************************************************************************************
278. */
279. WM_HWIN CreateWindowPage3(void)
280. {
281.      WM_HWIN hWin;
283.      hWin = GUI_CreateDialogBox(_aDialogCreatePage3, GUI_COUNTOF(_aDialogCreatePage3), _cbDialogPage3,
284. WM_HBKWIN, 0, 0);
285.      return hWin;
286. }
288. /*
289. *********************************************************************************************************
290. *                                         宏定义
291. *********************************************************************************************************
292. */
293. #define ID_FRAMEWIN_0  (GUI_ID_USER + 0x00)
294. #define ID_MULTIPAGE_0 (GUI_ID_USER + 0x01)
297. /*
298. *********************************************************************************************************
299. *                           GUI_WIDGET_CREATE_INFO类型数组
300. *********************************************************************************************************
301. */
302. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
303. {
304.      { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 800, 480, 0, 0x0, 0 },
305.      { MULTIPAGE_CreateIndirect, "Multipage", ID_MULTIPAGE_0, 23, 25, 400, 240, 0, 0x0, 0 },
306. };
308. /*
309. *********************************************************************************************************
310. *    函 数 名: _cbDialog
311. *    功能说明: 对话框回调函数        
312. *    形    参: pMsg  回调参数
313. *    返 回 值: 无
314. *********************************************************************************************************
315. */
316. static void _cbDialog(WM_MESSAGE * pMsg)
317. {
318.      WM_HWIN hItem;
319.      WM_HWIN hWinPage;
320.      int     NCode;
321.      int     Id;
323.      switch (pMsg->MsgId)
324.      {
325.          case WM_INIT_DIALOG:
326.             
327.               //
328.               // 初始化框架窗口
329.               //
330.               hItem = pMsg->hWin;
331.               FRAMEWIN_SetFont(hItem, GUI_FONT_32B_ASCII);
332. FRAMEWIN_SetText(hItem, "armfly")
333.               FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
334.         
335.               //
336.               // 初始化多页控件
337.               //
338.               hItem = WM_GetDialogItem(pMsg->hWin, ID_MULTIPAGE_0);
339.               MULTIPAGE_SetFont(hItem, GUI_FONT_16_ASCII);
341.               hWinPage = CreateWindowPage1();
342.               MULTIPAGE_AddEmptyPage(hItem, hWinPage, "STM32-V4");
344.               hWinPage = CreateWindowPage2();
345.               MULTIPAGE_AddEmptyPage(hItem, hWinPage, "STM32-V5");
347.               hWinPage = CreateWindowPage3();
348.               MULTIPAGE_AddEmptyPage(hItem, hWinPage, "STM32-V6");
349.               break;
350.         
351.          case WM_NOTIFY_PARENT:
352.               Id    = WM_GetId(pMsg->hWinSrc);
353.               NCode = pMsg->Data.v;
354.               switch(Id)
355.               {
356.                    case ID_MULTIPAGE_0:
357.                    switch(NCode)
358.                    {
359.                        case WM_NOTIFICATION_CLICKED:
360.                             break;
361.                      
362.                        case WM_NOTIFICATION_RELEASED:
363.                             break;
364.                      
365.                        case WM_NOTIFICATION_MOVED_OUT:
366.                             break;
367.                      
368.                        case WM_NOTIFICATION_VALUE_CHANGED:
369.                             break;
370.                    }
371.                   break;
372.               }
373.               break;
374.             
375.          default:
376.               WM_DefaultProc(pMsg);
377.               break;
378.      }
379. }
381. /*
382. *********************************************************************************************************
383. *    函 数 名: CreateFramewin
384. *    功能说明: 创建对话框      
385. *    形    参: 无
386. *    返 回 值: 返回对话框句柄
387. *********************************************************************************************************
388. */
389. WM_HWIN CreateFramewin(void)
390. {
391.      WM_HWIN hWin;
393.      hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), _cbDialog, WM_HBKWIN, 0, 0);
394.      return hWin;
395. }
397. /*
398. *********************************************************************************************************
399. *    函 数 名: MainTask
400. *    功能说明: GUI主函数
401. *    形    参: 无
402. *    返 回 值: 无
403. *********************************************************************************************************
404. */
405. void MainTask(void)
406. {
407.    
408.      /* 初始化 */
409.      GUI_Init();
410.    
411.      /*
412.       关于多缓冲和窗口内存设备的设置说明
413.         1. 使能多缓冲是调用的如下函数，用户要在LCDConf_Lin_Template.c文件中配置了多缓冲，调用此函数才有效：
414.            WM_MULTIBUF_Enable(1);
415.         2. 窗口使能使用内存设备是调用函数：WM_SetCreateFlags(WM_CF_MEMDEV);
416.         3. 如果emWin的配置多缓冲和窗口内存设备都支持，二选一即可，且务必优先选择使用多缓冲，实际使用
417.            STM32F429BIT6 + 32位SDRAM + RGB565/RGB888平台测试，多缓冲可以有效的降低窗口移动或者滑动时的撕裂
418.            感，并有效的提高流畅性，通过使能窗口使用内存设备是做不到的。
419.         4. 所有emWin例子默认是开启三缓冲。
420.      */
421.      WM_MULTIBUF_Enable(1);
422.    
423.      /*
424.        触摸校准函数默认是注释掉的，电阻屏需要校准，电容屏无需校准。如果用户需要校准电阻屏的话，执行
425.         此函数即可，会将触摸校准参数保存到EEPROM里面，以后系统上电会自动从EEPROM里面加载。
426.      */
427.     //TOUCH_Calibration();
428.    
429.      /* 创建对话框 */
430.      CreateFramewin();
431.         
432.      while(1)
433.      {
434.          GUI_Delay(50);
435.      }
436. }

复制代码

席萌0209

55.6 实验例程说明（裸机）


配套例子：
        V6-580_STemWin实验_MultiPage多页控件（裸机）
实验目的：
        1.     本实验主要学习多行文本控件的使用。
        2.     emWin功能的实现在MainTask.c文件里面。
实验内容：
        1.     GUI任务主要在对话框上面创建了一个多页控件，控件上创建了三个页面窗口，每个页面窗口，添加了一个对话框。
并且为每个对话框上面都添加了按钮控件，点击按钮控件实现LED的亮灭反转，三个对话框上的按钮控件分别控制的是LED1，LED2和LED3。
STemWin界面显示效果：
        800*480分辨率界面效果。

STemWin动态内存配置：
GUIConf.c文件中的配置如下：

1. #define EX_SRAM   1/*1 used extern sram, 0 used internal sram */
3. #if EX_SRAM
4. #define GUI_NUMBYTES  (1024*1024*8)
5. #else
6. #define GUI_NUMBYTES  (100*1024)
7. #endif

复制代码

        通过宏定义来配置使用内部SRAM还是外部的SDRAM做为emWin的动态内存，当配置：
#define EX_SRAM    1 表示使用外部SDRAM作为emWin动态内存，大小8MB。
#define EX_SRAM    0 表示使用内部SRAM作为emWin动态内存，大小100KB。
默认情况下，本教程配套的所有emWin例子都是用外部SDRAM作为emWin动态内存。
STemWin底层接口配置：
        LCDConf_Lin_Template.c文件中共12项emWin配置：

1. /*
2. **********************************************************************************************************
3.                                           用户可以配置的选项
4. **********************************************************************************************************
5. */
6. /* 0. 在官方代码的基础上再做优化，官方的部分函数效率低，耗内存, 0表示优化 */
7. #define emWin_Optimize   0
9. /*
10.   1. 显示屏的物理分辨率，驱动已经做了显示屏自适应，支持4.3寸，5寸和7寸屏
11.      这里填写自适应显示屏中的最大分辨率。
12. */
13. #define XSIZE_PHYS       800
14. #define YSIZE_PHYS       480
16. /* 2. 多缓冲 / 虚拟屏，多缓冲和虚拟屏不可同时使用，emWin不支持 */
17. #define NUM_BUFFERS      3 /* 定义多缓冲个数，仅可以设置1,2和3，也就是最大支持三缓冲 */
18. #define NUM_VSCREENS     1 /* 定义虚拟屏个数 */
20. /* 3. 没有图层激活时，背景色设置, 暂时未用到 */
21. #define BK_COLOR         GUI_DARKBLUE
23. /*
24.    4. 重定义图层数，对于STM32F429/439，用户可以选择一个图层或者两个图层，不支持三图层
25.       (1). 设置GUI_NUM_LAYERS = 1时，即仅使用图层1时，默认触摸值是发送给图层1的。
26.        (2). 设置GUI_NUM_LAYERS = 2时，即图层1和图层2都已经使能，此时图层2是顶层，
27.             用户需要根据自己的使用情况设置如下两个地方。
28.             a. 在bsp_touch.c文件中的函数TOUCH_InitHard里面设置参数State.Layer = 1，1就表示
29.                给图层2发送触摸值。
30.             b. 调用GUI_Init函数后，调用函数GUI_SelectLayer(1), 设置当前操作的是图层2。
31. */
32. #undef  GUI_NUM_LAYERS
33. #define GUI_NUM_LAYERS    1
35. /*
36.    5. 设置图层1和图层2对应的显存地址
37.       (1) EXT_SDRAM_ADDR 是SDRAM的首地址。
38.       (2) LCD_LAYER0_FRAME_BUFFER 是图层1的显存地址。
39.        (3) LCD_LAYER1_FRAME_BUFFER 是图层2的显存地址。
40.        (4) 每个图层的显存大小比较考究，这里进行下简单的说明。
41.            如果用户选择的颜色模式 = 32位色ARGB8888，显存的大小：
42.            XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS * NUM_BUFFERS
43.          
44.            颜色模式 = 24位色RGB888，显存的大小：
45.            XSIZE_PHYS * YSIZE_PHYS * 3 * NUM_VSCREENS * NUM_BUFFERS
46.          
47.            颜色模式 = 16位色RGB566，ARGB1555, ARGB4444，AL88，那么显存的大小就是：
48.            XSIZE_PHYS * YSIZE_PHYS * 2 * NUM_VSCREENS * NUM_BUFFERS
50.            颜色模式 = 8位色L8，AL44，那么显存的大小就是：
51.            XSIZE_PHYS * YSIZE_PHYS * 1 * NUM_VSCREENS * NUM_BUFFERS  
52.      
53.       这里为了方便起见，将开发板配套的16MB的SDRAM前8MB分配给LCD显存使用，后8MB用于emWin动态内存。
54.        对于24位色，16位色，8位色，用户可以对其使能三缓冲，并且使能双图层。但是32位色也使能三缓冲和双
55.        图层的话会超出8MB，所以用户根据自己的情况做显存和emWin动态内存的分配调整。
56.          举一个例子，对于800*480分辨率的显示屏，使能32位色，三缓冲，那么最终一个图层需要的大小就是
57.       800 * 480 * 4 * 3  = 4.394MB的空间，如果是双图层，已经超出8MB的分配范围。
58.      
59.       (5)为了方便起见，图层2的宏定义LCD_LAYER1_FRAME_BUFFER中的参数4是按照32位色设置的，如果用户的图层1
60.          使用的是8位色，这里填数字1,如果是16位色，这里填2，如果是24位色，这里填3。
61. */
62. #define LCD_LAYER0_FRAME_BUFFER  EXT_SDRAM_ADDR
63. #define LCD_LAYER1_FRAME_BUFFER  (LCD_LAYER0_FRAME_BUFFER + XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS *
64. NUM_BUFFERS)
66. /*
67.    6. STM32F429/439支持的颜色模式，所有模式都支持，用户可任意配置。
68.       特别注意如下两个问题：
69.        (1) 如果用户选择了ARGB8888或者RGB888模式，LCD闪烁比较厉害的话，
70.            请降低LTDC的时钟大小，在文件bsp_tft_429.c的函数LCD_ConfigLTDC里面设置。
71.            a. 一般800*480分辨率的显示屏，ARGB8888或者RGB888模式LTDC时钟选择10-20MHz即可。
72.            b. 480*272分辨率的可以高些，取20MHz左右即可。
73.        (2) 16位色或者8位色模式，LTDC的时钟频率一般可以比24位色或者32位色的高一倍。
74. */
75. #define _CM_ARGB8888      1
76. #define _CM_RGB888        2
77. #define _CM_RGB565        3
78. #define _CM_ARGB1555      4
79. #define _CM_ARGB4444      5
80. #define _CM_L8            6
81. #define _CM_AL44          7
82. #define _CM_AL88          8
84. /* 7. 配置图层1的颜色模式和分辨率大小 */
85. #define COLOR_MODE_0      _CM_RGB565
86. #define XSIZE_0           XSIZE_PHYS
87. #define YSIZE_0           YSIZE_PHYS
89. /* 8. 配置图层2的的颜色模式和分辨率大小 */
90. #define COLOR_MODE_1      _CM_RGB565
91. #define XSIZE_1           XSIZE_PHYS
92. #define YSIZE_1           YSIZE_PHYS
94. /* 9. 单图层情况下，根据用户选择的颜色模式可自动选择图层1的emWin的驱动和颜色模式 */
95. #if   (COLOR_MODE_0 == _CM_ARGB8888)
96.   #define COLOR_CONVERSION_0 GUICC_M8888I
97.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_32
98. #elif (COLOR_MODE_0 == _CM_RGB888)
99.   #define COLOR_CONVERSION_0 GUICC_M888
100.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_24
101. #elif (COLOR_MODE_0 == _CM_RGB565)
102.   #define COLOR_CONVERSION_0 GUICC_M565
103.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
104. #elif (COLOR_MODE_0 == _CM_ARGB1555)
105.   #define COLOR_CONVERSION_0 GUICC_M1555I
106.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
107. #elif (COLOR_MODE_0 == _CM_ARGB4444)
108.   #define COLOR_CONVERSION_0 GUICC_M4444I
109.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
110. #elif (COLOR_MODE_0 == _CM_L8)
111.   #define COLOR_CONVERSION_0 GUICC_8666
112.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
113. #elif (COLOR_MODE_0 == _CM_AL44)
114.   #define COLOR_CONVERSION_0 GUICC_1616I
115.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
116. #elif (COLOR_MODE_0 == _CM_AL88)
117.   #define COLOR_CONVERSION_0 GUICC_88666I
118.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
119. #else
120.   #error Illegal color mode 0!
121. #endif
123. /* 10. 双图层情况下，根据用户选择的颜色模式可自动选择图层2的emWin的驱动和颜色模式 */
124. #if (GUI_NUM_LAYERS > 1)
126. #if   (COLOR_MODE_1 == _CM_ARGB8888)
127.   #define COLOR_CONVERSION_1 GUICC_M8888I
128.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_32
129. #elif (COLOR_MODE_1 == _CM_RGB888)
130.   #define COLOR_CONVERSION_1 GUICC_M888
131.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_24
132. #elif (COLOR_MODE_1 == _CM_RGB565)
133.   #define COLOR_CONVERSION_1 GUICC_M565
134.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
135. #elif (COLOR_MODE_1 == _CM_ARGB1555)
136.   #define COLOR_CONVERSION_1 GUICC_M1555I
137.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
138. #elif (COLOR_MODE_1 == _CM_ARGB4444)
139.   #define COLOR_CONVERSION_1 GUICC_M4444I
140.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
141. #elif (COLOR_MODE_1 == _CM_L8)
142.   #define COLOR_CONVERSION_1 GUICC_8666
143.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
144. #elif (COLOR_MODE_1 == _CM_AL44)
145.   #define COLOR_CONVERSION_1 GUICC_1616I
146.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
147. #elif (COLOR_MODE_1 == _CM_AL88)
148.   #define COLOR_CONVERSION_1 GUICC_88666I
149.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
150. #else
151.   #error Illegal color mode 1!
152. #endif
154. #else
156. #undef XSIZE_0
157. #undef YSIZE_0
158. #define XSIZE_0       XSIZE_PHYS
159. #define YSIZE_0       YSIZE_PHYS
161. #endif
163. /*11. 配置选项检测，防止配置错误或者某些选项没有配置 */
164. #ifndef   XSIZE_PHYS
165.   #error Physical X size of display is not defined!
166. #endif
167. #ifndef   YSIZE_PHYS
168.   #error Physical Y size of display is not defined!
169. #endif
170. #ifndef   NUM_VSCREENS
171.   #define NUM_VSCREENS 1
172. #else
173.   #if (NUM_VSCREENS <= 0)
174.     #error At least one screeen needs to be defined!
175.   #endif
176. #endif
177. #if (NUM_VSCREENS > 1) && (NUM_BUFFERS > 1)
178.   #error Virtual screens and multiple buffers are not allowed!
179. #endif

复制代码

        对于这12个配置选项，注释说明已经比较详细。默认情况下，本教程配套的emWin例子都是用的三缓冲，RGB565格式，且仅使用单图层。
程序设计：
栈大小分配：
         系统栈大小在startup_stm32f429_439xx.s文件中配置：

        栈大小的单位是字节，那么这里配置系统栈大小为8192字节。
主函数初始化：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main (void)
10. {   
11.      /* 初始化外设 */
12.      bsp_Init();
14.      /* 进入emWin主函数 */
15.      MainTask();
16. }

复制代码

硬件外设初始化
        硬件外设的初始化是在bsp.c文件实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: bsp_Init
4. *    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
5. *    形    参：无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void bsp_Init(void)
10. {
11.      /*
12.          由于ST固件库的启动文件已经执行了CPU系统时钟的初始化，所以不必再次重复配置系统时钟。
13.          启动文件配置了CPU主时钟频率、内部Flash访问速度和可选的外部SRAM FSMC初始化。
15.          系统时钟缺省配置为168MHz，如果需要更改，可以修改 system_stm32f4xx.c 文件
16.      */
17.      /* 使能CRC 因为使用STemWin前必须要使能 */
18.     RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_CRC, ENABLE);
19.    
20.      /* 优先级分组设置为4，可配置0-15级抢占式优先级，0级子优先级，即不存在子优先级。*/
21.      NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);
22.    
23.      SystemCoreClockUpdate();    /* 根据PLL配置更新系统时钟频率变量 SystemCoreClock */
25.      bsp_InitUart();        /* 初始化串口 */
26.      bsp_InitKey();         /* 初始化按键变量（必须在 bsp_InitTimer() 之前调用） */
27.    
28.      bsp_InitExtIO();       /* FMC总线上扩展了32位输出IO, 操作LED等外设必须初始化 */
29.      bsp_InitLed();         /* 初始LED指示灯端口 */
30.    
31.      bsp_InitI2C();         /* 配置I2C总线 */
32.      bsp_InitSPIBus();       /* 配置SPI总线 */
33.    
34.      bsp_InitSFlash();       /* 初始化SPI Flash */
35.    
36.      bsp_InitExtSDRAM();   /* 初始化SDRAM */
37.      bsp_DetectLcdType();  /* 检测触摸板和LCD面板型号, 结果存在全局变量 g_TouchType, g_LcdType */
38.    
39.      TOUCH_InitHard();    /* 初始化配置触摸芯片 */
40.      LCD_ConfigLTDC();     /* 初始化配置LTDC */
41.    
42.      result = f_mount(&fs, "0:/", 0);     /* 挂载文件系统 */
43. }

复制代码

emWin功能的具体实现（在MainTask.c文件里面）：

1. #include "MainTask.h"
2. #include "bsp.h"
5. /*
6. *********************************************************************************************************
7. *                             添加到多页控件第一个页面窗口的对话框
8. *********************************************************************************************************
9. */
10. /*
11. *********************************************************************************************************
12. *                                         宏定义
13. *********************************************************************************************************
14. */
15. #define ID_WINDOW_01 (GUI_ID_USER + 0x10)
16. #define ID_BUTTON_01 (GUI_ID_USER + 0x11)
19. /*
20. *********************************************************************************************************
21. *                           GUI_WIDGET_CREATE_INFO类型数组
22. *********************************************************************************************************
23. */
24. static const GUI_WIDGET_CREATE_INFO _aDialogCreatePage1[] =
25. {
26.      { WINDOW_CreateIndirect, "Window", ID_WINDOW_01, 0, 0, 400, 200, 0, 0x0, 0 },
27.      { BUTTON_CreateIndirect, "Button", ID_BUTTON_01, 127, 68, 129, 43, 0, 0x0, 0 },
28. };
30. /*
31. *********************************************************************************************************
32. *    函 数 名: _cbDialogPage1
33. *    功能说明: 对话框回调函数        
34. *    形    参: pMsg  回调参数
35. *    返 回 值: 无
36. *********************************************************************************************************
37. */
38. static void _cbDialogPage1(WM_MESSAGE * pMsg)
39. {
40.      WM_HWIN hItem;
41.      int     NCode;
42.      int     Id;
45.      switch (pMsg->MsgId)
46.      {
47.          case WM_INIT_DIALOG:
48.             
49.               //
50.               // 初始化按钮控件
51.               //
52.               hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_01);
53.               BUTTON_SetFont(hItem, GUI_FONT_16B_ASCII);
54.               BUTTON_SetText(hItem, "LED1");
55.               break;
56.         
57.          case WM_NOTIFY_PARENT:
58.               Id    = WM_GetId(pMsg->hWinSrc);
59.               NCode = pMsg->Data.v;
60.               switch(Id)
61.               {
62.                    case ID_BUTTON_01:
63.                    switch(NCode)
64.                    {
65.                        case WM_NOTIFICATION_CLICKED:
66.                             bsp_LedToggle(1);
67.                             break;
68.                      
69.                        case WM_NOTIFICATION_RELEASED:
70.                             break;
71.                    }
72.                    break;
73.               }
74.               break;
75.             
76.          default:
77.               WM_DefaultProc(pMsg);
78.               break;
79.      }
80. }
82. /*
83. *********************************************************************************************************
84. *    函 数 名: CreateWindowPage1
85. *    功能说明: 创建对话框      
86. *    形    参: 无
87. *    返 回 值: 返回对话框句柄
88. *********************************************************************************************************
89. */
90. WM_HWIN CreateWindowPage1(void)
91. {
92.      WM_HWIN hWin;
94.      hWin = GUI_CreateDialogBox(_aDialogCreatePage1, GUI_COUNTOF(_aDialogCreatePage1), _cbDialogPage1,
95. WM_HBKWIN, 0, 0);
96.      return hWin;
97. }
99. /*
100. *********************************************************************************************************
101. *                             添加到多页控件第二个页面窗口的对话框
102. *********************************************************************************************************
103. */
104. /*
105. *********************************************************************************************************
106. *                                         宏定义
107. *********************************************************************************************************
108. */
109. #define ID_WINDOW_02 (GUI_ID_USER + 0x20)
110. #define ID_BUTTON_02 (GUI_ID_USER + 0x21)
113. /*
114. *********************************************************************************************************
115. *                           GUI_WIDGET_CREATE_INFO类型数组
116. *********************************************************************************************************
117. */
118. static const GUI_WIDGET_CREATE_INFO _aDialogCreatePage2[] =
119. {
120.      { WINDOW_CreateIndirect, "Window", ID_WINDOW_02, 0, 0, 400, 200, 0, 0x0, 0 },
121.      { BUTTON_CreateIndirect, "Button", ID_BUTTON_02, 127, 68, 129, 43, 0, 0x0, 0 },
122. };
124. /*
125. *********************************************************************************************************
126. *    函 数 名: _cbDialogPage1
127. *    功能说明: 对话框回调函数        
128. *    形    参: pMsg  回调参数
129. *    返 回 值: 无
130. *********************************************************************************************************
131. */
132. static void _cbDialogPage2(WM_MESSAGE * pMsg)
133. {
134.      WM_HWIN hItem;
135.      int     NCode;
136.      int     Id;
139.      switch (pMsg->MsgId)
140.      {
141.          case WM_INIT_DIALOG:
142.             
143.               //
144.               // 初始化按钮控件
145.               //
146.               hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_02);
147.               BUTTON_SetFont(hItem, GUI_FONT_16B_ASCII);
148.               BUTTON_SetText(hItem, "LED2");
149.               break;
150.         
151.          case WM_NOTIFY_PARENT:
152.               Id    = WM_GetId(pMsg->hWinSrc);
153.               NCode = pMsg->Data.v;
154.               switch(Id)
155.               {
156.                    case ID_BUTTON_02:
157.                    switch(NCode)
158.                    {
159.                        case WM_NOTIFICATION_CLICKED:
160.                             bsp_LedToggle(2);
161.                             break;
162.                      
163.                        case WM_NOTIFICATION_RELEASED:
164.                             break;
165.                    }
166.                    break;
167.               }
168.               break;
169.             
170.          default:
171.               WM_DefaultProc(pMsg);
172.               break;
173.      }
174. }
176. /*
177. *********************************************************************************************************
178. *    函 数 名: CreateWindowPage2
179. *    功能说明: 创建对话框      
180. *    形    参: 无
181. *    返 回 值: 返回对话框句柄
182. *********************************************************************************************************
183. */
184. WM_HWIN CreateWindowPage2(void)
185. {
186.      WM_HWIN hWin;
188.      hWin = GUI_CreateDialogBox(_aDialogCreatePage2, GUI_COUNTOF(_aDialogCreatePage2), _cbDialogPage2,
189. WM_HBKWIN, 0, 0);
190.      return hWin;
191. }
193. /*
194. *********************************************************************************************************
195. *                             添加到多页控件第三个页面窗口的对话框
196. *********************************************************************************************************
197. */
198. /*
199. *********************************************************************************************************
200. *                                         宏定义
201. *********************************************************************************************************
202. */
203. #define ID_WINDOW_03 (GUI_ID_USER + 0x30)
204. #define ID_BUTTON_03 (GUI_ID_USER + 0x31)
207. /*
208. *********************************************************************************************************
209. *                           GUI_WIDGET_CREATE_INFO类型数组
210. *********************************************************************************************************
211. */
212. static const GUI_WIDGET_CREATE_INFO _aDialogCreatePage3[] =
213. {
214.      { WINDOW_CreateIndirect, "Window", ID_WINDOW_03, 0, 0, 400, 200, 0, 0x0, 0 },
215.      { BUTTON_CreateIndirect, "Button", ID_BUTTON_03, 127, 68, 129, 43, 0, 0x0, 0 },
216. };
218. /*
219. *********************************************************************************************************
220. *    函 数 名: _cbDialogPage3
221. *    功能说明: 对话框回调函数        
222. *    形    参: pMsg  回调参数
223. *    返 回 值: 无
224. *********************************************************************************************************
225. */
226. static void _cbDialogPage3(WM_MESSAGE * pMsg)
227. {
228.      WM_HWIN hItem;
229.      int     NCode;
230.      int     Id;
233.      switch (pMsg->MsgId)
234.      {
235.          case WM_INIT_DIALOG:
236.             
237.               //
238.               // 初始化按钮控件
239.               //
240.               hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_03);
241.               BUTTON_SetFont(hItem, GUI_FONT_16B_ASCII);
242.               BUTTON_SetText(hItem, "LED3");
243.               break;
244.         
245.          case WM_NOTIFY_PARENT:
246.               Id    = WM_GetId(pMsg->hWinSrc);
247.               NCode = pMsg->Data.v;
248.               switch(Id)
249.               {
250.                    case ID_BUTTON_03:
251.                    switch(NCode)
252.                    {
253.                        case WM_NOTIFICATION_CLICKED:
254.                             bsp_LedToggle(3);
255.                             break;
256.                      
257.                        case WM_NOTIFICATION_RELEASED:
258.                             break;
259.                    }
260.                    break;
261.               }
262.               break;
263.             
264.          default:
265.               WM_DefaultProc(pMsg);
266.               break;
267.      }
268. }
270. /*
271. *********************************************************************************************************
272. *    函 数 名: CreateWindowPage3
273. *    功能说明: 创建对话框      
274. *    形    参: 无
275. *    返 回 值: 返回对话框句柄
276. *********************************************************************************************************
277. */
278. WM_HWIN CreateWindowPage3(void)
279. {
280.      WM_HWIN hWin;
282.      hWin = GUI_CreateDialogBox(_aDialogCreatePage3, GUI_COUNTOF(_aDialogCreatePage3), _cbDialogPage3,
283. WM_HBKWIN, 0, 0);
284.      return hWin;
285. }
287. /*
288. *********************************************************************************************************
289. *                                         宏定义
290. *********************************************************************************************************
291. */
292. #define ID_FRAMEWIN_0  (GUI_ID_USER + 0x00)
293. #define ID_MULTIPAGE_0 (GUI_ID_USER + 0x01)
296. /*
297. *********************************************************************************************************
298. *                           GUI_WIDGET_CREATE_INFO类型数组
299. *********************************************************************************************************
300. */
301. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
302. {
303.      { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 800, 480, 0, 0x0, 0 },
304.      { MULTIPAGE_CreateIndirect, "Multipage", ID_MULTIPAGE_0, 23, 25, 400, 240, 0, 0x0, 0 },
305. };
307. /*
308. *********************************************************************************************************
309. *    函 数 名: _cbDialog
310. *    功能说明: 对话框回调函数        
311. *    形    参: pMsg  回调参数
312. *    返 回 值: 无
313. *********************************************************************************************************
314. */
315. static void _cbDialog(WM_MESSAGE * pMsg)
316. {
317.      WM_HWIN hItem;
318.      WM_HWIN hWinPage;
319.      int     NCode;
320.      int     Id;
322.      switch (pMsg->MsgId)
323.      {
324.          case WM_INIT_DIALOG:
325.             
326.               //
327.               // 初始化框架窗口
328.               //
329.               hItem = pMsg->hWin;
330.               FRAMEWIN_SetFont(hItem, GUI_FONT_32B_ASCII);
331. FRAMEWIN_SetText(hItem, "armfly")
332.               FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
333.         
334.               //
335.               // 初始化多页控件
336.               //
337.               hItem = WM_GetDialogItem(pMsg->hWin, ID_MULTIPAGE_0);
338.               MULTIPAGE_SetFont(hItem, GUI_FONT_16_ASCII);
340.               hWinPage = CreateWindowPage1();
341.               MULTIPAGE_AddEmptyPage(hItem, hWinPage, "STM32-V4");
343.               hWinPage = CreateWindowPage2();
344.               MULTIPAGE_AddEmptyPage(hItem, hWinPage, "STM32-V5");
346.               hWinPage = CreateWindowPage3();
347.               MULTIPAGE_AddEmptyPage(hItem, hWinPage, "STM32-V6");
348.               break;
349.         
350.          case WM_NOTIFY_PARENT:
351.               Id    = WM_GetId(pMsg->hWinSrc);
352.               NCode = pMsg->Data.v;
353.               switch(Id)
354.               {
355.                    case ID_MULTIPAGE_0:
356.                    switch(NCode)
357.                    {
358.                        case WM_NOTIFICATION_CLICKED:
359.                             break;
360.                      
361.                        case WM_NOTIFICATION_RELEASED:
362.                             break;
363.                      
364.                        case WM_NOTIFICATION_MOVED_OUT:
365.                             break;
366.                      
367.                        case WM_NOTIFICATION_VALUE_CHANGED:
368.                             break;
369.                    }
370.                   break;
371.               }
372.               break;
373.             
374.          default:
375.               WM_DefaultProc(pMsg);
376.               break;
377.      }
378. }
380. /*
381. *********************************************************************************************************
382. *    函 数 名: CreateFramewin
383. *    功能说明: 创建对话框      
384. *    形    参: 无
385. *    返 回 值: 返回对话框句柄
386. *********************************************************************************************************
387. */
388. WM_HWIN CreateFramewin(void)
389. {
390.      WM_HWIN hWin;
392.      hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), _cbDialog, WM_HBKWIN, 0, 0);
393.      return hWin;
394. }
396. /*
397. *********************************************************************************************************
398. *    函 数 名: MainTask
399. *    功能说明: GUI主函数
400. *    形    参: 无
401. *    返 回 值: 无
402. *********************************************************************************************************
403. */
404. void MainTask(void)
405. {
406.    
407.      /* 初始化 */
408.      GUI_Init();
409.    
410.      /*
411.       关于多缓冲和窗口内存设备的设置说明
412.         1. 使能多缓冲是调用的如下函数，用户要在LCDConf_Lin_Template.c文件中配置了多缓冲，调用此函数才有效：
413.            WM_MULTIBUF_Enable(1);
414.         2. 窗口使能使用内存设备是调用函数：WM_SetCreateFlags(WM_CF_MEMDEV);
415.         3. 如果emWin的配置多缓冲和窗口内存设备都支持，二选一即可，且务必优先选择使用多缓冲，实际使用
416.            STM32F429BIT6 + 32位SDRAM + RGB565/RGB888平台测试，多缓冲可以有效的降低窗口移动或者滑动时的撕裂
417.            感，并有效的提高流畅性，通过使能窗口使用内存设备是做不到的。
418.         4. 所有emWin例子默认是开启三缓冲。
419.      */
420.      WM_MULTIBUF_Enable(1);
421.    
422.      /*
423.        触摸校准函数默认是注释掉的，电阻屏需要校准，电容屏无需校准。如果用户需要校准电阻屏的话，执行
424.         此函数即可，会将触摸校准参数保存到EEPROM里面，以后系统上电会自动从EEPROM里面加载。
425.      */
426.     //TOUCH_Calibration();
427.    
428.      /* 创建对话框 */
429.      CreateFramewin();
430.         
431.      while(1)
432.      {
433.          GUI_Delay(50);
434.    
435. }

复制代码

席萌0209

55.7 总结


        本期教程主要是跟大家讲解了多页控件的基础知识。多页控件在实际项目中也比较实用，希望大家可以把本期教程
中讲的例子运行下，然后自己设计一个相关的例子进行试验学习。教程中只是使用了部分的多页控件API，其它的API大家都可以试试。