特别说明：完整STemWin的1-60期教程和配套实例下载地址：链接
$ q6 b' m5 P- g' A. g1 ^

第31章 键盘输入（实体按键操作控件）

    本期教程主要跟大家讲解键盘输入，这里我们通过开发板上面带的按键进行相关的操作，在后面会专门的做一期PS2键盘的教程。

    31. 1  描述

    31. 2 驱动层API

    31. 3 实体按键操作

    31. 4 总结

+ Z5 u) K" ?  R  \31.1 描述

    键盘输入设备使用ASCII字符编码，以便区分不同的字符。例如，键盘上只有一个“A”键，但大写的“A”与小写的“a”拥有不同的ASCII编码 （分别为0x41和0x61）

STemWin预定义字符编码

    STemWin 同时定义了其他“虚拟”键盘操作的字符编码。这些编码如下表所示，由GUI.h中的标识符表中定义。因此，在emWin中，字符编码可以是任意扩展ASCII字符值，也可以是任意下列预定义的emWin值。

预定义的虚拟键盘码	描述
GUI_KEY_BACKSPACE	退格键
GUI_KEY_TAB	制表键
GUI_KEY_ENTER	回车键
GUI_KEY_LEFT	左箭头键
GUI_KEY_UP	上箭头键
GUI_KEY_RIGHT	右箭头键
GUI_KEY_DOWN	下箭头键
GUI_KEY_HOME	本位键（移至当前行的开头）
GUI_KEY_END	结束键（移至当前行的末尾）
GUI_KEY_SHIFT	换挡键
GUI_KEY_CONTROL	控制键
GUI_KEY_ESCAPE	换码键
GUI_KEY_INSERT	插入键
GUI_KEY_DELETE	删除键

31.2 驱动层API

   键盘驱动层处理键盘消息函数。这些程序会在具体键 （或组合键）被按下或松开时通知窗口管理器。

下表按字母顺序列出了驱动层键盘程序。详细描述

程序	描述
GUI_StoreKeyMsg()	把消息存储于指定键
GUI_SendKeyMsg()	把消息发送至指定键。

l 函数GUI_StoreKeyMsg()

    把消息数据(Key, PressedCnt)存进键盘缓冲器，Key表示可以是任意扩展ASCII字符 （范围为0x20至0xFF）或者任意预定义的emWin字符编码。PressedCnt表示松开或者未按下的状态。

    该函数可从中断服务程序调用。STemWin的键盘输入管理器含有一个FIFO缓冲器，默认情况下最多可以保存10个键盘事件。如果需要不同的尺寸，可以更改该值。

l 函数GUI_SendKeyMsg()

    把键盘数据发送到输入焦点所在窗口。如果没有窗口有输入焦点，则调用GUI_StoreKeyMsg()函数将数据存储至输入缓冲器之中。该函数不可从中断服务程序调用。该函数的参数和上面函数的参数是一样的。

    应用层的如下几个函数就先不做介绍了，使用到的时候再做介绍：

31.3 实体按键操作

下面给大家讲解一下通过开发板上面带的按键来操作控件。按键的驱动请看安富莱STM32-V5开发板_用户手册的第20章：按键FIFO教程。此工程主 要分为两部分：

  Ø 按键任务

  Ø STemWin主任务

按键任务：

1. /*
   0 a) A0 ^' E' w# e$ g
2. *********************************************************************************************************
   
3. *        函 数 名: AppTaskUserIF
   + h6 S! b8 e' t7 P7 D
4. *        功能说明: 此函数主要用于得到按键的键值。
   1 W! h0 m: f! ]3 J! i
5. *        形    参：p_arg 是在创建该任务时传递的形参
   ( D- ]0 l7 S- [2 f
6. *        返 回 值: 无
   3 T+ s1 j" D: i- s1 h% C3 U
7. 优 先 级：2
   
8. *********************************************************************************************************
   
9. */
   + e0 o4 r# X9 p0 v& G7 O) s8 C
10. static void AppTaskUserIF(void *p_arg)
    * `2 {" o/ v/ x8 N+ d
11. {
    # Z: D1 U7 E) Z6 C# `, o5 |. W
12. uint8_t ucKeyCode;
    
13. 
    6 u; G9 A1 S1 f2 e/ h
14. (void)p_arg;                       /* 避免编译器报警 */
    
15. 
    % X+ S" h3 h) F; L- Q8 M9 N# b" l
16. while (1)
    9 L: w, C% i' V) B) ]* V9 L4 t
