【emWin实战教程V2.0】第61章 LISTVIEW-列表控

席萌0209

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




第61章      LISTVIEW-列表控件


        （为了方便起见，我们本章节将listview控件翻译成列表控件）
        本章节为大家讲解STemWin支持的列表控件，列表控件类似于Excel，主要用于数据管理，而且支持动态更新，此控件非常实用，忘初学者务必掌握。
61.1 初学者重要提示
61.2 列表控件基础知识
61.3 使用GUIBuilder创建列表控件并用模拟器显示出来
61.4 官方WIDGET_ListView.c实例讲解
61.4 实验例程说明（RTOS）
61.5 实验例程说明（裸机）
61.6 总结

席萌0209

61.1  初学者重要提示



1、初学者爱问的问题简单汇总：
        （1）问题1：列表控件支持动态更新吗？
        答：可以的，本章节配套的例子已经做了动态更新支持。
       （2）问题2：列表控件可以选中单个单元吗？
        答：可以的，当前的emWin5.32版本已经开始支持，调用函数LISTVIEW_EnableCellSelec使能即可。
2、本教程配套的emWin版本是5.32，从emWin5.28版本开始，皮肤色是自动使能的，所以部分列表控件的API函数是失效的，主要是列表控件颜色设置函数，此问题也经常被初学者问。
3、列表控件的所有API函数在emWin手册中都有讲解，下图是中文版手册里面API函数位置：

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

席萌0209

61.2 列表控件基础知识

        列表控件跟Excel软件是类似的，处理表格类的数据非常方便，也很实用。列表控件中包含了HEADER控件，通过HEADER可以方便的对列数据进行管理。另外官方手册中有两个名词No surrounding FRAMEWIN和With surroundingFRAMEWIN，其实很简单，No surrounding FRAMEWIN表示列表控件未创建到框架窗口，With surrounding FRAMEWIN表示列表控件创建到框架窗口上。下表显示的是列表控件的外观：

设置皮肤后显示效果如下：

61.2.1   列表控件支持的通知代码

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

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

61.2.2   列表控件支持的键盘反应（输入聚焦）


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

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

61.2.3   列表控件API函数


        列表控件的API函数比较多，调用也都不难。大家只需看官方手册中的API函数说明就够用了，后面用到的函数中有需要特别注意的再跟大家进行讲解。
        本章节教程配套例子是将列表控件配合对话框一起使用的，实际项目中也推荐大家这么做，可以很方便的进行界面管理。在对话框上面使用列表控件是通过函数LISTVIEW_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是可选的，函数LISTVIEW_CreateIndirect()没有用到参数Para，但用到了标记Flags，与函数LISTVIEW_CreateEx的形参ExFlags是等效的，具体形参ExFlags支持哪些标记参看emWin官方手册中的说明即可：
        这里举一个对话框资源列表里面创建列表控件的例子，帮助大家更好的理解：

1. /*
2. *********************************************************************************************************
3. *                           宏定义
4. *********************************************************************************************************
5. */
6. #define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
7. #define ID_LISTVIEW_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, 0x64, 0 },
17. { LISTVIEW_CreateIndirect, "Listview", ID_LISTVIEW_0, 33, 21, 298, 158, 0, 0x0, 0 },
18. };

复制代码

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

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

1. #define GUI_ID_LISTBOX0   0x110
2. #define GUI_ID_LISTBOX1   0x111
3. #define GUI_ID_LISTBOX2   0x112
4. #define GUI_ID_LISTBOX3   0x113
5. #define GUI_ID_LISTBOX4   0x114
6. #define GUI_ID_LISTBOX5   0x115
7. #define GUI_ID_LISTBOX6   0x116
8. #define GUI_ID_LISTBOX7   0x117
9. #define GUI_ID_LISTBOX8   0x118
10. #define GUI_ID_LISTBOX9   0x119

复制代码

席萌0209

61.3使用GUIBuilder创建列表控件并用模拟器显示出来

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

61.3.1   第一步：建立一个对话框，主体是框架窗口
1、找到GUIBuilder后，打开这个软件，并按照如下方式建立一个对话框。

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

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

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

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

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

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

61.3.2   第二步：在对话框上面建立列表控件


        （官方GUIBuilder对列表控件的支持还是相对比较全面的，功能也比较多，初学者刚使用的时候还稍有些迷茫，多在GUIBuilder操作几次，配置下相关参数，慢慢就熟练了）
        列表控件的建立方法和上面的对话框是一样的。先将列表控件拖到对话框上面，建立后的效果如下所示：

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

默认情况下创建的是一行三列的列表控件，选中此控件后，看右下角属性框：

接下来，我们将其修改为三行四列，通过鼠标右击此控件，选择Add column，选择一次添加一列，设置行同理，选择Add row即可，选择一次添加一行。设置后效果如下：

下面我们将4个列宽都设置为50个像素，修改属性框中的Add column – Width即可。相应的四个标签Add column –Label分别修改为STM32-V3， STM32-V4，STM32-V5和STM32-V6。

注意一点，我们设置的列表框是三行四列，但是实际显示出来的是可以多于这个的，这是因为我们设置为三行四列仅表示我们使用了三行四列，列表框的显示效果如下：

最后，我们为三行四列共12个选项添加文本，还是通过鼠标右击此控件，选择Set item text即可，选择一次添加一个选项，具体设置哪个选项，显示什么内容，在左下角的属性框里面就可以设置：

