你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

【安富莱STemWin教程】第43章 EDIT-编辑控件

[复制链接]
baiyongbin2009 发布时间:2015-3-2 11:57
特别说明:完整STemWin的1-60期教程和配套实例下载地址:链接
第43章 EDIT-编辑控件

    本期教程讲解STemWin支持的编辑控件。
    43. 1 编辑控件介绍
    43. 2 官方WIDGET_Edit实例
    43. 3 对话框上使用编辑框控件
    43. 4 总结
43.1 编辑控件介绍
    编辑字段通常用作输入文本的主要用户界面:
43.1.png
    也可使用编辑字段以二进制、十进制或十六进制模式输入值。十进制模式编辑字段的外观与下表所列类似。与复选框类似,编辑字段在禁用时显示为灰色:
43.2.png
    开启皮肤设置后,编辑框的显示效果如下:
43.3.png
43.1.1 编辑框支持的通知代码
    以下事件是编辑框控件作为WM_NOTIFY_PARENT消息的一部分发送给其父窗口的:
消息
描述
WM_NOTIFICATION_CLICKED
已被点击。
WM_NOTIFICATION_RELEASED
已被释放。
WM_NOTIFICATION_MOVED_OUT
已被点击,且指针已移出控件,但没有释放。
WM_NOTIFICATION_VALUE_CHANGED
编辑小工具的值 (内容)已更改。
43.1.2 编辑框支持的键盘反应
    如果控件具有输入焦点,则它将对下列各键做出反应:
按键
反应
GUI_KEY_UP
上升当前字符。例如,如果当前字符 (光标下的字符)为 “A”, 则 变 为 “B”。
GUI_KEY_DOWN
下降当前字符。例如,如果当前字符为为 “B”,则变为 “A”。
GUI_KEY_RIGHT
将光标向右移动一个字符。
GUI_KEY_LEFT
将光标向左移动一个字符。
GUI_KEY_BACKSPACE
如果小工具在文本模式下操作,则删除光标前的字符。
GUI_KEY_DELETE
如果小工具在文本模式下操作,则删除当前字符。
GUI_KEY_INSERT
如果小工具在文本模式下操作,则此键在GUI_EDIT_MODE_OVERWRITE
和GUI_EDIT_MODE_INSERT之间切换编辑模式。

收藏 评论6 发布时间:2015-3-2 11:57

举报

6个回答
baiyongbin2009 回答时间:2015-3-2 11:59:13
本帖最后由 baiyongbin2009 于 2015-3-2 12:01 编辑

43.2 官方WIDGET_Edit实例
    官方的这个例子演示了部分EDIT控件API的使用。这个例子在模拟器中的位置:
43.4.png
源代码如下(官方的这个例子有BUG,下面是修改前的,也就是源代码):
#include "GUI.h"
#include "EDIT.h"
/*********************************************************************
*
*       Defines
*
**********************************************************************
*/
#define WM_APP_SHOW_TEXT (WM_USER + 0)                                                              (1)
#define TEXT_MAXLEN      40                                                                         (2)
/*********************************************************************
*
*       Static code
*
**********************************************************************
*/
/*********************************************************************
*
*       _cbBk
*/
static void _cbBk(WM_MESSAGE * pMsg) {
  static WM_HWIN hEdit;
  static U8      ShowText;
  char           aBuffer[TEXT_MAXLEN];
  hEdit    = 0;
  ShowText = 0;
  switch (pMsg->MsgId) {
  case WM_PAINT:
    GUI_SetBkColor(GUI_DARKGRAY);
    GUI_Clear();
    GUI_SetFont(&GUI_Font24_ASCII);
    GUI_DispStringHCenterAt("WIDGET_Edit - Sample", 160, 5);
    GUI_SetFont(&GUI_Font8x16);
    if (ShowText) {
      GUI_DispStringHCenterAt("The string you have modified is:", 160, 90);
      EDIT_GetText(hEdit, aBuffer, TEXT_MAXLEN);
      GUI_DispStringHCenterAt(aBuffer, 160, 110);
    } else {
      GUI_DispStringHCenterAt("Use keyboard to modify string...", 160, 90);
    }
    break;
  case WM_APP_SHOW_TEXT:
    if (hEdit == 0) {
      hEdit = pMsg->hWinSrc;
    }
    WM_HideWindow(hEdit);
    ShowText = 1;
    WM_InvalidateWindow(WM_HBKWIN);
    WM_CreateTimer(WM_HBKWIN, 0, 3000, 0);
    break;
  case WM_TIMER:
    ShowText = 0;
    WM_InvalidateWindow(WM_HBKWIN);
    WM_ShowWindow(hEdit);
    break;
  default:
    WM_DefaultProc(pMsg);
  }
}
/*********************************************************************
*
*       _cbEdit
*/
static void _cbEdit(WM_MESSAGE * pMsg) {                                                            (3)
  const WM_KEY_INFO * pInfo;
  WM_MESSAGE          Msg;
  switch (pMsg->MsgId) {
  case WM_KEY:                                                                                      (4)
    pInfo = (WM_KEY_INFO *)pMsg->Data.p;
    if (pInfo->Key == GUI_KEY_ENTER) {
      if (pInfo->PressedCnt == 0) {
        Msg.MsgId   = WM_APP_SHOW_TEXT;
        Msg.hWinSrc = pMsg->hWin;
        WM_SendMessage(WM_HBKWIN, &Msg);
        return;
      }
    }
  }
  EDIT_Callback(pMsg);                                                                              (5)
}
/*********************************************************************
*
*       Public code
*
**********************************************************************
*/
/*********************************************************************
*
*       MainTask
*/
void MainTask(void) {
  EDIT_Handle hEdit;
  GUI_Init();
  WM_SetCallback(WM_HBKWIN, _cbBk);                                                                   (6)
  hEdit = EDIT_CreateEx(50, 110, 220, 25, WM_HBKWIN, WM_CF_SHOW, 0, GUI_ID_EDIT0, TEXT_MAXLEN);       (7)
  WM_SetCallback(hEdit, _cbEdit);                                                                     (8)
  EDIT_SetText(hEdit, "Press <ENTER> when done...");
  EDIT_SetFont(hEdit, &GUI_Font8x16);
  EDIT_SetTextColor(hEdit, 0, GUI_RED);
  EDIT_EnableBlink(hEdit, 300, 1);                                                                    (9)
  while (1) {
    GUI_Delay(10);
  }
}
    这个实例中函数static void _cbBk(WM_MESSAGE * pMsg)存在问题,需要做如下修改:
