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

第43章 EDIT-编辑控件

7 U2 m- {. {! w% W! _. c/ B0 Z, H/ X

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

    43. 1 编辑控件介绍

    43. 2 官方WIDGET_Edit实例

    43. 3 对话框上使用编辑框控件

    43. 4 总结

43.1 编辑控件介绍

    编辑字段通常用作输入文本的主要用户界面：

    也可使用编辑字段以二进制、十进制或十六进制模式输入值。十进制模式编辑字段的外观与下表所列类似。与复选框类似，编辑字段在禁用时显示为灰色：

    开启皮肤设置后，编辑框的显示效果如下：

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之间切换编辑模式。

  J1 i8 o/ C4 h# ]  v
43.2 官方WIDGET_Edit实例

    官方的这个例子演示了部分EDIT控件API的使用。这个例子在模拟器中的位置：

源代码如下（官方的这个例子有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.3 对话框上使用编辑框控件

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

    通过这个例子主要是显示一下编辑框支持的五种显示方式，设置的位置如下：

源代码如下（可以直接复制到模拟器或者开发板上面显示）：

1. #include <stddef.h>
   
2. #include "GUI.h"
   * W0 g- q: U* d  y- h% A& ]: e
3. #include "DIALOG.h"
   * s1 }/ x# a/ C7 x( s* [6 V
4. #include "WM.h"
   
5. #include "BUTTON.h"
   ) U; v" x/ p% `3 H7 [) J% c$ [
6. #include "CHECKBOX.h"
   6 ]! M9 `+ g) u
7. #include "DROPDOWN.h"
   
8. #include "EDIT.h"
   * u9 d! G- w% {0 n% x8 l. C. }/ i+ H
9. #include "FRAMEWIN.h"
   * j9 L: w7 K7 ~) n' z/ n5 m9 ~1 _
10. #include "LISTBOX.h"
    
11. #include "MULTIEDIT.h"
    
12. #include "RADIO.h"
    4 ~$ }6 n3 W7 I% I$ S5 R& O; I
13. #include "SLIDER.h"
    
14. #include "TEXT.h"
    
15. #include "PROGBAR.h"
    4 }& w: D5 Q/ X" J
16. #include "SCROLLBAR.h"
    
17. #include "LISTVIEW.h"
    6 |2 y; S6 ]! [4 P" j
18. 
    : K1 ?. i1 ~7 I; D/ f
19. /*********************************************************************
    6 p3 A% {: D' o
20. *
    
21. * Dialog resource
    8 K( e! o5 J. f) q/ i4 g
22. *
    
23. * This table conatins the info required to create the dialog.
    ( ?8 k" k1 s( L$ m
24. * It has been created by ucGUIbuilder.
    3 P7 x0 H" g  s2 }
25. */
    
26. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
    
27. { FRAMEWIN_CreateIndirect, "armfly", 0, 0, 0, 480,272,FRAMEWIN_CF_MOVEABLE,0},
    & m7 _0 \3 o6 T  F/ F' g/ @  N
28. { EDIT_CreateIndirect, "armfly", GUI_ID_EDIT0, 239,36, 100,21, 0,0},
    " h% j. b; s7 b" C3 V
29. { TEXT_CreateIndirect, "TextMode", GUI_ID_TEXT0, 81, 36, 106,24, 0,0},
    & z5 x5 m; E& C/ h# _) \& g
30. { TEXT_CreateIndirect, "FloatMode", GUI_ID_TEXT4, 81, 199,118,24, 0,0},
    
31. { TEXT_CreateIndirect, "DecMode", GUI_ID_TEXT3, 81, 158,94, 24, 0,0},
    $ Q  Y1 [% j, [5 q2 K: {0 i0 o( U
32. { TEXT_CreateIndirect, "BinMode", GUI_ID_TEXT2, 81, 117,94, 24, 0,0},
    
33. { TEXT_CreateIndirect, "HexMode", GUI_ID_TEXT1, 81, 73, 94, 24, 0,0},
    8 b7 k9 V) x5 X
34. { EDIT_CreateIndirect, "FFFF", GUI_ID_EDIT1, 239,73, 100,21, 0,0},
    8 X8 m( d* w0 }3 G- V" l- s
35. { EDIT_CreateIndirect, "11110000", GUI_ID_EDIT2, 239,120,100,21, 0,0},
    
36. { EDIT_CreateIndirect, "128", GUI_ID_EDIT3, 239,163,100,21, 0,0},
    
37. { EDIT_CreateIndirect, "12.123456", GUI_ID_EDIT4, 239,199,100,21, 0,0}
    
38. };
    # W* P" h+ ^1 c( ~  Q' V
39. 
    
40. /*****************************************************************
    7 k# {; H) N4 f5 d
41. ** FunctionName:void PaintDialog(WM_MESSAGE * pMsg)
    . j. e/ {6 Z2 U& y. s
42. ** Function: to initialize the Dialog items
    . ~4 u, `3 z6 _
