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

第42章 DROPDOWN-下拉列表控件

    本期教程讲解STemWin支持的下拉列表。

    42. 1 下拉列表控件介绍

    42. 2 官方WIDGET_Dropdown实例

    42. 3 对话框上使用下拉列表控件

    42. 4 总结

42.1 下拉列表控件介绍

    DROPDOWN控件用于从具有若干栏的列表中选择一个元素，它以非打开状态显示当前选择的项目。如果用户打开DROPDOWN控件，就会出现一个选择新项目的LISTBOX。

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

42.1.1 下拉列表支持的通知代码

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

消息	描述
WM_NOTIFICATION_CLICKED	已被点击。
WM_NOTIFICATION_RELEASED	已被释放。
WM_NOTIFICATION_MOVED_OUT	已被点击，且指针已移出控件，但没有释放。
WM_NOTIFICATION_SCROLL_CHANGED	已打开的下拉列表小工具的可选滚动条的滚动位置已改变。
WM_NOTIFICATION_SEL_CHANGED	下拉列表的选择已更改。

42.1.2 下拉列表支持的键盘反应

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

按键	反应
GUI_KEY_SPACE	切换小工具的选中状态
GUI_KEY_ENTER	从打开的下拉列表中选择项目，然后关闭列表

42.2 官方WIDGET_Dropdown实例

    官方的这个例子做的很好，充分的演示了下拉列表的大部分常用API。这个例子在模拟器中的位置：

源代码如下：

1. #include "GUI.h"
   
2. #include "FRAMEWIN.h"
   
3. #include "DROPDOWN.h"
   
4. #include "LISTBOX.h"
   
5. #include <stddef.h>
   
6. 
   
7. /*********************************************************************
   
8. *
   
9. * Defines
   
10. *
    
11. **********************************************************************
    
12. */
    
13. #define SPEED 1000
    
14. 
    
15. /*******************************************************************
    
16. *
    
17. * static code
    
18. *
    
19. ********************************************************************
    
20. */
    
21. /*******************************************************************
    
22. *
    
23. * _ShowSeveralFunctions
    
24. */
    