12个选项的显示内容如下，并将字体设置为GUI_FONT_16_ASCII。

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


        保存方法如下：

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

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


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

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"
26. /*********************************************************************
27. *
28. *       Defines
29. *
30. **********************************************************************
31. */
32. #define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
33. #define ID_LISTVIEW_0 (GUI_ID_USER + 0x01)
36. // USER START (Optionally insert additional defines)
37. // USER END
39. /*********************************************************************
40. *
41. *       Static data
42. *
43. **********************************************************************
44. */
46. // USER START (Optionally insert additional static data)
47. // USER END
49. /*********************************************************************
50. *
51. *       _aDialogCreate
52. */
53. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
54.   { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 800, 480, 0, 0x64, 0 },
55.   { LISTVIEW_CreateIndirect, "Listview", ID_LISTVIEW_0, 33, 21, 298, 158, 0, 0x0, 0 }, //--------------（1）
56.   // USER START (Optionally insert additional widgets)
57.   // USER END
58. };
60. /*********************************************************************
61. *
62. *       Static code
63. *
64. **********************************************************************
65. */
67. // USER START (Optionally insert additional static code)
68. // USER END
70. /*********************************************************************
71. *
72. *       _cbDialog
73. */
74. static void _cbDialog(WM_MESSAGE * pMsg) {
75.   WM_HWIN hItem;
76.   int     NCode;
77.   int     Id;
79.   // USER START (Optionally insert additional variables)
80.   // USER END
82.   switch (pMsg->MsgId) {
83.   case WM_INIT_DIALOG:
84.     //
85.     // Initialization of 'Framewin'
86.     //
87.     hItem = pMsg->hWin;
88.     FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
89.     FRAMEWIN_SetFont(hItem, GUI_FONT_32B_ASCII);
90.     FRAMEWIN_SetText(hItem, "armfly");
91.     //
92.     // Initialization of 'Listview'
93.     //
94.     hItem = WM_GetDialogItem(pMsg->hWin, ID_LISTVIEW_0); //--------------（2）
95.     LISTVIEW_AddColumn(hItem, 60, "STM32-V3", GUI_TA_HCENTER | GUI_TA_VCENTER); //--------------（3）
96.     LISTVIEW_AddColumn(hItem, 60, "STM32-V4", GUI_TA_HCENTER | GUI_TA_VCENTER);
97.     LISTVIEW_AddColumn(hItem, 60, "STM32-V5", GUI_TA_HCENTER | GUI_TA_VCENTER);
98.     LISTVIEW_AddRow(hItem, NULL);   //--------------（4）
99.     LISTVIEW_SetGridVis(hItem, 1);  //--------------（5）
100.     LISTVIEW_AddColumn(hItem, 60, "STM32-V6", GUI_TA_HCENTER | GUI_TA_VCENTER);
101.     LISTVIEW_AddRow(hItem, NULL);  
102.     LISTVIEW_AddRow(hItem, NULL);
103.     LISTVIEW_SetItemText(hItem, 0, 0, "A00"); //--------------（6）
104.     LISTVIEW_SetFont(hItem, GUI_FONT_16_ASCII); //--------------（7）
105.     LISTVIEW_SetItemText(hItem, 1, 0, "A01");
106.     LISTVIEW_SetItemText(hItem, 2, 0, "A02");
107.     LISTVIEW_SetItemText(hItem, 3, 0, "A03");
108.     LISTVIEW_SetItemText(hItem, 0, 1, "B10");
109.     LISTVIEW_SetItemText(hItem, 1, 1, "B11");
110.     LISTVIEW_SetItemText(hItem, 2, 1, "B12");
111.     LISTVIEW_SetItemText(hItem, 3, 1, "B13");
112.     LISTVIEW_SetItemText(hItem, 0, 2, "C20");
113.     LISTVIEW_SetItemText(hItem, 1, 2, "C21");
114.     LISTVIEW_SetItemText(hItem, 2, 2, "C22");
115.     LISTVIEW_SetItemText(hItem, 3, 2, "C23");
116.     // USER START (Optionally insert additional code for further widget initialization)
117.     // USER END
118.     break;
119.   case WM_NOTIFY_PARENT:
120.     Id    = WM_GetId(pMsg->hWinSrc);
121.     NCode = pMsg->Data.v;
122.     switch(Id) {
123.     case ID_LISTVIEW_0: // Notifications sent by 'Listview'
124.       switch(NCode) {
125.       case WM_NOTIFICATION_CLICKED:
126.         // USER START (Optionally insert code for reacting on notification message)
127.         // USER END
128.         break;
129.       case WM_NOTIFICATION_RELEASED:
130.         // USER START (Optionally insert code for reacting on notification message)
131.         // USER END
132.         break;
133.       case WM_NOTIFICATION_SEL_CHANGED:
134.         // USER START (Optionally insert code for reacting on notification message)
135.         // USER END
136.         break;
137.       // USER START (Optionally insert additional code for further notification handling)
138.       // USER END
139.       }
140.       break;
141.     // USER START (Optionally insert additional code for further Ids)
142.     // USER END
143.     }
144.     break;
145.   // USER START (Optionally insert additional message handling)
146.   // USER END
147.   default:
148.     WM_DefaultProc(pMsg);
149.     break;
150.   }
151. }
153. /*********************************************************************
154. *
155. *       Public code
156. *
157. **********************************************************************
158. */
159. /*********************************************************************
160. *
161. *       CreateFramewin
162. */
163. WM_HWIN CreateFramewin(void);
164. WM_HWIN CreateFramewin(void) {
165.   WM_HWIN hWin;
167.   hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), _cbDialog, WM_HBKWIN, 0, 0);
168.   return hWin;
169. }
171. // USER START (Optionally insert additional public code)
172. // USER END
174. /*********************************************************************
175. *
176. *       MainTask
177. */
178. void MainTask(void)
179. {
180.      /* 初始化 */
181.      GUI_Init();
183.      /* 窗口自动使用存储设备 */
184.      WM_SetCreateFlags(WM_CF_MEMDEV);
186.      /* 创建对话框，使用GUIBulder5.32生成的对话框创建函数 */
187.      CreateFramewin();
189.      while(1)
190.      {
191.          GUI_Delay(50);
192.      }
193. }
195. /*************************** End of file ****************************/

