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

第59章 LISTVIEW控件

    本期教程讲解STemWin支持的LISTVIEW控件。

    59. 1 LISTVIEW控件介绍

    59. 2 官方WIDGET_ListView实例

    59. 3 使用官方GUIBulder建立ListView控件

    59. 3 总结

59.1 LISTVIEW控件介绍

    LISTVIEW控件可在具有多个列的列表中选择某个元素。由于LISTVIEW控件包含了一个HEADER控件，因此可对列加以管理。所创建的LISTVIEW既可以无环绕型框架窗口，也可以作为FRAMEWIN控件的一个子窗口。一旦选定列表视图中的项目，就会突出显示有关项目。需要注意的是，所选项目的背景颜色取决于LISTVIEW窗口是否具有输入焦点。下表显示的是LISTVIEW小工具的外观：

59.1.1 LISTVIEW支持的通知代码

    以下事件是LISTVIEW控件作为WM_NOTIFY_PARENT消息的一部分发送给其父窗口的：

消息	描述
WM_NOTIFICATION_CLICKED	已单击
WM_NOTIFICATION_RELEASED	已释放
WM_NOTIFICATION_MOVED_OUT	已单击小工具，并且指针已移出小工具，但没有释放
WM_NOTIFICATION_SCROLL_CHANGED	可选滚动条的滚动位置已更改
WM_NOTIFICATION_SEL_CHANGED	列表框的选择内容已更改

59.1.2 LISTVIEW支持的键盘反应

    如果控件具有输入焦点，则它将对下列各键做出反应：

按键	反应
GUI_KEY_UP	选择栏上移
GUI_KEY_DOWN	选择栏下移。
GUI_KEY_RIGHT	如果总列宽>列表视图的内部区域，则内容将滚动到左侧。
GUI_KEY_LEFT	如果总列宽>列表视图的内部区域，则内容将滚动到右侧。

59.2 官方WIDGET_ListView实例

    官方的这个实例很好的演示了ListView的使用，这个例子在模拟器中的位置：

源码如下（程序中进行了详细的注释）：

1. #include <stddef.h>
   
2. #include <string.h>
   
3. #include "GUI.h"
   
4. #include "LISTVIEW.h"
   
5. #include "FRAMEWIN.h"
   
6. 
   
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)
    
16. 
    
17. /*********************************************************************
    
18. *
    
19. * Static data
    
20. *
    
21. **********************************************************************
    
22. */
    
23. static const GUI_COLOR Colors[] = { 0, GUI_BLUE };
    
24. 
    
25. static const GUI_LOGPALETTE Palette = {
    
26. 2, /* bps */
    
27. 1, /* transparency */
    
28. Colors /* pointer to colors */
    
29. };
    
30. 
    
31. static const unsigned char acBarCode[] = {
    
32. _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
    
33. _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
    
34. _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
    
35. _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
    
36. _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
    
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. };
    
43. 
    
44. static const GUI_BITMAP bmBarCode = { 96, 10, 12, 1, acBarCode, &Palette};
    
45. 
    
46. static const char * _aTable_1[][3] = {
    
47. { "623499-0010001", "1", "Item 1" },
    
48. { "623499-0010002", "2", "Item 2" },
    
49. { "623499-0010003", "3", "Item 3" },
    
50. { "623499-0010004", "4", "Item 4" },
    
51. { "623499-0010005", "5", "Item 5" },
    
52. { "623499-0010006", "6", "Item 6" },
    
53. { "623499-0010007", "7", "Item 7" },
    
54. { "623499-0010008", "8", "Item 8" }
    
55. };
    
56. 
    
57. static const char * _aTable_2[][3] = {
    
58. { "111111-1111111", "100-A", "Item AAA" },
    
59. { "222222-2222222", "100-B", "Item BBB" },
    
60. { "333333-3333333", "100-C", "Item CCC" },
    
61. { "444444-4444444", "100-D", "Item DDD" },
    
62. { "555555-5555555", "100-E", "Item EEE" },
    
63. { "666666-6666666", "100-F", "Item FFF" },
    
64. { "777777-7777777", "100-G", "Item GGG" },
    
65. { "888888-8888888", "100-H", "Item HHH" }
    
66. };
    