25. static void _ShowSeveralFunctions(DROPDOWN_Handle hDropDown) {
    
26. int NumEntries;
    
27. int i;
    
28. int Key;
    
29. int Cnt;
    
30. char ac[] = "-- sec to play with dropdown control";
    
31. 
    
32. Key = 0;
    
33. Cnt = 15;
    
34. //
    
35. // Set focus
    
36. //
    
37. GUI_DispStringAtCEOL("WM_SetFocus", 5, 55);
    
38. GUI_Delay(SPEED * 0.9);
    
39. WM_SetFocus(hDropDown);
    
40. GUI_Delay(SPEED * 0.7);
    
41. //
    
42. // Add strings
    
43. //
    
44. GUI_DispStringAtCEOL("DROPDOWN_AddString", 5, 55);
    
45. GUI_Delay(SPEED * 0.8);
    
46. DROPDOWN_AddString(hDropDown, "English"); （1）
    
47. DROPDOWN_AddString(hDropDown, "Deutsch");
    
48. DROPDOWN_AddString(hDropDown, "Fran鏰is");
    
49. DROPDOWN_AddString(hDropDown, "Japanese");
    
50. DROPDOWN_AddString(hDropDown, "Italiano");
    
51. DROPDOWN_AddString(hDropDown, "Espa駉l");
    
52. DROPDOWN_AddString(hDropDown, "Other language ...");
    
53. GUI_Delay(SPEED * 0.6);
    
54. //
    
55. // Increment selection
    
56. //
    
57. GUI_DispStringAtCEOL("DROPDOWN_IncSel", 5, 55);
    
58. GUI_Delay(SPEED);
    
59. NumEntries = DROPDOWN_GetNumItems(hDropDown);（2）
    
60. for (i = 0; i < (NumEntries - 2); i++) {
    
61. DROPDOWN_IncSel(hDropDown);（3）
    
62. GUI_Delay(SPEED / 6);
    
63. }
    
64. GUI_Delay(SPEED / 4);
    
65. //
    
66. // Expand dropdown
    
67. //
    
68. GUI_DispStringAtCEOL("DROPDOWN_Expand", 5, 55);
    
69. GUI_Delay(SPEED);
    
70. DROPDOWN_Expand(hDropDown);（4）
    
71. GUI_Delay(SPEED * 0.75);
    
72. //
    
73. // Add scrollbar
    
74. //
    
75. GUI_DispStringAtCEOL("DROPDOWN_SetAutoScroll", 5, 55);
    
76. GUI_Delay(SPEED);
    
77. DROPDOWN_SetAutoScroll(hDropDown, 1); （5）
    
78. GUI_Delay(SPEED * 0.75);
    
79. //
    
80. // Set font
    
81. //
    
82. GUI_DispStringAtCEOL("DROPDOWN_SetFont", 5, 55);
    
83. GUI_Delay(SPEED);
    
84. DROPDOWN_SetFont(hDropDown, &GUI_Font16B_1); （6）
    
85. GUI_Delay(SPEED * 0.75);
    
86. //
    
87. // Set text color
    
88. //
    
89. GUI_DispStringAtCEOL("DROPDOWN_SetTextColor", 5, 55);
    
90. GUI_Delay(SPEED);
    
91. DROPDOWN_SetTextColor(hDropDown, 0, 0x00BB00);（7）
    
92. DROPDOWN_SetTextColor(hDropDown, 2, GUI_BLACK);
    
93. GUI_Delay(SPEED * 0.75);
    
94. //
    
95. // Set background color
    
96. //
    
97. GUI_DispStringAtCEOL("DROPDOWN_SetBkColor", 5, 55);
    
98. GUI_Delay(SPEED);
    
99. DROPDOWN_SetBkColor(hDropDown, 0, GUI_YELLOW); （8）
    
100. DROPDOWN_SetBkColor(hDropDown, 2, GUI_RED);
     
101. GUI_Delay(SPEED * 0.75);
     
102. //
     
103. // Delete item
     
104. //
     
105. GUI_DispStringAtCEOL("DROPDOWN_DeleteItem", 5, 55);
     
106. GUI_Delay(SPEED);
     
107. DROPDOWN_DeleteItem(hDropDown, 5);（9）
     
108. GUI_Delay(SPEED * 0.75);
     
109. //
     
110. // Collapse dropdown
     
111. //
     
112. GUI_DispStringAtCEOL("DROPDOWN_Collapse", 5, 55);
     
113. GUI_Delay(SPEED);
     
114. DROPDOWN_Collapse(hDropDown);（10）
     
115. GUI_Delay(SPEED * 0.75);
     
116. //
     
117. // Decrement selection
     
118. //
     
119. GUI_DispStringAtCEOL("DROPDOWN_DecSel", 5, 55);
     
120. GUI_Delay(SPEED);
     
121. NumEntries = DROPDOWN_GetNumItems(hDropDown);
     
122. for (i = 0; i < (NumEntries - 2); i++) {
     
123. DROPDOWN_DecSel(hDropDown);（11）
     
124. GUI_Delay(SPEED / 6);
     
125. }
     
126. GUI_Delay(SPEED / 4);
     
127. //
     
128. // Let user play with dropdown control
     
129. //
     
130. GUI_DispStringAtCEOL("", 5, 55);（12）
     
131. while (!Key && (Cnt > 0)) {
     
132. ac[0] = '0' + (Cnt / 10);
     
133. ac[1] = '0' + (Cnt-- % 10);
     
134. GUI_DispStringAtCEOL(ac, 5, 40);
     
135. GUI_Delay(1000);
     
136. Key = GUI_GetKey();
     
137. }
     
138. //
     
139. // Delete dropdown widget
     
140. //
     
141. GUI_DispStringAtCEOL("DROPDOWN_Delete", 5, 55);
     
142. GUI_Delay(SPEED * 1.1);
     
143. DROPDOWN_Delete(hDropDown);（14）
     
144. GUI_Delay(SPEED * 0.75);
     
145. }
     
146. 
     
147. /*******************************************************************
     
148. *
     
149. * _DemoDropDown
     
150. */
     