43. **
    0 {$ c: y4 P8 p0 A: m
44. ** call this function in _cbCallback --> WM_PAINT
    8 g1 i5 W  S  N
45. *****************************************************************/
    7 d( ^# g" I1 e6 N
46. 
    ) _( Q2 A5 ]0 f  F4 C
47. void PaintDialog(WM_MESSAGE * pMsg)
    
48. {
    / b7 M1 r7 Q% U# f
49. WM_HWIN hWin = pMsg->hWin;
    
50. 
    ( @8 p) V. B% I  y0 k: x1 V& l
51. }
    
52. 
      e/ }+ M* `  Y2 @, {! Q
53. /*****************************************************************
    
54. ** FunctionName:void InitDialog(WM_MESSAGE * pMsg)
    , m4 ^7 d+ u1 Y0 O$ l
55. ** Function: to initialize the Dialog items
    ( {6 {* F8 ~+ c0 y) s
56. **
    5 r# n4 f1 @9 l; x0 u
57. ** call this function in _cbCallback --> WM_INIT_DIALOG
    ) t3 q! ^: u# ]: f! E- Z
58. *****************************************************************/
    
59. 
    + [+ K$ i/ K% E, j1 y) K
60. void InitDialog(WM_MESSAGE * pMsg)
    
61. {
    
62. WM_HWIN hWin = pMsg->hWin;
    
63. //
    
64. //FRAMEWIN
    ! P( |% S8 {- d% e3 \& I
65. //
    
66. FRAMEWIN_SetFont(hWin,&GUI_Font32B_ASCII);
    
67. FRAMEWIN_AddCloseButton(hWin, FRAMEWIN_BUTTON_RIGHT, 0);
    
68. FRAMEWIN_AddMaxButton(hWin, FRAMEWIN_BUTTON_RIGHT, 1);
    : n% e0 a% B3 z' e  J  k" a! P3 a
69. FRAMEWIN_AddMinButton(hWin, FRAMEWIN_BUTTON_RIGHT, 2);
    - b# J! @( h' V
70. FRAMEWIN_SetTitleHeight(hWin,35);
    ; V! N. s# S, Z2 i$ D. Z
71. //
    " r  B& y' i" {, O
72. //GUI_ID_EDIT0
      ?( K% M6 ~; c2 Z- G
73. //
    $ e! x) }' D* A, I) u% |8 S. v2 K
74. EDIT_SetFont(WM_GetDialogItem(hWin,GUI_ID_EDIT0),&GUI_Font16B_ASCII);
    " h0 r- M7 f1 T' C/ f% ~% g, y
75. EDIT_SetText(WM_GetDialogItem(hWin,GUI_ID_EDIT0),"armfly");
    ) i: e* p3 z  s/ |0 T* F
76. //
    7 O7 [$ a6 V! }, j6 x
77. //GUI_ID_TEXT0
      G$ N0 d! u: r3 x5 }8 T8 [# k! I
78. //
    
79. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0),&GUI_Font24B_ASCII);
    
80. //
    . }4 K. t- S* n: b5 }
81. //GUI_ID_TEXT4
    
82. //
    
83. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT4),&GUI_Font24B_ASCII);
    ! I  l' u' @7 w! r
84. //
    
85. //GUI_ID_TEXT3
    ' I) L* e- ^1 ?
86. //
    2 B: e4 u9 r: s% \- D% G
87. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT3),&GUI_Font24B_ASCII);
    
88. //
    
89. //GUI_ID_TEXT2
    : x/ }" O$ y5 i1 {
90. //
    
91. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT2),&GUI_Font24B_ASCII);
    $ J$ S/ I  I5 R' B
92. //
    7 O& U+ o  X' g
93. //GUI_ID_TEXT1
    ' I8 u! }! c/ L; g: v) T9 `