17. {   
    
18. bsp_KeyScan();
    
19. ucKeyCode = bsp_GetKey();
    8 \! C; S) a+ e+ W: P* [  j/ N' T  y
20. if(ucKeyCode != KEY_NONE)
    
21. {
    
22. switch (ucKeyCode)
    
23. {
    8 p# e1 s7 n7 F# B( a& q# U/ [$ i
24. case KEY_DOWN_K1:         /* K1键按下 实现截图*/                                （1）
    
25. BSP_OS_SemPost(&SEM_SYNCH);
    - X  Z/ n9 s( `& J+ F
26. break;
    
27. 
    
28. case KEY_DOWN_K2:         /* K2键按下 实现TAB按键的功能*/                      （2）
    6 ?7 ?, v7 S, a6 |* e5 V3 ]
29. GUI_SendKeyMsg(GUI_KEY_TAB, 1);
    $ R6 e8 o% R; Q) c# L& f2 K
30. break;
    ! z" g7 g! O* B) w6 }* K+ c
31. 
    ' e3 \' ?0 H* M$ V1 s- b) ?- _7 C
32. case KEY_DOWN_K3:         /* K3键按下 实现CANCEL的功能 */                      （3）
    0 o2 T0 T: y7 v) E2 e
33. GUI_SendKeyMsg(GUI_KEY_ESCAPE, 1);
    
34. break;
    
35. （4）
    
36. case JOY_DOWN_U:         /* 摇杆UP键按下 实现删除字符功能，注意和BACKSPACE回格的区别*/
    : G8 U  u, @) q& _3 F1 q3 @
37. GUI_SendKeyMsg(GUI_KEY_DELETE, 1);
    
38. break;
    ! j; F+ ^- P) h: z2 _
39. 
    7 J/ Z2 Q$ a5 h: c
40. case JOY_DOWN_D:         /* 摇杆DOWN键按下 实现删除字符 */                    （5）
    
41. GUI_SendKeyMsg(GUI_KEY_BACKSPACE, 1);
    
42. break;
    
43. 
    " w) m" y/ A( N% b2 z2 c' G
44. case JOY_DOWN_L:         /* 摇杆LEFT键按下 实现光标左移 */                    （6）
    8 x3 l" \; a' n4 W+ k* _
45. GUI_SendKeyMsg(GUI_KEY_LEFT, 1);
    
46. break;
    ' X" V( Y% P& }! [# O# _8 Q5 \: o# W
47. 
    
48. case JOY_DOWN_R:         /* 摇杆RIGHT键按下 实现光标右移 */                   （7）
    - m" J9 _/ g# @5 f6 J1 D
49. GUI_SendKeyMsg(GUI_KEY_RIGHT, 1);
    
50. break;
    
51. 
    
52. case JOY_DOWN_OK:         /* 摇杆OK键按下 实现OK */                           （8）
    
53. GUI_SendKeyMsg(GUI_KEY_ENTER, 1);
    ' l, T% R% i" x7 m7 j
54. break;
    & s* W3 I, Z  t7 f0 D: D; ^
55. 
    ' F6 @9 M+ E. `( K( d/ ]  ^
56. default:
    
57. /* 其它的键值不处理 */
    & V6 @% b& D: `& k6 T/ K. M
58. break;
    9 t1 a, ?/ O) ~  K  Q
59. }
    
60. }
    
61.         BSP_OS_TimeDlyMs(10);
    # ~. X* w- o* K0 R  W! \
62. }
    
63. }

复制代码

1. 按下按键1实现截图功能。

2. 实现TAB按键的功能。

3. 实现CANCEL的功能

4. 实现删除字符的功能，注意和BACKSPACE回个的区别。

5. 实现删除字符

6. 实现光标左移。

7. 实现光标右移。

8. 实现OK键功能。

STemWin主任务：

1. #include "includes.h"
   
2. #include "MainTask.h"
   
3. 
   
4. 
   
5. /*
   
6. ********************************************************************************************************
   
7. *                             静态数据
   
8. ********************************************************************************************************
   
9. */
   
10. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
    " K1 k/ d' D- j# @" `2 n% T
11. {
    1 C5 m  S% }  f4 g7 D) V0 t, r
12. { FRAMEWIN_CreateIndirect, "Edit winmode", 0,         90,  90, 140, 130, FRAMEWIN_CF_MOVEABLE},
    ( D7 V8 i9 A8 ^9 D( [5 L) r* @
13. { EDIT_CreateIndirect,     NULL,     GUI_ID_EDIT0,    10,  10, 110,  20, 0, 15},
    ( V4 N% N! M' q
14. { EDIT_CreateIndirect,     NULL,     GUI_ID_EDIT1,    10,  40, 110,  20, 0, 15},
    
15. { BUTTON_CreateIndirect,   "Ok",     GUI_ID_OK,       10,  80,  50,  20 },
    0 t! L5 D- K  i0 Y
16. { BUTTON_CreateIndirect,   "Cancel", GUI_ID_CANCEL,   70,  80,  50,  20 },
    
17. };
    ) u1 p# j% L) b8 f
18. 
    . ?( P0 _* B! `& o
19. static char * _apExplain[] =
    
20. {
    0 O  p" z: u  E3 w: B4 K. l  ]4 O
21. "This sample shows how to use edit widgets with a",
    6 X9 }' L+ S9 _) K3 G
22. "user defined callback function and how to set a",
    
23. "user defined AddKey function. It selects the",
    
24. "contents of the edit field on receiving the focus",
    $ b) i3 l8 o" R$ O& W' o9 d4 k
25. "and overwrites the contents if a key other than",
    
26. "a cursor key is pressed.",
    
27. };
    ) _9 C0 Z: H' K, u5 n) K: D2 H
28. 
    
29. /*
    
30. *********************************************************************************************************
    * Y# ^' R% t! [4 `1 [+ F* s3 U
31. *        函 数 名: _cbDialog
    
32. *        功能说明: 对话框的回调函数
    
33. *        形    参：pMsg 消息指针
    
34. *        返 回 值: 无
    
35. *********************************************************************************************************
    
36. */
    2 m( k" G+ R# I. S* U/ |' }4 A
37. static void _cbDialog(WM_MESSAGE * pMsg)
    
38. {
    
39. int     i;
    8 C3 f+ T7 p; ^
40. int     NCode;
    
41. int     Id;
    , u0 A" K, {1 x: R; o
42. WM_HWIN hDlg;
    
43. WM_HWIN hItem;
    9 |- J) c# [0 s: G5 `% V) E/ w
44. 
    
45. hDlg = pMsg->hWin;
    7 S2 S& ~3 z# f) Q& q1 m
46. switch (pMsg->MsgId)
    , e0 _0 |5 }9 B1 ]( E
47. {
    - f. d6 a7 S. D% K8 n
48. case WM_INIT_DIALOG:
    : a2 t5 R- x6 \2 C4 Y0 D
49. FRAMEWIN_SetFont(pMsg->hWin, &GUI_Font13_ASCII);
    6 c2 W8 h3 j) v5 v! |6 w& P
50. FRAMEWIN_SetTextAlign(pMsg->hWin, GUI_TA_HCENTER);
    * Z" L$ U$ i% ~8 c, ~2 `+ m
51. for (i = 0; i < 2; i++)
    8 d, K+ Z; S  A% A" ^  t6 _9 P
52. {
    , o0 h% l8 V' h- V' L8 Z$ g( d9 y
53. hItem = WM_GetDialogItem(hDlg, GUI_ID_EDIT0 + i);  // Get the handle of the edit widget
    2 w6 Q6 u: i7 `; M. h1 i8 B
54. }
    
55. break;
    8 k) R, ?0 J$ }8 r
56. case WM_KEY:
    ' U! p: R7 [1 o
57.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
    
58.             {
    
59. case GUI_KEY_ESCAPE:
    , H! E7 P, H2 w3 g  n! g2 d( A4 |
60.                     GUI_EndDialog(hDlg, 1);
    2 D/ D0 r+ Q% Z$ D7 t
61.                     break;
    & H7 Q5 G5 `% M! m9 W
62.                 case GUI_KEY_ENTER:
    4 S/ J3 t- o- I9 r! M8 M
63.                     GUI_EndDialog(hDlg, 0);
    
64.                     break;
    
65.             }
    6 S+ p) L2 J. v9 p- D
66.             break;
    
67. case WM_NOTIFY_PARENT:
    
68. Id    = WM_GetId(pMsg->hWinSrc);      // Id of widget
    
69. NCode = pMsg->Data.v;                 // Notification code
    
70. switch (NCode)
    
71. {
    
72. case WM_NOTIFICATION_RELEASED:      // React only if released
    7 J2 o. a2 k" Z6 f/ I- q1 U
73. if (Id == GUI_ID_OK)
    
74. {         // OK Button
    % }+ k! [) a( z" ~
75. GUI_EndDialog(hDlg, 0);
    2 v& h+ M/ G/ S0 f: @1 t' m
76. }
    
77. if (Id == GUI_ID_CANCEL)
    
78. {        // Cancel Button
    8 B2 Z# r0 |+ |7 @4 I) j
79. GUI_EndDialog(hDlg, 1);
    
80. }
    ' d+ |+ m# ^9 D% k# D# D( g
81. break;
    
82. }
    
83. break;
    
84. default:
    & Y4 }9 x# B" K+ w  \: `6 P
85. WM_DefaultProc(pMsg);
    , J. G9 r! u$ I8 S7 Z- N; O2 n$ d% g
86. }
    9 M5 Y0 I; a! ^: _+ i  {
87. }
    
88. 
    & e6 h4 u4 N( L( U
89. /*
    8 Z& w, u0 ~( \8 x* [
90. *********************************************************************************************************
    ) w3 J( H" c" I
91. *        函 数 名: _cbDesktop
      M: x. v" i) f- g4 ]# W3 A5 E
92. *        功能说明: 桌面窗口的回调函数
    
93. *        形    参：pMsg 消息指针
    / q2 k3 g5 K- M& G
94. *        返 回 值: 无
    - z/ \) f' g8 p2 M: B# X
95. *********************************************************************************************************
    
96. */
    
97. static void _cbDesktop(WM_MESSAGE * pMsg)
    
98. {
    % w& B. w2 I+ I; U6 X+ z
99. unsigned i;
    / F% i! p3 _1 n  L
100. 
     
101. switch (pMsg->MsgId)
     : T! ^3 E7 _. b  V) L2 ?
102. {
     - ], l$ s' v1 e* i
103. /* 重绘 */
     ) O' z5 P* V% e2 J/ B
104. case WM_PAINT:
     , K( L  t. T5 T: b* z
105. GUI_SetBkColor(GUI_RED);
     ( X* N4 A$ w  X* n) ?& ~' ~
106. GUI_Clear();
     4 P8 c2 m# M  Z" c0 d8 N, p
107. GUI_SetFont(&GUI_Font24_ASCII);
     
108. GUI_DispStringHCenterAt("WIDGET_EditWinmode", 160, 5);
     
109. GUI_DispNextLine();
     4 M+ Z5 f8 d9 N
110. GUI_SetFont(GUI_DEFAULT_FONT);
     4 E" C# @6 y' v/ |% X+ C+ w' A
111. GUI_DispNextLine();
     
112. for (i = 0; i < GUI_COUNTOF(_apExplain); i++)
     
113. {
     
114. GUI_DispStringHCenterAt(_apExplain[i], 160, GUI_GetDispPosY());
     
115. GUI_DispNextLine();
     + v/ S& R+ N* D5 U
116. }
     
117. break;
     $ I" s. E& P7 \5 M7 h! X6 J. z
118. }
     ) [- Y# M# p, `
119. }
     " z( ^3 h. x' G: s3 b$ m
120. 
     
121. /*
     
122. *********************************************************************************************************
     
123. *        函 数 名: MainTask
     ' {: f' U0 }! [3 L
124. *        功能说明: GUI主函数
     ' n; o3 c7 ]$ e% T2 O' A# u7 G
125. *        形    参：无
     7 _6 y( y0 T/ ~# C. `
126. *        返 回 值: 无
     3 K$ B4 ?4 p; }. d, x% C: r' _+ b
127. *********************************************************************************************************
     
128. */
     / j% i# v; o! Q8 ]' W1 `' |, e
129. void MainTask(void)
     
130. {
     5 U  {- l4 L' @( c3 W2 F0 p
131. GUI_Init();
     
132. WM_SetCallback(WM_HBKWIN, _cbDesktop);
     
133. while(1)
     
134. {
     % w2 w/ @& l# w. b
135. /* 创建阻塞式对话框 */
     5 K$ V: Y0 X& l0 }
136. GUI_ExecDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbDialog, 0, 0, 0);
     
137. GUI_Delay(1000);
     $ m# m0 z; ^) f: U6 v
138. }
     
139. }

复制代码

1. 上面的程序比较简单，主要是在对话框上面显示一个编辑框（初学的不要担心，后面教程会有这些控件的讲解）。

2. K1按键实现的是TAB键的功能，主要是实现对话框上面控件的聚焦切换。

    其余的按键功能比较简单，实际操作下就明白了，上面的代码中也有相应的注释。

    尝试了一下自定义按键消息没有成功，后面再试试。

3. 按键具体的通讯机制会在后面的教程中再跟大家讲解。

实际的显示效果如下：

31.4 总结

    本期教程就跟大家讲这么多，主要是想通过本期教程让大家对实体按键操作控件有一个了解。这个过程还需要大家对通信机制有所了解。在后面的教程中会跟大家详细讲解通信机制这块。

多谢分享，学习下