复制代码

创建的这个例子相对比较容易，主要实现了在对话框上面创建列表控件，列表控件被创建为三行四列。

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

2.     通过函数WM_GetDialogItem获得ID为ID_LISTVIEW_0的列表控件句柄。

3.     通过函数LISTVIEW_AddColumn为列表控件添加列，此函数被调用了4次，添加了4个列。

4.     通过函数LISTVIEW_AddRow为列表控件添加行，此函数被调用了3次，添加了3行。

5.     通过函数LISTVIEW_SetGridVis来设置是否表格可见，这里是将表格设置为可见。

6.     通过函数LISTVIEW_SetItemText为列表控件中的选项添加字符，为三行四列共12个选项都添加了字符。

7.     通过函数LISTVIEW_SetFont设置列表控件中各个选项所显示文本的字体。

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

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

席萌0209

61.4官方WIDGET_ListView.c实例讲解

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

主要功能介绍：
        这个例子很好的演示了列表控件大部分函数的使用，而且比较容易理解，适合初学者学习参考。
程序代码如下：

1. #include <stddef.h>
2. #include <string.h>
3. #include "GUI.h"
4. #include "LISTVIEW.h"
5. #include "FRAMEWIN.h"
7. /*********************************************************************
8. *
9. *       Defines
10. *
11. **********************************************************************
12. */
13. #define SPEED 650
14. #define MSG_CHANGE_MAIN_TEXT (WM_USER + 0)
15. #define MSG_CHANGE_INFO_TEXT (WM_USER + 1)
17. //
18. // Recommended memory to run the sample with adequate performance
19. //
20. #define RECOMMENDED_MEMORY (1024L * 10)
22. /*********************************************************************
23. *
24. *       Static data
25. *
26. **********************************************************************
27. */
28. static const GUI_COLOR Colors[]      = { 0, GUI_BLUE };
30. static const GUI_LOGPALETTE Palette  = {
31.   2,     /* bps */
32.   1,     /* transparency */
33.   Colors /* pointer to colors */
34. };
36. static const unsigned char acBarCode[] = {
37.   _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
38.   _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
39.   _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
40.   _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
41.   _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
42.   _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
43.   _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
44.   _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
45.   _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
46.   _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
47. };
49. static const GUI_BITMAP bmBarCode = { 96, 10, 12, 1, acBarCode, &Palette};
51. static const char * _aTable_1[][3] = {
52.   { "623499-0010001", "1", "Item 1" },
53.   { "623499-0010002", "2", "Item 2" },
54.   { "623499-0010003", "3", "Item 3" },
55.   { "623499-0010004", "4", "Item 4" },
56.   { "623499-0010005", "5", "Item 5" },
57.   { "623499-0010006", "6", "Item 6" },
58.   { "623499-0010007", "7", "Item 7" },
59.   { "623499-0010008", "8", "Item 8" }
60. };
62. static const char * _aTable_2[][3] = {
63.   { "111111-1111111", "100-A", "Item AAA" },
64.   { "222222-2222222", "100-B", "Item BBB" },
65.   { "333333-3333333", "100-C", "Item CCC" },
66.   { "444444-4444444", "100-D", "Item DDD" },
67.   { "555555-5555555", "100-E", "Item EEE" },
68.   { "666666-6666666", "100-F", "Item FFF" },
69.   { "777777-7777777", "100-G", "Item GGG" },
70.   { "888888-8888888", "100-H", "Item HHH" }
71. };
73. static LISTVIEW_Handle _hListView;
75. static char _acMainText[100];
76. static char _acInfoText[100];
78. /*********************************************************************
79. *
80. *       Static code
81. *
82. **********************************************************************
83. */
84. /*******************************************************************
85. *
86. *       _ChangeMainText
87. *
88. *  Sends a message to the background window and invalidate it, so
89. *  the callback of the background window display the new text.
90. */
91. static void _ChangeMainText(char* pStr) {   //--------------（1）
92.   WM_MESSAGE Message;
94.   Message.MsgId  = MSG_CHANGE_MAIN_TEXT;
95.   Message.Data.p = pStr;
96.   WM_SendMessage(WM_HBKWIN, &Message);
97.   WM_InvalidateWindow(WM_HBKWIN);
98. }
100. /*******************************************************************
101. *
102. *       _ChangeInfoText
103. *
104. *  Sends a message to the background window and invalidate it, so
105. *  the callback of the background window display the new text.
106. */
107. static void _ChangeInfoText(char* pStr) {  //--------------（2）
108.   WM_MESSAGE Message;
110.   Message.MsgId  = MSG_CHANGE_INFO_TEXT;
111.   Message.Data.p = pStr;
112.   WM_SendMessage(WM_HBKWIN, &Message);
113.   WM_InvalidateWindow(WM_HBKWIN);
114.   GUI_Delay(SPEED);
115. }
117. /*******************************************************************
118. *
119. *       _cbBkWindow
120. */
121. static void _cbBkWindow(WM_MESSAGE* pMsg) {   //--------------（3）
122.   switch (pMsg->MsgId) {
123.     case MSG_CHANGE_MAIN_TEXT:                //--------------（4）
124.       strcpy(_acMainText, (char const *)pMsg->Data.p);
125.       WM_InvalidateWindow(pMsg->hWin);
126.       break;
127.     case MSG_CHANGE_INFO_TEXT:                //--------------（5）
128.       strcpy(_acInfoText, (char const *)pMsg->Data.p);
129.       WM_InvalidateWindow(pMsg->hWin);
130.       break;
131.     case WM_PAINT:
132.       GUI_SetBkColor(GUI_BLACK);
133.       GUI_Clear();
134.       GUI_SetColor(GUI_WHITE);
135.       GUI_SetFont(&GUI_Font24_ASCII);
136.       GUI_DispStringHCenterAt("LISTVIEW Widget - Sample", 160, 5);
137.       GUI_SetFont(&GUI_Font8x16);
138.       GUI_DispStringAt(_acMainText, 5, 40);
139.       GUI_SetFont(&GUI_Font8x8);
140.       GUI_DispStringAt(_acInfoText, 5, 60);
141.       break;
142.     default:
143.       WM_DefaultProc(pMsg);
144.   }
145. }
147. /*********************************************************************
148. *
149. *       _Demo
150. */
151. static void _Demo(void) {
152.   unsigned int i;
153.   unsigned int j;
155.   int Key = 0;
156.   int Cnt = 15;
157.   char acInfoText[] = "-- sec to play with header control";
158.   HEADER_Handle hHeader;
159.   hHeader = LISTVIEW_GetHeader(_hListView);     //--------------（6）
160.   WM_SetFocus(_hListView);
162.   _ChangeInfoText("LISTVIEW_AddColumn");        //--------------（7）
163.   LISTVIEW_AddColumn(_hListView, 100, "EAN",         GUI_TA_CENTER);
164.   GUI_Delay(SPEED / 2);
165.   LISTVIEW_AddColumn(_hListView,  50, "Order #\\0x0", GUI_TA_CENTER);
166.   GUI_Delay(SPEED / 2);
167.   LISTVIEW_AddColumn(_hListView, 100, "Description", GUI_TA_CENTER);
168.   GUI_Delay(SPEED / 2);
170.   _ChangeInfoText("SCROLLBAR_CreateAttached");  //--------------（8）
171.   SCROLLBAR_CreateAttached(_hListView, SCROLLBAR_CF_VERTICAL);
172.   GUI_Delay(SPEED / 2);
174.   _ChangeInfoText("LISTVIEW_AddRow");          //--------------（9）
175.   for (i = 0; i < GUI_COUNTOF(_aTable_1); i++) {
176.     LISTVIEW_AddRow(_hListView, _aTable_1[i]);
177.     GUI_Delay(SPEED / 3);
178.   }
180.   _ChangeInfoText("LISTVIEW_IncSel");         //--------------（10）
181.   for (i = 0; i < LISTVIEW_GetNumRows(_hListView); i++) {
182.     LISTVIEW_IncSel(_hListView);
183.     GUI_Delay(SPEED / 4);
184.   }
185.   GUI_Delay(SPEED / 4);
187.   _ChangeInfoText("LISTVIEW_DecSel");         //--------------（11）
188.   for (i = 0; i < LISTVIEW_GetNumRows(_hListView); i++) {
189.     LISTVIEW_DecSel(_hListView);
190.     GUI_Delay(SPEED / 4);
191.   }
192.   GUI_Delay(SPEED / 4);
194.   _ChangeInfoText("LISTVIEW_SetTextAlign");   //--------------（12）
195.   LISTVIEW_SetTextAlign(_hListView, 0, GUI_TA_RIGHT);
196.   GUI_Delay((int)(SPEED * 0.7))
197. ;
198.   _ChangeInfoText("LISTVIEW_SetColumnWidth"); //--------------（13）
199.   LISTVIEW_SetColumnWidth(_hListView, 1, 70);
200.   GUI_Delay((int)(SPEED * 0.7));
202.   _ChangeInfoText("HEADER_SetTextColor"); //--------------（14）
203.   HEADER_SetTextColor(hHeader, GUI_BLUE);
204.   GUI_Delay((int)(SPEED * 0.7));
206.   _ChangeInfoText("LISTVIEW_SetItemText"); //--------------（15）
207.   for (i = 0; i < GUI_COUNTOF(_aTable_2); i++) {
208.     for (j = 0; j < GUI_COUNTOF(_aTable_2[i]); j++) {
209.       LISTVIEW_SetItemText(_hListView, j, i, _aTable_2[i][j]);
210.     }
211.   }
212.   GUI_Delay(SPEED / 2);
214.   _ChangeInfoText("LISTVIEW_SetBkColor"); //--------------（16）
215.   LISTVIEW_SetBkColor(_hListView, 0, GUI_YELLOW);
216.   GUI_Delay((int)(SPEED * 0.7));
218.   _ChangeInfoText("LISTVIEW_SetGridVis"); //--------------（17）
219.   LISTVIEW_SetGridVis(_hListView, 1);
220.   GUI_Delay((int)(SPEED * 0.7));
222.   _ChangeInfoText("HEADER_SetHeight");   //--------------（18）
223.   HEADER_SetHeight(hHeader, 30);
224.   GUI_Delay((int)(SPEED * 0.7));
226.   _ChangeInfoText("HEADER_SetBitmapEx"); //--------------（19）
227.   HEADER_SetBitmap(hHeader, 0, &bmBarCode);
228.   GUI_Delay((int)(SPEED * 0.7));
230.   while ((Key != GUI_KEY_ENTER) && (Cnt > 0)) { //--------------（20）
231.     acInfoText[0] = '0' + (Cnt / 10);
232.     acInfoText[1] = '0' + (Cnt-- % 10);
233.     _ChangeInfoText(acInfoText);
234.     GUI_Delay(1000);
235.     Key = GUI_GetKey();
236.   }
237. }
239. /*********************************************************************
240. *
241. *       _DemoListView
242. */
243. static void _DemoListView(void) {
244.   _ChangeMainText("LISTVIEW control without parent");
245.   _ChangeInfoText("LISTVIEW_Create");
246.   _hListView = LISTVIEW_Create(10, 80, 300, 89, 0, 1234, WM_CF_SHOW, 0); //--------------（21）
247.   GUI_Delay(SPEED / 2);
248.   _Demo();
249.   _ChangeInfoText("WM_DeleteWindow");
250.   WM_DeleteWindow(_hListView);  //--------------（22）
251.   GUI_Delay(SPEED);
252. }
254. /*********************************************************************
255. *
256. *       Public code
257. *
258. **********************************************************************
259. */
260. /*********************************************************************
261. *
262. *       MainTask
263. */
264. void MainTask(void) {
265.   GUI_Init();
266.   //
267.   // Check if recommended memory for the sample is available
268.   //
269.   if (GUI_ALLOC_GetNumFreeBytes() < RECOMMENDED_MEMORY) {
270.     GUI_ErrorOut("Not enough memory available.");
271.     return;
272.   }
273.   WM_EnableMemdev(WM_HBKWIN);
274.   WM_SetCreateFlags(WM_CF_MEMDEV);
275.   WM_SetCallback(WM_HBKWIN, _cbBkWindow);
276.   GUI_CURSOR_Show();
277.   while(1) {
278.     _DemoListView();
279.   }
280. }