static void _cbBk(WM_MESSAGE * pMsg) {
  static WM_HWIN hEdit = 0;(10)
  static U8      ShowText = 0;
  char           aBuffer[TEXT_MAXLEN];
  //hEdit    = 0;
  //ShowText = 0;
  switch (pMsg->MsgId) {
  case WM_PAINT:                                                                                     (11)
    GUI_SetBkColor(GUI_DARKGRAY);
    GUI_Clear();
    GUI_SetFont(&GUI_Font24_ASCII);
    GUI_DispStringHCenterAt("WIDGET_Edit - Sample", 160, 5);
    GUI_SetFont(&GUI_Font8x16);
    if (ShowText) {
      GUI_DispStringHCenterAt("The string you have modified is:", 160, 90);
      EDIT_GetText(hEdit, aBuffer, TEXT_MAXLEN);
      GUI_DispStringHCenterAt(aBuffer, 160, 110);
    } else {
      GUI_DispStringHCenterAt("Use keyboard to modify string...", 160, 90);
    }
    break;
  case WM_APP_SHOW_TEXT:                                                                            (12)
    if (hEdit == 0) {
      hEdit = pMsg->hWinSrc;
    }
    WM_HideWindow(hEdit);
    ShowText = 1;
    WM_InvalidateWindow(WM_HBKWIN);
    WM_CreateTimer(WM_HBKWIN, 0, 3000, 0);
    break;
  case WM_TIMER:                                                                                    (13)
    ShowText = 0;
    WM_InvalidateWindow(WM_HBKWIN);
    WM_ShowWindow(hEdit);
    break;
  default:
    WM_DefaultProc(pMsg);
  }
}
1. 自定义回调函数的消息。
2. 定义编辑框中可以显示字符的个数。
3. 编辑框的回调函数,默认情况下,编辑框的回调函数是在emWin库函数中自带执行的,不需要用户专门的做一个回调函数,如果用户需要在编辑框的回调函数中加入处理代码的话,可以通过函数WM_SetCallback来指定编辑框的回调函数。
4. 编辑框回调函数中的WM_KEY消息。如果用户在键盘上按下Enter回车键,那么就会给桌面窗口发送前面自定义的消息。
5. emWin库中自带的编辑框回调函数EDIT_Callback(pMsg);
6. 设置桌面窗口的回调函数。
7. 创建编辑框。
8. 设置编辑框的回调函数。
9. 这个函数用于使能或者禁止光标闪烁。
10. 这个函数是桌面窗口的回调函数,由于官方的提供的这个函数是存在问题的,这里专门的做了修改,注意红体字。
11. 桌面窗口的WM_PAINT消息。根据ShowText变量来改变不同的显示值。
12. 桌面窗口中自定义的消息,如果收到这个消息后,隐藏编辑框,设置ShowText = 1,然后将桌面窗口设置为无效,从而会执行桌面窗口的WM_PAINT消息,最后给桌面窗口建立一个定时器,时间是3000ms。
13. 定时器消息,3000ms的时间到了以后设置ShowText = 1,将桌面窗口无效,从而执行重绘消息,并将编辑框显示出来。
实际显示效果如下:
43.5.png