67. 
    
68. static LISTVIEW_Handle _hListView;
    
69. 
    
70. static char _acMainText[100];
    
71. static char _acInfoText[100];
    
72. 
    
73. 
    
74. /*******************************************************************
    
75. *
    
76. * _ChangeMainText
    
77. *
    
78. * 用于给桌面窗口发自定义消息，并将桌面窗口无效，这样就可以出发桌面窗口回调函数
    
79. * 的WM_PAINT消息。
    
80. */
    
81. static void _ChangeMainText(char* pStr) {
    
82. WM_MESSAGE Message;
    
83. 
    
84. Message.MsgId = MSG_CHANGE_MAIN_TEXT;
    
85. Message.Data.p = pStr;
    
86. WM_SendMessage(WM_HBKWIN, &Message);
    
87. WM_InvalidateWindow(WM_HBKWIN);
    
88. }
    
89. 
    
90. /*******************************************************************
    
91. *
    
92. * _ChangeInfoText
    
93. *
    
94. * 用于给桌面窗口发自定义消息，并将桌面窗口无效，这样就可以出发桌面窗口回调函数
    
95. * 的WM_PAINT消息。
    
96. */
    
97. static void _ChangeInfoText(char* pStr) {
    
98. WM_MESSAGE Message;
    
99. 
    
100. Message.MsgId = MSG_CHANGE_INFO_TEXT;
     
101. Message.Data.p = pStr;
     
102. WM_SendMessage(WM_HBKWIN, &Message);
     
103. WM_InvalidateWindow(WM_HBKWIN);
     
104. GUI_Delay(SPEED);
     
105. }
     
106. 
     
107. /*******************************************************************
     
108. *
     
109. * _cbBkWindow
     
110. */
     
111. static void _cbBkWindow(WM_MESSAGE* pMsg) {
     
112. switch (pMsg->MsgId) {
     
113. case MSG_CHANGE_MAIN_TEXT: //自定义消息
     
114. strcpy(_acMainText, (char const *)pMsg->Data.p);
     
115. WM_InvalidateWindow(pMsg->hWin);
     
116. break;
     
117. case MSG_CHANGE_INFO_TEXT: //自定义消息
     
118. strcpy(_acInfoText, (char const *)pMsg->Data.p);
     
119. WM_InvalidateWindow(pMsg->hWin);
     
120. break;
     
121. case WM_PAINT:
     
122. GUI_SetBkColor(GUI_BLACK);
     
123. GUI_Clear();
     
124. GUI_SetColor(GUI_WHITE);
     
125. GUI_SetFont(&GUI_Font24_ASCII);
     
126. GUI_DispStringHCenterAt("LISTVIEW Widget - Sample", 160, 5);
     
127. GUI_SetFont(&GUI_Font8x16);
     
128. GUI_DispStringAt(_acMainText, 5, 40);
     
129. GUI_SetFont(&GUI_Font8x8);
     
130. GUI_DispStringAt(_acInfoText, 5, 60);
     
131. break;
     
132. default:
     
133. WM_DefaultProc(pMsg);
     
134. }
     
135. }
     
136. 
     
137. /*********************************************************************
     
138. *
     
139. * _Demo
     
140. */
     