151. static void _DemoDropDown(void) {
     
152. WM_HWIN hDropDown;
     
153. 
     
154. //
     
155. // Display titel
     
156. //
     
157. GUI_SetBkColor(0xB00000);
     
158. GUI_SetColor(0xFFFFFF);
     
159. GUI_SetFont(&GUI_Font24_ASCII);
     
160. GUI_DispStringHCenterAt("Dropdown - Sample", 160, 5);
     
161. GUI_Delay(SPEED / 2);
     
162. //
     
163. // Create listbox
     
164. //
     
165. GUI_SetFont(&GUI_Font8x16);
     
166. GUI_SetTextAlign(GUI_TA_LEFT);
     
167. GUI_DispStringAtCEOL("using", 5, 40);
     
168. GUI_DispStringAtCEOL("DROPDOWN_CreateEx", 5, 55);
     
169. GUI_Delay(SPEED * 0.9);
     
170. hDropDown = DROPDOWN_CreateEx(100, 80, 120, 115-50, WM_HBKWIN, WM_CF_SHOW, 0, 0); （15）
     
171. GUI_Delay(SPEED * 0.75);
     
172. //
     
173. // Show serveral functions of listbox
     
174. //
     
175. _ShowSeveralFunctions(hDropDown);
     
176. //
     
177. // Clear display
     
178. //
     
179. GUI_Clear();
     
180. GUI_Delay(SPEED * 1.5);
     
181. }
     
182. 
     
183. /*******************************************************************
     
184. *
     
185. * _DemoDropDownAsChild
     
186. */
     
187. static void _DemoDropDownAsChild(void) {
     
188. WM_HWIN hFrame;
     
189. WM_HWIN hDropDown;
     
190. 
     
191. //
     
192. // Display titel
     
193. //
     
194. GUI_SetBkColor(0xB00000);
     
195. GUI_SetColor(0xFFFFFF);
     
196. GUI_SetFont(&GUI_Font24_ASCII);
     
197. GUI_DispStringHCenterAt("Dropdown as child - Sample", 160, 5);
     
198. GUI_Delay(SPEED / 2);
     
199. //
     
200. // Create framewin
     
201. //
     
202. GUI_SetFont(&GUI_Font8x16);
     
203. GUI_SetTextAlign(GUI_TA_LEFT);
     
204. GUI_DispStringAtCEOL("using", 5, 40);
     
205. GUI_DispStringAtCEOL("FRAMEWIN_Create", 5, 55);
     
206. GUI_Delay(SPEED);
     
207. hFrame = FRAMEWIN_Create("DropDown", NULL, WM_CF_SHOW, 80, 80, 160, 140);（16）
     
208. FRAMEWIN_SetFont(hFrame, &GUI_Font16B_ASCII);
     
209. FRAMEWIN_SetActive(hFrame, 1);
     
210. GUI_Delay(SPEED * 0.75);
     
211. //
     
212. // Create listbox
     
213. //
     
214. GUI_DispStringAtCEOL("DROPDOWN_CreateEx", 5, 55);
     
215. GUI_Delay(SPEED);
     
216. hDropDown = DROPDOWN_CreateEx(20, 20, 120, 65, WM_GetClientWindow(hFrame), WM_CF_SHOW, 0, 0);（17）
     
217. GUI_Delay(SPEED * 0.75);
     
218. //
     
219. // Show serveral functions of listbox
     
220. //
     
221. _ShowSeveralFunctions(hDropDown);
     
222. //
     
223. // Delete framewin widget
     
224. //
     
225. GUI_DispStringAtCEOL("FRAMEWIN_Delete", 5, 55);
     
226. GUI_Delay(SPEED);
     
227. FRAMEWIN_Delete(hFrame);
     
228. GUI_Delay(SPEED * 0.75);
     
229. //
     
230. // Clear display
     
231. //
     
232. GUI_Clear();
     
233. GUI_Delay(SPEED * 1.5);
     
234. }
     
235. 
     
236. /*********************************************************************
     
237. *
     
238. * Public code
     
239. *
     
240. **********************************************************************
     
241. */
     
242. /*********************************************************************
     
243. *
     
244. * MainTask
     
245. */
     
246. void MainTask(void) {
     
247. GUI_Init();
     
248. WM_SetDesktopColor(0xB00000);
     
249. GUI_Exec();
     
250. while(1) {
     
251. _DemoDropDown();
     
252. _DemoDropDownAsChild();
     
253. }
     
254. }

复制代码

1. 函数DROPDOWN_AddString用于给下拉列表添加新元素。

2. 函数DROPDOWN_GetNumItems用于返回下拉列表中元素的数目。

3. 函数DROPDOWN_IncSel用于增加选定范围。

4. 函数DROPDOWN_Expand用于打开下拉列表。

