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

【安富莱STemWin教程】第31章 键盘输入(实体按键操作控件)

[复制链接]
baiyongbin2009 发布时间:2015-2-13 16:31
本帖最后由 baiyongbin2009 于 2015-2-13 16:32 编辑 ! @! f) i6 u( C: C

" G8 M  s1 Y" R4 G5 m) D特别说明:完整STemWin的1-60期教程和配套实例下载地址:链接- w" X3 |! x" @8 y
第31章 键盘输入(实体按键操作控件)

  q5 b! N8 I+ V! ^
    本期教程主要跟大家讲解键盘输入,这里我们通过开发板上面带的按键进行相关的操作,在后面会专门的做一期PS2键盘的教程。
    31. 1  描述
    31. 2 驱动层API
    31. 3 实体按键操作
    31. 4 总结
" [; m% K, i- E
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.1.png
31.3 实体按键操作
下面给大家讲解一下通过开发板上面带的按键来操作控件。按键的驱动请看安富莱STM32-V5开发板_用户手册的第20章:按键FIFO教程。此工程主 要分为两部分:
  Ø 按键任务
  Ø STemWin主任务
按键任务:
  1. /*
    , Y/ r; u$ F' }$ j
  2. *********************************************************************************************************
    7 }" k" T) O% S( u! y* t  k
  3. *        函 数 名: AppTaskUserIF
    % C- x9 H2 ]) i2 y4 K! z
  4. *        功能说明: 此函数主要用于得到按键的键值。
    - X* e( }, Z) b& W3 R+ y: \7 H
  5. *        形    参:p_arg 是在创建该任务时传递的形参
      @1 @" B  Z% R+ q) k" X) J" y
  6. *        返 回 值: 无- L& ~; w4 B$ A, i
  7. 优 先 级:2+ T  D& P; l. z7 k% N# D3 s! Q2 E. L3 r
  8. *********************************************************************************************************( q+ c0 X2 w! p  \; i; K* z
  9. */$ X3 u- i! F4 `9 S+ S* g8 e! M
  10. static void AppTaskUserIF(void *p_arg)2 S" h! P. |2 B/ G
  11. {8 n. s" ?" J* ]- }5 {
  12. uint8_t ucKeyCode;
    / I# G! X/ h3 O# c. A* e% [! h: Z3 ]5 U

  13. 8 C5 [8 j6 b6 R3 w' B# s/ K3 `
  14. (void)p_arg;                       /* 避免编译器报警 */1 x- {* [# H# e% T( _4 }4 s
  15. 2 a- b* _) a! ?2 m
  16. while (1) 9 [) G# [* d1 k2 L
  17. {   7 e( n8 ]0 h! i
  18. bsp_KeyScan();. M/ E& e6 ]+ U6 h7 |
  19. ucKeyCode = bsp_GetKey();
    . Z. f) w* c% w
  20. if(ucKeyCode != KEY_NONE)1 s3 M& V- K/ ~2 [, C4 C& y
  21. {
    & u4 r9 I  Q9 s1 k. n0 B2 Q
  22. switch (ucKeyCode)1 H) C1 ]$ `0 b/ Z7 j7 x
  23. {( t+ Y8 Q& U3 C3 X% D, Y# z+ C
  24. case KEY_DOWN_K1:         /* K1键按下 实现截图*/                                (1)
    6 D& S/ G% Z- ?! E
  25. BSP_OS_SemPost(&SEM_SYNCH);
      E3 q  [: z7 e3 Q
  26. break;
    , D' k' L4 [$ _& ^5 Z4 l
  27. 5 s7 ?7 K. u8 s
  28. case KEY_DOWN_K2:         /* K2键按下 实现TAB按键的功能*/                      (2)% p" j8 l6 q8 C' Q( Y$ K" ]
  29. GUI_SendKeyMsg(GUI_KEY_TAB, 1);
    ' T4 q  a5 ?( u' c% S/ ^
  30. break;
    : `# T2 O& E6 }8 V

  31. 9 S+ Q8 V0 h" f9 X+ u; n% P
  32. case KEY_DOWN_K3:         /* K3键按下 实现CANCEL的功能 */                      (3)1 l7 [. @5 `; p' O- s& y
  33. GUI_SendKeyMsg(GUI_KEY_ESCAPE, 1);
    $ B/ W/ I0 X( T  p. q5 y8 N+ T
  34. break;
    ( I3 ]1 z" L1 i( O. N. v
  35. (4)
    7 r$ I, ?% @% y1 u
  36. case JOY_DOWN_U:         /* 摇杆UP键按下 实现删除字符功能,注意和BACKSPACE回格的区别*/. k; s) ^0 X, S$ J
  37. GUI_SendKeyMsg(GUI_KEY_DELETE, 1);! l, |/ s8 i8 J  {' z: X
  38. break;8 f& e# l, N) p

  39. + j" C3 n5 X3 P; u5 W- J
  40. case JOY_DOWN_D:         /* 摇杆DOWN键按下 实现删除字符 */                    (5)
    ' o! C( V+ {8 V! M8 Z
  41. GUI_SendKeyMsg(GUI_KEY_BACKSPACE, 1);
    ; _) ?+ G8 D$ @
  42. break;( X3 d4 J* c0 ~$ A0 [8 f  ~; M

  43. ) W' @" Z+ P0 t8 Y2 E9 Z
  44. case JOY_DOWN_L:         /* 摇杆LEFT键按下 实现光标左移 */                    (6)
    - ?% L6 S2 C. X: s
  45. GUI_SendKeyMsg(GUI_KEY_LEFT, 1);
    8 ~% f$ c! E" A. \* o8 i
  46. break;
    5 Y6 b8 h4 w. L+ B

  47. ! M* G7 X+ B1 Z; u, Q
  48. case JOY_DOWN_R:         /* 摇杆RIGHT键按下 实现光标右移 */                   (7)8 l( m2 L; x8 H3 S2 @: ^
  49. GUI_SendKeyMsg(GUI_KEY_RIGHT, 1);$ @/ t  w9 S8 W+ d
  50. break;
    1 V4 `  p8 Q* I) A

  51. + o3 z0 j$ I. n
  52. case JOY_DOWN_OK:         /* 摇杆OK键按下 实现OK */                           (8)% c/ B8 y9 m7 G& G. U
  53. GUI_SendKeyMsg(GUI_KEY_ENTER, 1);; @; s0 R4 l2 ~1 `+ o! u
  54. break;
    3 ?( j, b: [$ j( H. W" ~
  55. . k1 n7 Y4 |3 r, {' B" V
  56. default:4 V& P4 Y' ^) B) a- O, I* @+ M# m
  57. /* 其它的键值不处理 */
    . B& R1 J3 T& A; T$ S* h; ?  a0 T0 [6 \( u8 K
  58. break;
    ( y( B8 o  g2 x! e# \
  59. }
    3 O+ U7 W( n; A  T2 u
  60. }
    " o, r7 D* U1 R; v
  61.         BSP_OS_TimeDlyMs(10);2 I+ c1 ?) [" ~; x$ h! L' c' a
  62. }
    6 M8 {+ B4 \# Q6 c$ o
  63. }
复制代码
1. 按下按键1实现截图功能。
2. 实现TAB按键的功能。
3. 实现CANCEL的功能
4. 实现删除字符的功能,注意和BACKSPACE回个的区别。
5. 实现删除字符
6. 实现光标左移。
7. 实现光标右移。
8. 实现OK键功能。
STemWin主任务:
  1. #include "includes.h"
    5 B8 W  h$ P# h" v
  2. #include "MainTask.h"
    4 B2 e" W$ b6 B7 ~2 m

  3. + D0 V& y* m5 y- A( ]

  4. * V1 @/ p7 j3 n" C$ D
  5. /*
    2 ]7 ~/ V# E# K" d0 Q; a
  6. ********************************************************************************************************
    % V( W# x7 ]8 ]1 N3 C2 f% |( N
  7. *                             静态数据
    0 E* u+ f  G0 X, a0 U
  8. ********************************************************************************************************
    ( J9 P) V' h$ a! n" J3 v) m; |
  9. */
    % M6 w0 l7 }( J% ]
  10. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
      p  z7 Q' j" z' Z
  11. {
    : x$ ]( G3 J6 ^! D+ D% R% Z* c' ^
  12. { FRAMEWIN_CreateIndirect, "Edit winmode", 0,         90,  90, 140, 130, FRAMEWIN_CF_MOVEABLE},
    , d2 \" h5 Q$ `" V& D8 V; Y
  13. { EDIT_CreateIndirect,     NULL,     GUI_ID_EDIT0,    10,  10, 110,  20, 0, 15},
    ' M; t0 h; t2 Z
  14. { EDIT_CreateIndirect,     NULL,     GUI_ID_EDIT1,    10,  40, 110,  20, 0, 15},
    5 b7 n  l/ K3 P; s
  15. { BUTTON_CreateIndirect,   "Ok",     GUI_ID_OK,       10,  80,  50,  20 },- q& J( V. [- `3 {2 e
  16. { BUTTON_CreateIndirect,   "Cancel", GUI_ID_CANCEL,   70,  80,  50,  20 },9 z" `/ E' A! B. A, D+ e( L" r
  17. };
    , ]" E. J$ t* R. Y# f) A' b

  18. 7 G5 B6 j/ `; d5 m, y8 d+ z
  19. static char * _apExplain[] = * d) ^8 q5 r; c( q- _' V) J
  20. {% @: V& x: M6 d# _2 M$ D
  21. "This sample shows how to use edit widgets with a",
    9 x6 s8 r8 V7 M
  22. "user defined callback function and how to set a",
    ( ^, r. Y! w$ B/ j8 s$ d
  23. "user defined AddKey function. It selects the",
    % j! b- F1 h/ X, v3 @
  24. "contents of the edit field on receiving the focus",( u+ L' Q  J8 E; S4 B+ D0 d
  25. "and overwrites the contents if a key other than",
    , y2 F! }- x3 v$ j7 {, V% [
  26. "a cursor key is pressed.",
    : E2 \( L( A- V/ a% H: o
  27. };5 S% D- A, E" m" E4 n" @
  28. 2 T( O" L9 A* M% I
  29. /*% \8 x3 {/ x( p
  30. *********************************************************************************************************9 R/ C: f. j: `# Q* W3 e1 _' t
  31. *        函 数 名: _cbDialog  K3 c3 x2 p: L
  32. *        功能说明: 对话框的回调函数
    $ K, `. L$ P" @/ w6 @( U  \# j0 E
  33. *        形    参:pMsg 消息指针4 n! i! v; V2 R) Y6 b) a3 G; Y6 s
  34. *        返 回 值: 无
    : B' Q0 `" \0 J+ ^0 R( p) }
  35. *********************************************************************************************************& ]3 h, Y- r& A5 s% `# }# e
  36. */$ E; a  ^$ j% m
  37. static void _cbDialog(WM_MESSAGE * pMsg)
    , w- `/ I) A* L6 S4 q: X
  38. {9 C4 y' h8 R3 I& [; V3 Q6 b; H& L* }
  39. int     i;
    5 B! U# R; D" `8 ^
  40. int     NCode;
    ) o& Q. b6 t) i4 b. l, B
  41. int     Id;
    ! D" _8 j$ p: H1 N8 F" R; y# p9 b7 X
  42. WM_HWIN hDlg;
    ; H" E* d! g, D6 j4 }2 F! ^- v6 y
  43. WM_HWIN hItem;+ ?4 [/ U* h' U3 t# K* x( M0 W, W6 n

  44. ; \5 u9 [: S# u
  45. hDlg = pMsg->hWin;! _* \5 Y  k6 C7 u
  46. switch (pMsg->MsgId)
    : G& E7 ~9 S0 X/ N3 ^0 e
  47. {
    1 Y" P; v. }! o" c% R' o2 f/ W3 g' Y
  48. case WM_INIT_DIALOG:
    0 C- e7 r9 d( {- Z7 k' l* j
  49. FRAMEWIN_SetFont(pMsg->hWin, &GUI_Font13_ASCII);
    , z- b" n$ ^8 n; q
  50. FRAMEWIN_SetTextAlign(pMsg->hWin, GUI_TA_HCENTER);" v+ R3 Y% q( u: P, |/ s* a
  51. for (i = 0; i < 2; i++) ( ], h' z8 p# O
  52. {! `" a/ g( l/ ~2 j+ Z, E
  53. hItem = WM_GetDialogItem(hDlg, GUI_ID_EDIT0 + i);  // Get the handle of the edit widget6 S# N. Z# I4 a
  54. }3 n8 b. ^1 }0 S
  55. break;
    6 f# A- i7 s9 i/ ]; z! @
  56. case WM_KEY:' A/ y$ L" ^; b( K
  57.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
    / ^$ \. y6 K2 p' b+ R5 \
  58.             { - J) y. B, U( j- D% d
  59. case GUI_KEY_ESCAPE:
    $ s" y* B: V+ {9 k
  60.                     GUI_EndDialog(hDlg, 1);+ V/ e0 _' a3 a- P
  61.                     break;7 p, J" y5 p. W* \
  62.                 case GUI_KEY_ENTER:* b8 a4 R! r5 I, E) |( c% l  V
  63.                     GUI_EndDialog(hDlg, 0);
    & o0 H1 ^6 j0 w$ W
  64.                     break;
    ! j. _8 I  [# U& Q% G7 K
  65.             }
    1 r, J/ y6 T4 b9 i9 p
  66.             break;# a  Y5 F% T/ Y5 Q
  67. case WM_NOTIFY_PARENT:/ k; E  Z, X# l
  68. Id    = WM_GetId(pMsg->hWinSrc);      // Id of widget$ D* i, `, f/ z* L; a2 g7 @7 U! j
  69. NCode = pMsg->Data.v;                 // Notification code
    ; J& K3 B  q5 ?& @
  70. switch (NCode) # A1 B3 ?% z" X8 [. q. E+ A# F
  71. {
    % Z- b% w; k- y* D8 f6 T( B
  72. case WM_NOTIFICATION_RELEASED:      // React only if released0 Q: Y* k( Z  t5 y/ M
  73. if (Id == GUI_ID_OK) 1 ^2 o9 W6 ~0 x- K/ [7 Q
  74. {         // OK Button
    % g* Y' y2 X! M' d1 L  ?& L
  75. GUI_EndDialog(hDlg, 0);7 y/ Y* f# X, W* t. n
  76. }% ^( ?5 R* g, j. e* w6 @  k/ \
  77. if (Id == GUI_ID_CANCEL) ( j% P- ~. E+ H" A! t
  78. {        // Cancel Button
    : m  ~2 Q  {; A
  79. GUI_EndDialog(hDlg, 1);
    ) Y) C5 a" _& w% U# y" `, S9 M
  80. }
    / ?/ J: g: B# i  O& v# M
  81. break;* T) i6 Q* D5 E- H
  82. }
    4 n: o& Q: u1 j+ U  |+ M% J  q3 l
  83. break;. L& H" i  h5 h- H0 y: i
  84. default:; ^! J; z6 P! u* ?5 E
  85. WM_DefaultProc(pMsg);
    ( ?# b3 P" E% {, J! L  Y: w, S
  86. }* k  {4 q* H( D" G( r
  87. }
    ' b! @9 B4 L9 q0 C9 P

  88. ' p. y2 V, K0 L+ N/ E
  89. /*
    - n6 r& F& \. x3 ?
  90. *********************************************************************************************************( Q& x( R, f$ y- K% F' N  l6 O" d1 K( `
  91. *        函 数 名: _cbDesktop
    " {* ^( I! _& W( c1 L
  92. *        功能说明: 桌面窗口的回调函数+ J1 M- i8 [+ D* D
  93. *        形    参:pMsg 消息指针
    9 ^" O" |- ?! j, Z
  94. *        返 回 值: 无+ S: P2 n* D$ w1 w
  95. *********************************************************************************************************% ~+ ~: Y7 e' c1 s' {
  96. *// ~6 j  ]/ u% z. ]9 d& P9 x* g
  97. static void _cbDesktop(WM_MESSAGE * pMsg)
    6 M( j1 j+ i0 E1 ]& M% M
  98. {
    * S  `+ P: X1 Z; o# T
  99. unsigned i;7 S1 V! z* }3 `$ F. x

  100. ) [  I7 X( h- J
  101. switch (pMsg->MsgId) 8 y9 @" p- A1 a* c/ F% z
  102. {
    . f( ~; b0 J) h& b2 `
  103. /* 重绘 */; d( J$ h7 s: Q- u# }6 j
  104. case WM_PAINT:! O4 n; X6 `! |- B
  105. GUI_SetBkColor(GUI_RED);# o! w* \8 F; A+ G" V2 M+ t
  106. GUI_Clear();
    + Q+ u9 u. U) Q4 ]
  107. GUI_SetFont(&GUI_Font24_ASCII);
    1 R' e0 a3 D: {( y
  108. GUI_DispStringHCenterAt("WIDGET_EditWinmode", 160, 5);
    " l( s+ r" x3 s1 X& i
  109. GUI_DispNextLine();0 V. n/ Z! g9 l
  110. GUI_SetFont(GUI_DEFAULT_FONT);8 |7 p2 ?; a4 S' x
  111. GUI_DispNextLine();
    + F# r4 [! r% I/ j
  112. for (i = 0; i < GUI_COUNTOF(_apExplain); i++)
    - O. |7 D% C9 C$ b" R$ A0 y
  113. {
    : W$ s( U: f- X0 P' L
  114. GUI_DispStringHCenterAt(_apExplain[i], 160, GUI_GetDispPosY());& |: Y2 ^: Y$ p& f7 b4 j! _
  115. GUI_DispNextLine();
    + Q- U) J# _& a
  116. }. Z5 ]4 i+ L3 l7 R# d+ T
  117. break;  {8 `* r. G0 h5 _+ G1 [
  118. }
    5 Z% N' S' K2 U& t: o3 I
  119. }
      Q+ n- l0 n& K

  120. 7 [7 S: {) ^  ~; W4 y3 P; @) @: w
  121. /*. A) R) R% ^# l6 t. {; R
  122. *********************************************************************************************************4 K; T6 P% @! o
  123. *        函 数 名: MainTask
    2 g- }# B1 ~/ C* b
  124. *        功能说明: GUI主函数
    % B+ @" ]/ E+ d2 O% @
  125. *        形    参:无
    & ?+ L& i6 o. Z9 Q" _; o( J
  126. *        返 回 值: 无
    ' R# Y) \+ G% A3 F: R5 |
  127. *********************************************************************************************************
    " r# O, L, x9 ^2 h
  128. */6 P. r6 I( I3 s. n$ f  i# W" L
  129. void MainTask(void) # C7 l4 @" G  g9 r- C+ j
  130. {8 ~5 E9 a- n2 s; z, j) ^% C
  131. GUI_Init();
    & ]( c) r7 l$ w
  132. WM_SetCallback(WM_HBKWIN, _cbDesktop);
    6 t7 x( ?" x) j# U
  133. while(1) ! n/ q7 Y6 e. @) n  M
  134. {( r0 W% x% W  ]5 A* }1 R0 I' V: G
  135. /* 创建阻塞式对话框 */2 _8 s0 W5 X( \
  136. GUI_ExecDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbDialog, 0, 0, 0);
    + }. E* H' s* I2 h
  137. GUI_Delay(1000);
    8 \2 Q  v8 l9 Y( K
  138. }
    # H. m$ Z: |1 ?$ J* a8 k7 {
  139. }
复制代码
1. 上面的程序比较简单,主要是在对话框上面显示一个编辑框(初学的不要担心,后面教程会有这些控件的讲解)。
2. K1按键实现的是TAB键的功能,主要是实现对话框上面控件的聚焦切换。
    其余的按键功能比较简单,实际操作下就明白了,上面的代码中也有相应的注释。
    尝试了一下自定义按键消息没有成功,后面再试试。
3. 按键具体的通讯机制会在后面的教程中再跟大家讲解。
实际的显示效果如下:
31.2.png
31.4 总结
    本期教程就跟大家讲这么多,主要是想通过本期教程让大家对实体按键操作控件有一个了解。这个过程还需要大家对通信机制有所了解。在后面的教程中会跟大家详细讲解通信机制这块。
( u" h0 E8 G. D5 ?, N9 k
赞 收藏 评论1 发布时间:2015-2-13 16:31

举报

1个回答
lkl0305 回答时间:2015-2-13 23:31:04
多谢分享,学习下
关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版