141. static void _Demo(void) {
     
142. unsigned int i;
     
143. unsigned int j;
     
144. 
     
145. int Key = 0;
     
146. int Cnt = 15;
     
147. char acInfoText[] = "-- sec to play with header control";
     
148. HEADER_Handle hHeader;
     
149. 
     
150. /* 得到LISTVIEW中的HEADER控件句柄 */
     
151. hHeader = LISTVIEW_GetHeader(_hListView);
     
152. WM_SetFocus(_hListView);
     
153. 
     
154. /* 演示LISTVIEW_AddColumn */
     
155. _ChangeInfoText("LISTVIEW_AddColumn");
     
156. LISTVIEW_AddColumn(_hListView, 100, "EAN", GUI_TA_CENTER);
     
157. GUI_Delay(SPEED / 2);
     
158. LISTVIEW_AddColumn(_hListView, 50, "Order #\0x0", GUI_TA_CENTER);
     
159. GUI_Delay(SPEED / 2);
     
160. LISTVIEW_AddColumn(_hListView, 100, "Description", GUI_TA_CENTER);
     
161. GUI_Delay(SPEED / 2);
     
162. 
     
163. /* 演示SCROLLBAR_CreateAttached */
     
164. _ChangeInfoText("SCROLLBAR_CreateAttached");
     
165. SCROLLBAR_CreateAttached(_hListView, SCROLLBAR_CF_VERTICAL);
     
166. GUI_Delay(SPEED / 2);
     
167. 
     
168. /* 演示LISTVIEW_AddRow */
     
169. _ChangeInfoText("LISTVIEW_AddRow");
     
170. for (i = 0; i < GUI_COUNTOF(_aTable_1); i++) {
     
171. LISTVIEW_AddRow(_hListView, _aTable_1[i]);
     
172. GUI_Delay(SPEED / 3);
     
173. }
     
174. 
     
175. /* 演示LISTVIEW_IncSel */
     
176. _ChangeInfoText("LISTVIEW_IncSel");
     
177. for (i = 0; i < LISTVIEW_GetNumRows(_hListView); i++) {
     
178. LISTVIEW_IncSel(_hListView);
     
179. GUI_Delay(SPEED / 4);
     
180. }
     
181. GUI_Delay(SPEED / 4);
     
182. 
     
183. /* 演示LISTVIEW_DecSel */
     
184. _ChangeInfoText("LISTVIEW_DecSel");
     
185. for (i = 0; i < LISTVIEW_GetNumRows(_hListView); i++) {
     
186. LISTVIEW_DecSel(_hListView);
     
187. GUI_Delay(SPEED / 4);
     
188. }
     
189. GUI_Delay(SPEED / 4);
     
190. 
     
191. /* 演示LISTVIEW_SetTextAlign */
     
192. _ChangeInfoText("LISTVIEW_SetTextAlign");
     
193. LISTVIEW_SetTextAlign(_hListView, 0, GUI_TA_RIGHT);
     
194. GUI_Delay((int)(SPEED * 0.7));
     
195. 
     
196. /* 演示LISTVIEW_SetColumnWidth */
     
197. _ChangeInfoText("LISTVIEW_SetColumnWidth");
     
198. LISTVIEW_SetColumnWidth(_hListView, 1, 70);
     
199. GUI_Delay((int)(SPEED * 0.7));
     
200. 
     
201. /* 演示HEADER_SetTextColor */
     
202. _ChangeInfoText("HEADER_SetTextColor");
     
203. HEADER_SetTextColor(hHeader, GUI_BLUE);
     
204. GUI_Delay((int)(SPEED * 0.7));
     
205. 
     
206. /* 演示LISTVIEW_SetItemText */
     
207. _ChangeInfoText("LISTVIEW_SetItemText");
     
208. for (i = 0; i < GUI_COUNTOF(_aTable_2); i++) {
     
209. for (j = 0; j < GUI_COUNTOF(_aTable_2[i]); j++) {
     
210. LISTVIEW_SetItemText(_hListView, j, i, _aTable_2[i][j]);
     
211. }
     
212. }
     
213. GUI_Delay(SPEED / 2);
     
214. 
     
215. /* 演示LISTVIEW_SetBkColor */
     
216. _ChangeInfoText("LISTVIEW_SetBkColor");
     
217. LISTVIEW_SetBkColor(_hListView, 0, GUI_YELLOW);
     
218. GUI_Delay((int)(SPEED * 0.7));
     
219. 
     
220. /* 演示LISTVIEW_SetGridVis */
     
221. _ChangeInfoText("LISTVIEW_SetGridVis");
     
222. LISTVIEW_SetGridVis(_hListView, 1);
     
223. GUI_Delay((int)(SPEED * 0.7));
     
224. 
     
225. /* 演示HEADER_SetHeight */
     
226. _ChangeInfoText("HEADER_SetHeight");
     
227. HEADER_SetHeight(hHeader, 30);
     
228. GUI_Delay((int)(SPEED * 0.7));
     
229. 
     
230. /* 演示HEADER_SetBitmap */
     
231. _ChangeInfoText("HEADER_SetBitmapEx");
     
232. HEADER_SetBitmap(hHeader, 0, &bmBarCode);
     
233. GUI_Delay((int)(SPEED * 0.7));
     
234. /* 等待一段时间，用于用户操作 */
     
235. while ((Key != GUI_KEY_ENTER) && (Cnt > 0)) {
     
236. acInfoText[0] = '0' + (Cnt / 10);
     
237. acInfoText[1] = '0' + (Cnt-- % 10);
     
238. _ChangeInfoText(acInfoText);
     
239. GUI_Delay(1000);
     
240. Key = GUI_GetKey();
     
241. }
     
242. }
     