5. 函数DROPDOWN_SetAutoScroll启用在下拉列表中自动使用滚动条

6. 函数DROPDOWN_SetFont设置给定DROPDOWN控件的字体。

7. 函数DROPDOWN_SetTextColor用于设置给定DROPDOWN控件的文本颜色。

8. 函数DROPDOWN_SetBkColor用于设置背景颜色。

9. 函数DROPROWN_DeleteItem用于删除下拉列表。

10. 函数DROPDOWN_Collapse用于关闭下拉列表。

11. 函数DROPDOWN_DecSel用于减小选定操作。

12. 用于用户操作。

13. 函数DROPDOWN_Delete用于删除下拉列表。

14. 在桌面窗口上创建下拉列表。

15. 创建框架窗口。

16. 在框架窗口上面创建下拉列表。

    在桌面窗口上面创建下拉列表时的显示效果如下：

    在对话框上面显示下拉列表的效果如下：

42.3 对话框上使用下拉列表控件

    用uCGUIBulder4.0建立一个如下的界面（分辨率480*272）：

    给下拉列表中添加的元素如下：

源代码如下：

1. #include <stddef.h>
   
2. #include "GUI.h"
   
3. #include "DIALOG.h"
   
4. #include "WM.h"
   
5. #include "BUTTON.h"
   
6. #include "CHECKBOX.h"
   
7. #include "DROPDOWN.h"
   
8. #include "EDIT.h"
   
9. #include "FRAMEWIN.h"
   
10. #include "LISTBOX.h"
    
11. #include "MULTIEDIT.h"
    
12. #include "RADIO.h"
    
13. #include "SLIDER.h"
    
14. #include "TEXT.h"
    
15. #include "PROGBAR.h"
    
16. #include "SCROLLBAR.h"
    
17. #include "LISTVIEW.h"
    
18. 
    
19. /*********************************************************************
    
20. *
    
21. * Dialog resource
    
22. *
    
23. * This table conatins the info required to create the dialog.
    
24. * It has been created by ucGUIbuilder.
    
25. */
    
26. 
    
27. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
    
28. { FRAMEWIN_CreateIndirect, "armfly", 0, 0, 0, 480,272,FRAMEWIN_CF_MOVEABLE,0},
    
29. { DROPDOWN_CreateIndirect, NULL, GUI_ID_DROPDOWN0, 129,103,163,80, 0,0}
    
30. };
    
31. 
    
32. /*****************************************************************
    
33. ** FunctionName:void PaintDialog(WM_MESSAGE * pMsg)
    
34. ** Function: to initialize the Dialog items
    
35. **
    
36. ** call this function in _cbCallback --> WM_PAINT
    
37. *****************************************************************/
    
38. 
    
39. void PaintDialog(WM_MESSAGE * pMsg)
    
40. {
    
41. WM_HWIN hWin = pMsg->hWin;
    
42. 
    
43. }
    
44. 
    
45. /*****************************************************************
    
46. ** FunctionName:void InitDialog(WM_MESSAGE * pMsg)
    
47. ** Function: to initialize the Dialog items
    
48. **
    
49. ** call this function in _cbCallback --> WM_INIT_DIALOG
    
50. *****************************************************************/
    
51. 
    
52. void InitDialog(WM_MESSAGE * pMsg)
    
53. {
    
54. WM_HWIN hWin = pMsg->hWin;
    
55. //
    
56. //FRAMEWIN
    
57. //
    
58. FRAMEWIN_SetFont(hWin,&GUI_Font32B_ASCII);
    
59. FRAMEWIN_AddCloseButton(hWin, FRAMEWIN_BUTTON_RIGHT, 0);
    
60. FRAMEWIN_AddMaxButton(hWin, FRAMEWIN_BUTTON_RIGHT, 1);
    
61. FRAMEWIN_AddMinButton(hWin, FRAMEWIN_BUTTON_RIGHT, 2);
    
62. FRAMEWIN_SetTitleHeight(hWin,35);
    
63. //
    
64. //GUI_ID_DROPDOWN0
    
65. //
    
66. DROPDOWN_SetBkColor(WM_GetDialogItem(hWin,GUI_ID_DROPDOWN0),0,0xffffff);
    
67. DROPDOWN_SetFont(WM_GetDialogItem(hWin,GUI_ID_DROPDOWN0),&GUI_Font24B_ASCII);
    
68. DROPDOWN_SetAutoScroll(WM_GetDialogItem(hWin,GUI_ID_DROPDOWN0),1);
    
69. DROPDOWN_AddString(WM_GetDialogItem(hWin,GUI_ID_DROPDOWN0),"Item0");
    
70. DROPDOWN_AddString(WM_GetDialogItem(hWin,GUI_ID_DROPDOWN0),"Item1");
    
71. DROPDOWN_AddString(WM_GetDialogItem(hWin,GUI_ID_DROPDOWN0),"Item2");
    
72. DROPDOWN_AddString(WM_GetDialogItem(hWin,GUI_ID_DROPDOWN0),"Item3");
    
73. DROPDOWN_AddString(WM_GetDialogItem(hWin,GUI_ID_DROPDOWN0),"Item4");
    
74. 
    
75. }
    