94. //
    : r- u$ t$ X' Y1 w. f& k
95. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT1),&GUI_Font24B_ASCII);
    
96. //
    
97. //GUI_ID_EDIT1
    % c0 w9 n4 |' A4 `
98. //
    4 @" ~' c" W3 C6 b
99. EDIT_SetFont(WM_GetDialogItem(hWin,GUI_ID_EDIT1),&GUI_Font16B_ASCII);
    
100. EDIT_SetHexMode(WM_GetDialogItem(hWin,GUI_ID_EDIT1),65535,0,255);（1）
     
101. //
     
102. //GUI_ID_EDIT2
     
103. //
     6 V# Y# w1 h2 s. v; H2 E  O# M
104. EDIT_SetFont(WM_GetDialogItem(hWin,GUI_ID_EDIT2),&GUI_Font16B_ASCII);
     2 h0 X6 U$ O; v' f6 R
105. EDIT_SetBinMode(WM_GetDialogItem(hWin,GUI_ID_EDIT2),240,0,255);（2）
     
106. //
     
107. //GUI_ID_EDIT3
     4 _1 q5 u, h  \7 ~* S
108. //
     & d% @, h1 ^5 T% v/ B
109. EDIT_SetFont(WM_GetDialogItem(hWin,GUI_ID_EDIT3),&GUI_Font16B_ASCII);
     5 c. _$ ]3 w& @$ F3 E
110. EDIT_SetDecMode(WM_GetDialogItem(hWin,GUI_ID_EDIT3),128,0,255,0,0); （3）
     
111. //
       N% l% Y9 ?' q+ V2 d
112. //GUI_ID_EDIT4
     . V" q6 B# }3 ^) y
113. //
     # ?3 E( h; j* D# e  m
114. EDIT_SetFont(WM_GetDialogItem(hWin,GUI_ID_EDIT4),&GUI_Font16B_ASCII);
     
115. EDIT_SetFloatMode(WM_GetDialogItem(hWin,GUI_ID_EDIT4),12.12346,0,255,6,0); （4）
     
116. 
     7 A% D. k% ]' i; a% L
117. }
     ! b1 @$ w1 g* e: t6 X- M
118. 
     % l. f* _- E! |, J3 e( \- {& P
119. /*********************************************************************
     # E1 |( C% w0 m* }5 i7 {
120. *
     . ^5 f( X' z4 N# r1 O/ \* }% u
121. * Dialog callback routine
     
122. */
     2 j  o& _7 @' E5 ^+ ~/ D
123. static void _cbCallback(WM_MESSAGE * pMsg)
     8 Q- r7 ]) i1 F1 J! ~0 x* k; L