243. 
     
244. /*********************************************************************
     
245. *
     
246. * _DemoListView
     
247. */
     
248. static void _DemoListView(void) {
     
249. _ChangeMainText("LISTVIEW control without parent");
     
250. _ChangeInfoText("LISTVIEW_Create");
     
251. /* 创建LISTVIEW */
     
252. _hListView = LISTVIEW_Create(10, 80, 300, 89, 0, 1234, WM_CF_SHOW, 0);
     
253. GUI_Delay(SPEED / 2);
     
254. /* Demo演示 */
     
255. _Demo();
     
256. _ChangeInfoText("LISTVIEW_Delete");
     
257. /* 删除listview */
     
258. LISTVIEW_Delete(_hListView);
     
259. GUI_Delay(SPEED);
     
260. }
     
261. 
     
262. /*********************************************************************
     
263. *
     
264. * MainTask
     
265. */
     
266. void MainTask(void) {
     
267. GUI_Init();
     
268. /* 使能桌面窗口使用内存设备 */
     
269. WM_EnableMemdev(WM_HBKWIN);
     
270. /* 使能所有其它窗口使用内存设备 */
     
271. WM_SetCreateFlags(WM_CF_MEMDEV);
     
272. /* 设置桌面窗口的回调函数 */
     
273. WM_SetCallback(WM_HBKWIN, _cbBkWindow);
     
274. GUI_CURSOR_Show();
     
275. while(1) {
     
276. _DemoListView();
     
277. }
     
278. }

复制代码

实际显示效果如下：

59.3 使用官方GUIBulder建立LISTVIEW控件

    这里用GUIBulder5.22建立一个如下的界面（分辨率480*272）：

在GUIBulder5.22上面创建LISTVIEW相对来说要麻烦一些，下面详细的跟大家创建一下：

59.3.1 第一步：添加LISTVIEW控件

    默认情况下，添加的LISTVIEW控件是一行三列，也就是一个ROW，三个Column。

59.3.2 第二步：添加第一行的三个元素

    添加方法如下：

每次点击左下角就会出现相应的设置选项，大家根据实际情况进行设置即可（也就是每个方格所在的Column和Row）：

59.3.3 第三步：添加Column和Row

    Column和Row的添加方法如下：

在这里，我们仅添加一行，添加后，设置右下角每个方格中的显示字符：

最后将生成的代码直接复制到模拟器或者开发板上面运行，实际显示效果如下（生成的代码在本期教程配套的例子中）：

59.4 总结

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

学习了，，，，，

谢谢分享

谢谢分享