76. 
    
77. /*********************************************************************
    
78. *
    
79. * Dialog callback routine
    
80. */
    
81. static void _cbCallback(WM_MESSAGE * pMsg)
    
82. {
    
83. int NCode, Id;
    
84. WM_HWIN hWin = pMsg->hWin;
    
85. switch (pMsg->MsgId)
    
86. {
    
87. case WM_PAINT:
    
88. PaintDialog(pMsg);
    
89. break;
    
90. case WM_INIT_DIALOG:
    
91. InitDialog(pMsg);
    
92. break;
    
93. case WM_KEY:
    
94. switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
    
95. {
    
96. case GUI_KEY_ESCAPE:
    
97. GUI_EndDialog(hWin, 1);
    
98. break;
    
99. case GUI_KEY_ENTER:
    
100. GUI_EndDialog(hWin, 0);
     
101. break;
     
102. }
     
103. break;
     
104. case WM_NOTIFY_PARENT:
     
105. Id = WM_GetId(pMsg->hWinSrc);
     
106. NCode = pMsg->Data.v;
     
107. switch (Id)
     
108. {
     
109. case GUI_ID_OK:
     
110. if(NCode==WM_NOTIFICATION_RELEASED)
     
111. GUI_EndDialog(hWin, 0);
     
112. break;
     
113. case GUI_ID_CANCEL:
     
114. if(NCode==WM_NOTIFICATION_RELEASED)
     
115. GUI_EndDialog(hWin, 0);
     
116. break;
     
117. 
     
118. }
     
119. break;
     
120. default:
     
121. WM_DefaultProc(pMsg);
     
122. }
     
123. }
     
124. 
     
125. /*********************************************************************
     
126. *
     
127. * MainTask
     
128. *
     
129. **********************************************************************
     
130. */
     
131. void MainTask(void)
     
132. {
     
133. GUI_Init();
     
134. WM_SetDesktopColor(GUI_WHITE); /* Automacally update desktop window */
     
135. WM_SetCreateFlags(WM_CF_MEMDEV); /* Use memory devices on all windows to avoid flicker */
     
136. //PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     
137. //FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
     
138. //PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     
139. //BUTTON_SetDefaultSkin(BUTTON_SKIN_FLEX);
     
140. //CHECKBOX_SetDefaultSkin(CHECKBOX_SKIN_FLEX);
     
141. //DROPDOWN_SetDefaultSkin(DROPDOWN_SKIN_FLEX);
     
142. //SCROLLBAR_SetDefaultSkin(SCROLLBAR_SKIN_FLEX);
     
143. //SLIDER_SetDefaultSkin(SLIDER_SKIN_FLEX);
     
144. //HEADER_SetDefaultSkin(HEADER_SKIN_FLEX);
     
145. //RADIO_SetDefaultSkin(RADIO_SKIN_FLEX);
     
146. GUI_ExecDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
     
147. }

复制代码

这个代码比较的简单，实际的显示效果如下：

    要实现列表向上拉，需要在对话框的资源列表中做如下处理：

1. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
   
2. { FRAMEWIN_CreateIndirect, "armfly", 0, 0, 0, 480,272,FRAMEWIN_CF_MOVEABLE,0},
   
3. { DROPDOWN_CreateIndirect, NULL, GUI_ID_DROPDOWN0, 129,103,163,80, DROPDOWN_CF_UP,0}
   
4. };

复制代码

    将前面的0换成DROPDOWN_CF_UP即可。实际显示效果如下：

42.4 总结

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