124. {
     " b. u- ?# n( _0 w
125. int NCode, Id;
     
126. WM_HWIN hWin = pMsg->hWin;
     
127. switch (pMsg->MsgId)
     
128. {
     ' m& |% ]5 m% i0 _( ^+ t$ d
129. case WM_PAINT:
       A' W3 V2 g4 Y4 t3 f, G7 _
130. PaintDialog(pMsg);
     * i0 |2 ^- _9 e. x
131. break;
     
132. case WM_INIT_DIALOG:
     7 ]3 E8 _" k5 K0 E: _8 t% L: |
133. InitDialog(pMsg);
     ) K* o# z( X$ V* `* q) n
134. break;
     
135. case WM_KEY:
     
136. switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
     ' d$ ^4 E3 G9 l: Q. c5 v
137. {
     
138. case GUI_KEY_ESCAPE:
     # U# {5 b7 `# P+ O, Q2 R
139. GUI_EndDialog(hWin, 1);
     & A& M: f1 g9 G4 `$ g  C- T
140. break;
     ! A+ [+ v1 {5 z6 Y# Z. @
141. case GUI_KEY_ENTER:
     . }( L& f/ y/ [0 o- a6 {0 n
142. GUI_EndDialog(hWin, 0);
     * n# s- ~7 A* ^. l1 M
143. break;
     
144. }
     
145. break;
     
146. case WM_NOTIFY_PARENT:
     0 E6 G; i) u6 |
147. Id = WM_GetId(pMsg->hWinSrc);
     
148. NCode = pMsg->Data.v;
     
149. switch (Id)
     
150. {
     
151. case GUI_ID_OK:
     
152. if(NCode==WM_NOTIFICATION_RELEASED)
     
153. GUI_EndDialog(hWin, 0);
     
154. break;
     
155. case GUI_ID_CANCEL:
     
156. if(NCode==WM_NOTIFICATION_RELEASED)
     % G! C6 }9 {3 z+ j, b, i
157. GUI_EndDialog(hWin, 0);
     
158. break;
     
159. 
     4 X% q' i0 Z) d" g: j, B' I5 _
160. }
     
161. break;
     
162. default:
     
163. WM_DefaultProc(pMsg);
     
164. }
     
165. }
     ; |0 b7 J4 T4 }6 B5 C' n
166. 
     
167. /*********************************************************************
     0 l6 v& C; H: u6 n" _
168. *
     " A2 `% B3 Z$ z; S
169. * MainTask
     6 f" t6 k4 c# S: y/ V: ^: u" _
170. *
     - L5 @* ?. @& x1 s0 p
171. **********************************************************************
     
172. */
     
173. void MainTask(void)
     1 D' O3 t: _$ x
174. {
     
175. GUI_Init();
     
176. WM_SetDesktopColor(GUI_WHITE); /* Automacally update desktop window */
     ' ~) T8 Q! Y2 N1 X0 C! N
177. WM_SetCreateFlags(WM_CF_MEMDEV); /* Use memory devices on all windows to avoid flicker */
     
178. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     
179. FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
     3 I$ j* O  ?: }  l% Z
180. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     # V& s& ?& Y# f0 ~
181. BUTTON_SetDefaultSkin(BUTTON_SKIN_FLEX);
     
182. CHECKBOX_SetDefaultSkin(CHECKBOX_SKIN_FLEX);
     
183. DROPDOWN_SetDefaultSkin(DROPDOWN_SKIN_FLEX);
     
184. SCROLLBAR_SetDefaultSkin(SCROLLBAR_SKIN_FLEX);
     
185. SLIDER_SetDefaultSkin(SLIDER_SKIN_FLEX);
     
186. HEADER_SetDefaultSkin(HEADER_SKIN_FLEX);
     : C! F. [- i7 K) F
187. RADIO_SetDefaultSkin(RADIO_SKIN_FLEX);
     8 q* ^! c( W0 o3 W- q0 s8 U
188. GUI_ExecDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
     
189. }

复制代码

1. 设置16进制显示。

2. 设置2进制显示。

3. 设置10进制显示。

4. 设置浮点数显示。

实际的显示效果如下：

43.4 总结

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

不错的教程

顶一个！！！

学习学习。                    

好贴，有用