复制代码

1.     此函数用于桌面窗口文本的更新，具体实现是通过函数WM_SendMessage给桌面窗口发自定义消息MSG_CHANGE_MAIN_TEXT，然后再调用函数WM_InvalidateWindow将桌面窗口无效，从而会触发窗口管理器去执行MSG_CHANGE_MAIN_TEXT消息，但不是调用了函数WM_InvalidateWindow后立即去执行的，而是在调用了函数GUI_Delay，GUI_Exec或者WM_Exec后才去执行的。
2.     同第1条解释中的函数一样，也是用桌面窗口文本的更新。
3.     桌面窗口的回调函数。
4.     用于处理函数_ChangeMainText发来的自定义消息MSG_CHANGE_MAIN_TEXT，将要显示的文本复制到缓冲_acMainText里面，然后调用函数WM_InvalidateWindow会触发桌面窗口去执行重绘消息WM_PIANT，在此消息里面绘制缓冲_acMainText里面的文本。
5.     用于处理函数_ChangeInfoText发来的自定义消息MSG_CHANGE_INFO_TEXT，将要显示的文本复制到缓冲_acInfoText里面，然后调用函数WM_InvalidateWindow会触发桌面窗口去执行重绘消息WM_PIANT，在此消息里面绘制缓冲_acMainText里面的文本。
6.     通过函数LISTVIEW_GetHeader获得列表控件中header控件的句柄。
7.     这一小段程序演示函数LISTVIEW_AddColumn给列表控件添加列。
8.     这一小段程序演示函数SCROLLBAR_CreateAttached给列表控件添加垂直滚动条。
9.     这一小段程序演示函数LISTVIEW_AddRow给列表控件添加行。
10.  这一小段程序演示函数LISTVIEW_IncSel递增选取行。
11.  这一小段程序演示函数LISTVIEW_DecSel递减选取行。
12.  这一小段程序演示函数LISTVIEW_SetTextAlign设置列表控件的文本对齐（是指各个选项中的文本，而不是header控件上显示的文本）。
13.  这一小段程序演示函数LISTVIEW_SetColumnWidth设置列的宽度。
14.  这一小段程序演示函数HEADER_SetTextColor设置列表控件上header控件的文本显示颜色。
15.  这一小段程序演示函数LISTVIEW_SetItemText设置列表控件中各个选项显示的文本。
16.  这一小段程序演示函数LISTVIEW_SetBkColor设置列表控件的背景色。
17.  这一小段程序演示函数LISTVIEW_SetGridVis设置列表控件的网格是否可见。
18.  这一小段程序演示函数HEADER_SetHeight设置列表控件上header控件的高度。
19.  这一小段程序演示函数HEADER_SetBitmapEx设置列表控件上header控件的位图显示。
20.  这一小段程序比较巧妙，设置15s的延迟供用户操作列表控件，如果在15s期间，用户通过键盘按下了回车键，将直接退出演示，如果未按下回车键，15s后再退出。
21.  通过函数创建LISTVIEW_Create创建列表控件。
22.  通过函数WM_DeleteWindow删除列表控件。
实际显示效果如下：

