设为首页收藏本站
切换到窄版

硬汉嵌入式论坛

 找回密码
 立即注册
硬汉嵌入式论坛»首页 › 嵌入式软件 › uCOS & uCGUI & emWin & embOS & TouchGFX & ThreadX › 【STemWin教程】第42章 DROPDOWN-下拉列表控件
返回列表 发新帖
查看: 5773|回复: 0
收起左侧

[emWin教程入门篇] 【STemWin教程】第42章 DROPDOWN-下拉列表控件

[复制链接]
席萌0209

740

主题

1326

回帖

3546

积分

管理员

春暖花开

Rank: 9Rank: 9Rank: 9

积分
3546
QQ
发表于 2015-2-28 10:32:10 | 显示全部楼层 |阅读模式
特别说明：完整STemWin的1-60期教程和配套实例下载地址：链接
第42章 DROPDOWN-下拉列表控件

    本期教程讲解STemWin支持的下拉列表。
    42. 1 下拉列表控件介绍
    42. 2 官方WIDGET_Dropdown实例
    42. 3 对话框上使用下拉列表控件
    42. 4 总结

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

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


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。这个例子在模拟器中的位置：
42.3.png

源代码如下：
  1. #include "GUI.h"
  2. #include "FRAMEWIN.h"
  3. #include "DROPDOWN.h"
  4. #include "LISTBOX.h"
  5. #include <stddef.h>
  7. /*********************************************************************
  8. *
  9. *       Defines
  10. *
  11. **********************************************************************
  12. */
  13. #define SPEED 1000
  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";
  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. }
  147. /*******************************************************************
  148. *
  149. *       _DemoDropDown
  150. */
  151. static void _DemoDropDown(void) {
  152.   WM_HWIN hDropDown;
  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. }
  183. /*******************************************************************
  184. *
  185. *       _DemoDropDownAsChild
  186. */
  187. static void _DemoDropDownAsChild(void) {
  188.   WM_HWIN hFrame;
  189.   WM_HWIN hDropDown;
  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. }
  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.4.png

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


42.3 对话框上使用下拉列表控件
    用uCGUIBulder4.0建立一个如下的界面（分辨率480*272）：
42.6.png

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

源代码如下：
  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"
  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. */
  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. };
  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. *****************************************************************/
  39. void PaintDialog(WM_MESSAGE * pMsg)
  40. {
  41.     WM_HWIN hWin = pMsg->hWin;
  43. }
  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. *****************************************************************/
  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");
  75. }
  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;
  118.             }
  119.             break;
  120.         default:
  121.             WM_DefaultProc(pMsg);
  122.     }
  123. }
  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. }
复制代码
    这个代码比较的简单，实际的显示效果如下：
42.8.png

     要实现列表向上拉，需要在对话框的资源列表中做如下处理：
  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.9.png


42.4 总结
    本期教程主要是跟大家讲解了下拉列表控件的使用，希望大家可以把本期教程中讲的这两个例子跑跑，然后自己设计一个相关的例子进行试验学习。教程中只是使用了部分的下拉列表API，其它的API大家都可以试试。
努力打造安富莱高质量微信公众号：点击扫描图片关注
回复

使用道具 举报

返回列表 发新帖
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|小黑屋|Archiver|手机版|硬汉嵌入式论坛

GMT+8, 2024-5-15 16:24 , Processed in 0.282758 second(s), 28 queries .

Powered by Discuz! X3.4 Licensed

Copyright © 2001-2023, Tencent Cloud.

快速回复 返回顶部 返回列表