baiyongbin2009 回答时间:2015-3-2 12:02:34
43.3 对话框上使用编辑框控件
    用uCGUIBulder4.0建立一个如下的界面(分辨率480*272):
43.6.png
    通过这个例子主要是显示一下编辑框支持的五种显示方式,设置的位置如下:
43.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"

  18. /*********************************************************************
  19. *
  20. * Dialog resource
  21. *
  22. * This table conatins the info required to create the dialog.
  23. * It has been created by ucGUIbuilder.
  24. */
  25. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
  26. { FRAMEWIN_CreateIndirect, "armfly", 0, 0, 0, 480,272,FRAMEWIN_CF_MOVEABLE,0},
  27. { EDIT_CreateIndirect, "armfly", GUI_ID_EDIT0, 239,36, 100,21, 0,0},
  28. { TEXT_CreateIndirect, "TextMode", GUI_ID_TEXT0, 81, 36, 106,24, 0,0},
  29. { TEXT_CreateIndirect, "FloatMode", GUI_ID_TEXT4, 81, 199,118,24, 0,0},
  30. { TEXT_CreateIndirect, "DecMode", GUI_ID_TEXT3, 81, 158,94, 24, 0,0},
  31. { TEXT_CreateIndirect, "BinMode", GUI_ID_TEXT2, 81, 117,94, 24, 0,0},
  32. { TEXT_CreateIndirect, "HexMode", GUI_ID_TEXT1, 81, 73, 94, 24, 0,0},
  33. { EDIT_CreateIndirect, "FFFF", GUI_ID_EDIT1, 239,73, 100,21, 0,0},
  34. { EDIT_CreateIndirect, "11110000", GUI_ID_EDIT2, 239,120,100,21, 0,0},
  35. { EDIT_CreateIndirect, "128", GUI_ID_EDIT3, 239,163,100,21, 0,0},
  36. { EDIT_CreateIndirect, "12.123456", GUI_ID_EDIT4, 239,199,100,21, 0,0}
  37. };

  38. /*****************************************************************
  39. ** FunctionName:void PaintDialog(WM_MESSAGE * pMsg)
  40. ** Function: to initialize the Dialog items
  41. **
  42. ** call this function in _cbCallback --> WM_PAINT
  43. *****************************************************************/

  44. void PaintDialog(WM_MESSAGE * pMsg)
  45. {
  46. WM_HWIN hWin = pMsg->hWin;

  47. }

  48. /*****************************************************************
  49. ** FunctionName:void InitDialog(WM_MESSAGE * pMsg)
  50. ** Function: to initialize the Dialog items
  51. **
  52. ** call this function in _cbCallback --> WM_INIT_DIALOG
  53. *****************************************************************/

  54. void InitDialog(WM_MESSAGE * pMsg)
  55. {
  56. WM_HWIN hWin = pMsg->hWin;
  57. //
  58. //FRAMEWIN
  59. //
  60. FRAMEWIN_SetFont(hWin,&GUI_Font32B_ASCII);
  61. FRAMEWIN_AddCloseButton(hWin, FRAMEWIN_BUTTON_RIGHT, 0);
  62. FRAMEWIN_AddMaxButton(hWin, FRAMEWIN_BUTTON_RIGHT, 1);
  63. FRAMEWIN_AddMinButton(hWin, FRAMEWIN_BUTTON_RIGHT, 2);
  64. FRAMEWIN_SetTitleHeight(hWin,35);
  65. //
  66. //GUI_ID_EDIT0
  67. //
  68. EDIT_SetFont(WM_GetDialogItem(hWin,GUI_ID_EDIT0),&GUI_Font16B_ASCII);
  69. EDIT_SetText(WM_GetDialogItem(hWin,GUI_ID_EDIT0),"armfly");
  70. //
  71. //GUI_ID_TEXT0
  72. //
  73. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0),&GUI_Font24B_ASCII);
  74. //
  75. //GUI_ID_TEXT4
  76. //
  77. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT4),&GUI_Font24B_ASCII);
  78. //
  79. //GUI_ID_TEXT3
  80. //
  81. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT3),&GUI_Font24B_ASCII);
  82. //
  83. //GUI_ID_TEXT2
  84. //
  85. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT2),&GUI_Font24B_ASCII);
  86. //
  87. //GUI_ID_TEXT1
  88. //
  89. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT1),&GUI_Font24B_ASCII);
  90. //
  91. //GUI_ID_EDIT1
  92. //
  93. EDIT_SetFont(WM_GetDialogItem(hWin,GUI_ID_EDIT1),&GUI_Font16B_ASCII);
  94. EDIT_SetHexMode(WM_GetDialogItem(hWin,GUI_ID_EDIT1),65535,0,255);(1)
  95. //
  96. //GUI_ID_EDIT2
  97. //
  98. EDIT_SetFont(WM_GetDialogItem(hWin,GUI_ID_EDIT2),&GUI_Font16B_ASCII);
  99. EDIT_SetBinMode(WM_GetDialogItem(hWin,GUI_ID_EDIT2),240,0,255);(2)
  100. //
  101. //GUI_ID_EDIT3
  102. //
  103. EDIT_SetFont(WM_GetDialogItem(hWin,GUI_ID_EDIT3),&GUI_Font16B_ASCII);
  104. EDIT_SetDecMode(WM_GetDialogItem(hWin,GUI_ID_EDIT3),128,0,255,0,0); (3)
  105. //
  106. //GUI_ID_EDIT4
  107. //
  108. EDIT_SetFont(WM_GetDialogItem(hWin,GUI_ID_EDIT4),&GUI_Font16B_ASCII);
  109. EDIT_SetFloatMode(WM_GetDialogItem(hWin,GUI_ID_EDIT4),12.12346,0,255,6,0); (4)

  110. }

  111. /*********************************************************************
  112. *
  113. * Dialog callback routine
  114. */
  115. static void _cbCallback(WM_MESSAGE * pMsg)
  116. {
  117. int NCode, Id;
  118. WM_HWIN hWin = pMsg->hWin;
  119. switch (pMsg->MsgId)
  120. {
  121. case WM_PAINT:
  122. PaintDialog(pMsg);
  123. break;
  124. case WM_INIT_DIALOG:
  125. InitDialog(pMsg);
  126. break;
  127. case WM_KEY:
  128. switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
  129. {
  130. case GUI_KEY_ESCAPE:
  131. GUI_EndDialog(hWin, 1);
  132. break;
  133. case GUI_KEY_ENTER:
  134. GUI_EndDialog(hWin, 0);
  135. break;
  136. }
  137. break;
  138. case WM_NOTIFY_PARENT:
  139. Id = WM_GetId(pMsg->hWinSrc);
  140. NCode = pMsg->Data.v;
  141. switch (Id)
  142. {
  143. case GUI_ID_OK:
  144. if(NCode==WM_NOTIFICATION_RELEASED)
  145. GUI_EndDialog(hWin, 0);
  146. break;
  147. case GUI_ID_CANCEL:
  148. if(NCode==WM_NOTIFICATION_RELEASED)
  149. GUI_EndDialog(hWin, 0);
  150. break;

  151. }
  152. break;
  153. default:
  154. WM_DefaultProc(pMsg);
  155. }
  156. }

  157. /*********************************************************************
  158. *
  159. * MainTask
  160. *
  161. **********************************************************************
  162. */
  163. void MainTask(void)
  164. {
  165. GUI_Init();
  166. WM_SetDesktopColor(GUI_WHITE); /* Automacally update desktop window */
  167. WM_SetCreateFlags(WM_CF_MEMDEV); /* Use memory devices on all windows to avoid flicker */
  168. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
  169. FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
  170. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
  171. BUTTON_SetDefaultSkin(BUTTON_SKIN_FLEX);
  172. CHECKBOX_SetDefaultSkin(CHECKBOX_SKIN_FLEX);
  173. DROPDOWN_SetDefaultSkin(DROPDOWN_SKIN_FLEX);
  174. SCROLLBAR_SetDefaultSkin(SCROLLBAR_SKIN_FLEX);
  175. SLIDER_SetDefaultSkin(SLIDER_SKIN_FLEX);
  176. HEADER_SetDefaultSkin(HEADER_SKIN_FLEX);
  177. RADIO_SetDefaultSkin(RADIO_SKIN_FLEX);
  178. GUI_ExecDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
  179. }
复制代码
1. 设置16进制显示。
2. 设置2进制显示。
3. 设置10进制显示。
4. 设置浮点数显示。
实际的显示效果如下:
43.8.png
43.4 总结
    本期教程主要是跟大家讲解了编辑框的使用,希望大家可以把本期教程中讲的这两个例子跑跑,然后自己设计一个相关的例子进行试验学习。教程中只是使用了部分的编辑框API,其它的API大家都可以试试。

manhuami2007 回答时间:2015-3-2 14:07:31
不错的教程
fjjjnk1234 回答时间:2015-3-2 21:31:08
顶一个!!!
一木320 回答时间:2015-8-8 17:52:54
学习学习。                    
小七777 回答时间:2015-8-29 12:29:28
好贴,有用

所属标签

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
STM32N6 AI生态系统
STM32MCU,MPU高性能GUI
ST ACEPACK电源模块
意法半导体生物传感器
STM32Cube扩展软件包
关注我们
st-img 微信公众号
st-img 手机版