席萌0209

61.5实验例程说明（RTOS）


配套例子：
        V6-596_STemWin实验_Listview列表控件，支持动态更新（RTOS）
实验目的：
        1.     本实验主要学习列表控件的使用。
        2.     emWin功能的实现在MainTask.c文件里面。
实验内容：
        1.     K1按键按下，串口打印任务执行情况（波特率115200，数据位8，奇偶校验位无，停止位1）。
        2.     K2按键按下，实现截图功能，将图片以BMP格式保存到SD卡中。
        3.     GUI任务在对话框上面创建了一个列表控件，列表控件被创建为三行四列，共12个选项，其中第一个选项和最后一个选项的文本，每100ms更新一次，这里是做了一个简单的计数功能。
        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. #define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
12. #define ID_LISTVIEW_0 (GUI_ID_USER + 0x01)
15. /*
16. *********************************************************************************************************
17. *                           GUI_WIDGET_CREATE_INFO类型数组
18. *********************************************************************************************************
19. */
20. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
21. {
22.      { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 800, 480, 0, 0x64, 0 },
23.      { LISTVIEW_CreateIndirect, "Listview", ID_LISTVIEW_0, 30, 20, 350, 160, 0, 0x0, 0 },
24. };
26. /*
27. *********************************************************************************************************
28. *    函 数 名: _cbDialog
29. *    功能说明: 对话框回调函数        
30. *    形    参: pMsg  回调参数
31. *    返 回 值: 无
32. *********************************************************************************************************
33. */
34. static void _cbDialog(WM_MESSAGE * pMsg)
35. {
36.      WM_HWIN hItem;
37.      int     NCode;
38.      int     Id;
39.      HEADER_Handle hHeader;
40.      char    buf[10];
41.      static char  Value = 0;
43.      switch (pMsg->MsgId)
44.      {
45.          case WM_INIT_DIALOG:
46.             
47.               //
48.               // 初始化框架窗口
49.               //
50.               hItem = pMsg->hWin;
51.               FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
52.               FRAMEWIN_SetFont(hItem, GUI_FONT_32B_ASCII);
53.               FRAMEWIN_SetText(hItem, "armfly");
54.         
55.               //
56.               // 初始列表控件
57.               //
58.               hItem = WM_GetDialogItem(pMsg->hWin, ID_LISTVIEW_0);
59.               /* 设置列表控件中header控件的所显示文本的字体 */
60.               hHeader = LISTVIEW_GetHeader(hItem);
61.               HEADER_SetFont(hHeader, GUI_FONT_16_ASCII);
63.               /* 添加四列表，调用一次函数LISTVIEW_AddColumn添加一列 */
64.               LISTVIEW_AddColumn(hItem, 80, "STM32-V3", GUI_TA_HCENTER | GUI_TA_VCENTER);
65.               LISTVIEW_AddColumn(hItem, 80, "STM32-V4", GUI_TA_HCENTER | GUI_TA_VCENTER);
66.               LISTVIEW_AddColumn(hItem, 80, "STM32-V5", GUI_TA_HCENTER | GUI_TA_VCENTER);
67.               LISTVIEW_AddColumn(hItem, 80, "STM32-V6", GUI_TA_HCENTER | GUI_TA_VCENTER);
68.             
69.               /* 添加三行，调用一次函数LISTVIEW_AddRow添加一行 */
70.               LISTVIEW_AddRow(hItem, NULL);
71.               LISTVIEW_AddRow(hItem, NULL);
72.               LISTVIEW_AddRow(hItem, NULL);
73.         
74.               /* 为列表控件三行四列共12个选项全部添加文本 */
75.               LISTVIEW_SetItemText(hItem, 0, 0, "A00");
76.               LISTVIEW_SetItemText(hItem, 1, 0, "A01");
77.               LISTVIEW_SetItemText(hItem, 2, 0, "A02");
78.               LISTVIEW_SetItemText(hItem, 3, 0, "A03");
79.               LISTVIEW_SetItemText(hItem, 0, 1, "B10");
80.               LISTVIEW_SetItemText(hItem, 1, 1, "B11");
81.               LISTVIEW_SetItemText(hItem, 2, 1, "B12");
82.               LISTVIEW_SetItemText(hItem, 3, 1, "B13");
83.               LISTVIEW_SetItemText(hItem, 0, 2, "C20");
84.               LISTVIEW_SetItemText(hItem, 1, 2, "C21");
85.               LISTVIEW_SetItemText(hItem, 2, 2, "C22");
86.               LISTVIEW_SetItemText(hItem, 3, 2, "C23");
87.             
88.               /* 设置列表控件选项中所显示文本的字体 */
89.               LISTVIEW_SetFont(hItem, GUI_FONT_16_ASCII);
90.               /* 设置列表控件表格可见 */
91.               LISTVIEW_SetGridVis(hItem, 1);
92.               break;
93.         
94.          case WM_NOTIFY_PARENT:
95.               Id    = WM_GetId(pMsg->hWinSrc);
96.               NCode = pMsg->Data.v;
97.               switch(Id)
98.               {
99.                    case ID_LISTVIEW_0:
100.                        switch(NCode)
101.                        {
102.                             case WM_NOTIFICATION_CLICKED:
103.                                  break;
104.                            
105.                             case WM_NOTIFICATION_RELEASED:
106.                                  break;
107.                            
108.                             case WM_NOTIFICATION_SEL_CHANGED:
109.                                  break;
110.                        }
111.               }
112.               break;
113.             
114.          case WM_TIMER:
115.               /* 每100ms更新一次列表控件中第一个选项和最后一个选项所显示的文本，这里是做了一个简单的计数 */
116.               hItem = WM_GetDialogItem(pMsg->hWin, ID_LISTVIEW_0);
117.               sprintf(buf, "%d", Value++);
118.               LISTVIEW_SetItemText(hItem, 0, 0, buf);
119.               LISTVIEW_SetItemText(hItem, 3, 2, buf);
120.             
121.               WM_RestartTimer(pMsg->Data.v, 100);
122.             
123.          default:
124.               WM_DefaultProc(pMsg);
125.               break;
126.      }
127. }
129. /*
130. *********************************************************************************************************
131. *    函 数 名: CreateFramewin
132. *    功能说明: 创建对话框      
133. *    形    参: 无
134. *    返 回 值: 返回对话框句柄
135. *********************************************************************************************************
136. */
137. WM_HWIN CreateFramewin(void)
138. {
139.      WM_HWIN hWin;
141.      hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), _cbDialog, WM_HBKWIN, 0, 0);
142.      return hWin;
143. }
145. /*
146. *********************************************************************************************************
147. *    函 数 名: MainTask
148. *    功能说明: GUI主函数
149. *    形    参: 无
150. *    返 回 值: 无
151. *********************************************************************************************************
152. */
153. void MainTask(void)
154. {
155.      WM_HWIN hDlg;
156.    
157.      /* 初始化 */
158.      GUI_Init();
159.    
160.      /*
161.       关于多缓冲和窗口内存设备的设置说明
162.         1. 使能多缓冲是调用的如下函数，用户要在LCDConf_Lin_Template.c文件中配置了多缓冲，调用此函数才有效：
163.            WM_MULTIBUF_Enable(1);
164.         2. 窗口使能使用内存设备是调用函数：WM_SetCreateFlags(WM_CF_MEMDEV);
165.         3. 如果emWin的配置多缓冲和窗口内存设备都支持，二选一即可，且务必优先选择使用多缓冲，实际使用
166.            STM32F429BIT6 + 32位SDRAM + RGB565/RGB888平台测试，多缓冲可以有效的降低窗口移动或者滑动时的撕裂
167.            感，并有效的提高流畅性，通过使能窗口使用内存设备是做不到的。
168.         4. 所有emWin例子默认是开启三缓冲。
169.      */
170.      WM_MULTIBUF_Enable(1);
171.    
172.      /*
173.        触摸校准函数默认是注释掉的，电阻屏需要校准，电容屏无需校准。如果用户需要校准电阻屏的话，执行
174.         此函数即可，会将触摸校准参数保存到EEPROM里面，以后系统上电会自动从EEPROM里面加载。
175.      */
176.     //TOUCH_Calibration();
177.    
178.      /* 创建对话框 */
179.      hDlg = CreateFramewin();
180.    
181.      /* 为对话框创建一个溢出时间是100ms的定时器 */
182.      WM_CreateTimer(WM_GetClientWindow(hDlg), 0, 100, 0);
183.         
184.      while(1)
185.      {
186.           GUI_Delay(50);
187.      }
188. }

复制代码

席萌0209

61.6 实验例程说明（裸机）


配套例子：
        V6-597_STemWin实验_Listview列表控件，支持动态更新（裸机）
实验目的：
        1.     本实验主要学习列表控件的使用。
        2.     emWin功能的实现在MainTask.c文件里面。
实验内容：
        1.     GUI任务在对话框上面创建了一个列表控件，列表控件被创建为三行四列，共12个选项，其中第一个选项和最后一个选项的文本，每100ms更新一次，这里是做了一个简单的计数功能。
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. #define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
11. #define ID_LISTVIEW_0 (GUI_ID_USER + 0x01)
14. /*
15. *********************************************************************************************************
16. *                           GUI_WIDGET_CREATE_INFO类型数组
17. *********************************************************************************************************
18. */
19. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
20. {
21.      { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 800, 480, 0, 0x64, 0 },
22.      { LISTVIEW_CreateIndirect, "Listview", ID_LISTVIEW_0, 30, 20, 350, 160, 0, 0x0, 0 },
23. };
25. /*
26. *********************************************************************************************************
27. *    函 数 名: _cbDialog
28. *    功能说明: 对话框回调函数        
29. *    形    参: pMsg  回调参数
30. *    返 回 值: 无
31. *********************************************************************************************************
32. */
33. static void _cbDialog(WM_MESSAGE * pMsg)
34. {
35.      WM_HWIN hItem;
36.      int     NCode;
37.      int     Id;
38.      HEADER_Handle hHeader;
39.      char    buf[10];
40.      static char  Value = 0;
42.      switch (pMsg->MsgId)
43.      {
44.          case WM_INIT_DIALOG:
45.             
46.               //
47.               // 初始化框架窗口
48.               //
49.               hItem = pMsg->hWin;
50.               FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
51.               FRAMEWIN_SetFont(hItem, GUI_FONT_32B_ASCII);
52.               FRAMEWIN_SetText(hItem, "armfly");
53.         
54.               //
55.               // 初始列表控件
56.               //
57.               hItem = WM_GetDialogItem(pMsg->hWin, ID_LISTVIEW_0);
58.               /* 设置列表控件中header控件的所显示文本的字体 */
59.               hHeader = LISTVIEW_GetHeader(hItem);
60.               HEADER_SetFont(hHeader, GUI_FONT_16_ASCII);
62.               /* 添加四列表，调用一次函数LISTVIEW_AddColumn添加一列 */
63.               LISTVIEW_AddColumn(hItem, 80, "STM32-V3", GUI_TA_HCENTER | GUI_TA_VCENTER);
64.               LISTVIEW_AddColumn(hItem, 80, "STM32-V4", GUI_TA_HCENTER | GUI_TA_VCENTER);
65.               LISTVIEW_AddColumn(hItem, 80, "STM32-V5", GUI_TA_HCENTER | GUI_TA_VCENTER);
66.               LISTVIEW_AddColumn(hItem, 80, "STM32-V6", GUI_TA_HCENTER | GUI_TA_VCENTER);
67.             
68.               /* 添加三行，调用一次函数LISTVIEW_AddRow添加一行 */
69.               LISTVIEW_AddRow(hItem, NULL);
70.               LISTVIEW_AddRow(hItem, NULL);
71.               LISTVIEW_AddRow(hItem, NULL);
72.         
73.               /* 为列表控件三行四列共12个选项全部添加文本 */
74.               LISTVIEW_SetItemText(hItem, 0, 0, "A00");
75.               LISTVIEW_SetItemText(hItem, 1, 0, "A01");
76.               LISTVIEW_SetItemText(hItem, 2, 0, "A02");
77.               LISTVIEW_SetItemText(hItem, 3, 0, "A03");
78.               LISTVIEW_SetItemText(hItem, 0, 1, "B10");
79.               LISTVIEW_SetItemText(hItem, 1, 1, "B11");
80.               LISTVIEW_SetItemText(hItem, 2, 1, "B12");
81.               LISTVIEW_SetItemText(hItem, 3, 1, "B13");
82.               LISTVIEW_SetItemText(hItem, 0, 2, "C20");
83.               LISTVIEW_SetItemText(hItem, 1, 2, "C21");
84.               LISTVIEW_SetItemText(hItem, 2, 2, "C22");
85.               LISTVIEW_SetItemText(hItem, 3, 2, "C23");
86.             
87.               /* 设置列表控件选项中所显示文本的字体 */
88.               LISTVIEW_SetFont(hItem, GUI_FONT_16_ASCII);
89.               /* 设置列表控件表格可见 */
90.               LISTVIEW_SetGridVis(hItem, 1);
91.               break;
92.         
93.          case WM_NOTIFY_PARENT:
94.               Id    = WM_GetId(pMsg->hWinSrc);
95.               NCode = pMsg->Data.v;
96.               switch(Id)
97.               {
98.                    case ID_LISTVIEW_0:
99.                        switch(NCode)
100.                        {
101.                             case WM_NOTIFICATION_CLICKED:
102.                                  break;
103.                            
104.                             case WM_NOTIFICATION_RELEASED:
105.                                  break;
106.                            
107.                             case WM_NOTIFICATION_SEL_CHANGED:
108.                                  break;
109.                        }
110.               }
111.               break;
112.             
113.          case WM_TIMER:
114.               /* 每100ms更新一次列表控件中第一个选项和最后一个选项所显示的文本，这里是做了一个简单的计数 */
115.               hItem = WM_GetDialogItem(pMsg->hWin, ID_LISTVIEW_0);
116.               sprintf(buf, "%d", Value++);
117.               LISTVIEW_SetItemText(hItem, 0, 0, buf);
118.               LISTVIEW_SetItemText(hItem, 3, 2, buf);
119.             
120.               WM_RestartTimer(pMsg->Data.v, 100);
121.             
122.          default:
123.               WM_DefaultProc(pMsg);
124.               break;
125.      }
126. }
128. /*
129. *********************************************************************************************************
130. *    函 数 名: CreateFramewin
131. *    功能说明: 创建对话框      
132. *    形    参: 无
133. *    返 回 值: 返回对话框句柄
134. *********************************************************************************************************
135. */
136. WM_HWIN CreateFramewin(void)
137. {
138.      WM_HWIN hWin;
140.      hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), _cbDialog, WM_HBKWIN, 0, 0);
141.      return hWin;
142. }
144. /*
145. *********************************************************************************************************
146. *    函 数 名: MainTask
147. *    功能说明: GUI主函数
148. *    形    参: 无
149. *    返 回 值: 无
150. *********************************************************************************************************
151. */
152. void MainTask(void)
153. {
154.      WM_HWIN hDlg;
155.    
156.      /* 初始化 */
157.      GUI_Init();
158.    
159.      /*
160.       关于多缓冲和窗口内存设备的设置说明
161.         1. 使能多缓冲是调用的如下函数，用户要在LCDConf_Lin_Template.c文件中配置了多缓冲，调用此函数才有效：
162.            WM_MULTIBUF_Enable(1);
163.         2. 窗口使能使用内存设备是调用函数：WM_SetCreateFlags(WM_CF_MEMDEV);
164.         3. 如果emWin的配置多缓冲和窗口内存设备都支持，二选一即可，且务必优先选择使用多缓冲，实际使用
165.            STM32F429BIT6 + 32位SDRAM + RGB565/RGB888平台测试，多缓冲可以有效的降低窗口移动或者滑动时的撕裂
166.            感，并有效的提高流畅性，通过使能窗口使用内存设备是做不到的。
167.         4. 所有emWin例子默认是开启三缓冲。
168.      */
169.      WM_MULTIBUF_Enable(1);
170.    
171.      /*
172.        触摸校准函数默认是注释掉的，电阻屏需要校准，电容屏无需校准。如果用户需要校准电阻屏的话，执行
173.         此函数即可，会将触摸校准参数保存到EEPROM里面，以后系统上电会自动从EEPROM里面加载。
174.      */
175.     //TOUCH_Calibration();
176.    
177.      /* 创建对话框 */
178.      hDlg = CreateFramewin();
179.    
180.      /* 为对话框创建一个溢出时间是100ms的定时器 */
181.      WM_CreateTimer(WM_GetClientWindow(hDlg), 0, 100, 0);
182.         
183.      while(1)
184.      {
185.          GUI_Delay(50);
186.      }
187. }

复制代码

席萌0209

61.7 总结


        本期教程主要是跟大家讲解了LISTVIEW控件的基础使用方法。希望大家可以把本期教程中讲的例子运行下，然后自己设计一个相关的例子进行试验学习。教程中只是使用了部分的LISTVIEW控件API，其它的API大家都可以试试。