【emWin实战教程V2.0】第62章 STemWin键盘输入

转最新版本教程

转最新版本教程
本章节为大家讲解键盘输入设备或者类似键盘的外部输入设备来控制emWin。实际项目中，很多时候需要使用外部
小键盘来操作emWin界面，那么学好本章节的内容就尤其重要了，望初学者务必要掌握。
      62.1 初学者重要提示
      62.2 键盘编码基础知识
      62.3 键盘相关的API函数
      62.4 实体按键操作控件说明
      62.5 实验例程说明（RTOS）
      62.6 实验例程说明（裸机）
      62.7 总结

lee_st · 2017-3-31 16:39:58

62.1  初学者重要提示

1、初学者爱问的问题简单汇总：
      问题1：为什么使用函数GUI_SendKeyMsg发送消息后，控件没有反应？
      答：首先要保证控件被聚焦，还有就是查看此控件是否支持键盘消息。

lee_st · 2017-3-31 16:40:10

2、键盘输入的所有API函数在emWin手册中都有讲解，下图是中文版手册里面API函数位置：

lee_st · 2017-3-31 16:40:22

下图是英文版手册里面API函数的位置：

lee_st · 2017-3-31 16:40:35

62.2 键盘编码基础知识

键盘输入设备或者类似键盘的外部输入设备使用ASCII字符编码，以便区分不同的字符。STemWin 同时定义了其他虚拟键盘操作的字符编码，这些编码如下表所示：

lee_st · 2017-3-31 16:41:00

通过上面的编码可以看出，基本与我们在电脑端使用的键盘编码是一样的。GUI.h文件中具体定义的键值编码如下：
/*********************************************************************
*
*       GUI_KEY_...
*
* These ID values are basically meant to be used with widgets
* Note that we have chosen the values to be close to existing
* "standards", so do not change them unless forced to.
*
*/
#define GUI_KEY_BACKSPACE         8         /* ASCII: BACKSPACE Crtl-H */
#define GUI_KEY_TAB               9         /* ASCII: TAB       Crtl-I */
#define GUI_KEY_BACKTAB           10
#define GUI_KEY_ENTER             13        /* ASCII: ENTER     Crtl-M */
#define GUI_KEY_LEFT              16
#define GUI_KEY_UP                17
#define GUI_KEY_RIGHT             18
#define GUI_KEY_DOWN              19
#define GUI_KEY_HOME              23
#define GUI_KEY_END               24
#define GUI_KEY_SHIFT             25
#define GUI_KEY_CONTROL           26
#define GUI_KEY_ESCAPE            27        /* ASCII: ESCAPE    0x1b   */
#define GUI_KEY_INSERT            29
#define GUI_KEY_DELETE            30
#define GUI_KEY_SPACE             32
#define GUI_KEY_PGUP              33
#define GUI_KEY_PGDOWN            34

#define GUI_KEY_F1                40
#define GUI_KEY_F2                41

lee_st · 2017-3-31 16:41:08

这些编码就是我们在前面所有的控件章节都有跟大家讲解的：控件支持的键盘反应。

lee_st · 2017-3-31 16:41:17

62.3 键盘相关的API函数

驱动层，键盘消息处理函数有以下两个：

lee_st · 2017-3-31 16:41:29

u  voidGUI_StoreKeyMsg(int Key, int Pressed)
      Key可以是任意扩展ASCII字符（范围为0x20至0xFF）或者任意预定义的emWin虚拟键盘编码，PressedCnt = 0表示松开或者未按下的状态，PressedCnt > 0表示按下。
      该函数支持从中断服务程序调用。另外，STemWin的键盘输入管理器含有一个FIFO缓冲，默认情况下最多可以保存10个键盘事件，如果需要修改为其它大小，可以在GUIConf.h文件中设置宏定义：
               #define  GUI_KEY_BUFFER_SIZE 10
注意一点，如果大家使用的emWin库没有将这个宏定义开放出来，即使配置了也是无效的，具体是否有效，需要大家去做实验验证。

lee_st · 2017-3-31 16:41:38

u  voidGUI_StoreKeyMsg(int Key, int Pressed)
      Key可以是任意扩展ASCII字符（范围为0x20至0xFF）或者任意预定义的emWin虚拟键盘编码，PressedCnt = 0表示松开或者未按下的状态，PressedCnt > 0表示按下。
      该函数支持从中断服务程序调用。另外，STemWin的键盘输入管理器含有一个FIFO缓冲，默认情况下最多可以保存10个键盘事件，如果需要修改为其它大小，可以在GUIConf.h文件中设置宏定义：
               #define  GUI_KEY_BUFFER_SIZE 10
注意一点，如果大家使用的emWin库没有将这个宏定义开放出来，即使配置了也是无效的，具体是否有效，需要大家去做实验验证。

lee_st · 2017-3-31 16:41:46

u voidGUI_SendKeyMsg(int Key, int Pressed)
该函数把消息发送给聚焦的控件，如果没有控件被聚焦，此消息会被存储到键盘缓冲区。另外，该函数不支持从中断服务程序调用，其它方面与函数GUI_StoreKeyMsg是一样的。

lee_st · 2017-3-31 16:41:57

应用层有以下四个函数，这个几个函数都比较易学易用，大家参看官方手册即可（如果大家有印象的话，前面几个章节讲解官方的例子时，多次用到函数GUI_GetKey，其它三个很少用到）：

lee_st · 2017-3-31 16:42:09

62.4 实体按键操作控件说明

有了前面两个小节的说明，实体按键操作控件比较容易，用户想要操作哪个控件，设置聚焦到那个控件即可，然后通过函数GUI_StoreKeyMsg或者GUI_SendKeyMsg发消息，此处使用的是函数GUI_SendKeyMsg。
我们这里是利用开发板上面的实体按键来发消息：

13^#

提示: 该帖被管理员或版主屏蔽

lee_st · 2017-3-31 16:43:13

如果大家使用的是其它类型的键盘输入设备，方法是一样的。对于emWin的界面，只要有被聚焦的控件，就可以发送相应的键盘消息给此控件。当然，不同的控件支持的键盘消息有所不同，比如本章节配套例子的部分代码：

lee_st · 2017-4-1 09:21:49

/*
*********************************************************************************************************
*                                         宏定义
*********************************************************************************************************
*/
#define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
#define ID_EDIT_0   (GUI_ID_USER + 0x01)
#define ID_EDIT_1   (GUI_ID_USER + 0x03)

/*
*********************************************************************************************************
*                           GUI_WIDGET_CREATE_INFO类型数组
*********************************************************************************************************
*/
static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
{
     { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 320, 240, 0, 0x64, 0 },
     { EDIT_CreateIndirect, "Edit", ID_EDIT_0, 88, 27, 159, 29, 0, 0x64, 0 },
     { EDIT_CreateIndirect, "Edit", ID_EDIT_1, 87, 73, 159, 30, 0, 0x64, 0 },
     { BUTTON_CreateIndirect, "Button", GUI_ID_OK, 26, 139, 97, 31, 0, 0x0, 0 },
     { BUTTON_CreateIndirect, "Button", GUI_ID_CANCEL, 179, 139, 100, 31, 0, 0x0, 0 },
};

/*
*********************************************************************************************************
*    函数名: _cbDialog
*    功能说明: 对话框的回调函数
*    形    参: pMsg 消息指针
*    返回值: 无
*********************************************************************************************************
*/
static void _cbDialog(WM_MESSAGE * pMsg)
{
     int     NCode;
     int     Id;
     WM_HWIN hDlg;
     WM_HWIN hItem;

     hDlg = pMsg->hWin;
     switch (pMsg->MsgId)
     {
         case WM_INIT_DIALOG:

             //
              // 初始化框架窗口
              //
              hItem = pMsg->hWin;
              FRAMEWIN_SetFont(hItem, GUI_FONT_24_ASCII);
              FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
              FRAMEWIN_SetText(hItem, "armfly");

              //
              // 初始化编辑框控件
              //
              hItem = WM_GetDialogItem(pMsg->hWin, ID_EDIT_0);
              EDIT_SetText(hItem, "www.armfly.com");
              EDIT_SetTextAlign(hItem, GUI_TA_LEFT | GUI_TA_VCENTER);
              EDIT_SetFont(hItem, GUI_FONT_16_ASCII);
              EDIT_SetSel(hItem, 0, -1);

              //
              // 初始化边框控件
              //
              hItem = WM_GetDialogItem(pMsg->hWin, ID_EDIT_1);
              EDIT_SetText(hItem, "www.baidu.com");
              EDIT_SetFont(hItem, GUI_FONT_16_ASCII);
              EDIT_SetTextAlign(hItem, GUI_TA_LEFT | GUI_TA_VCENTER);
              EDIT_SetSel(hItem, 0, -1);

              //
              // 初始化按钮控件
              //
              hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_OK);
              BUTTON_SetText(hItem, "OK");
              BUTTON_SetFont(hItem, GUI_FONT_16_ASCII);

              //
              // 初始化按钮控件
              //
              hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_CANCEL);
              BUTTON_SetText(hItem, "Cancel");
              BUTTON_SetFont(hItem, GUI_FONT_16_ASCII);
              break;

          case WM_KEY:
            switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
            {
                   case GUI_KEY_ESCAPE:
                    GUI_EndDialog(hDlg, 1);
                    break;

                case GUI_KEY_ENTER:
                    GUI_EndDialog(hDlg, 0);
                    break;
            }
            break;

         case WM_NOTIFY_PARENT:
              Id    = WM_GetId(pMsg->hWinSrc);
              NCode = pMsg->Data.v;
              switch(Id)
              {
                   /* 点击OK按钮，关闭对话框 */
                   case GUI_ID_OK:
                       switch(NCode)
                       {
                            case WM_NOTIFICATION_CLICKED:
                                 break;

                            case WM_NOTIFICATION_RELEASED:
                                 GUI_EndDialog(hDlg, 0);
                                 break;
                       }
                       break;

                   /* 点击CANCEL按钮，关闭对话框 */
                   case GUI_ID_CANCEL:
                       switch(NCode)
                       {
                            case WM_NOTIFICATION_CLICKED:
                                 break;

                            case WM_NOTIFICATION_RELEASED:
                                 GUI_EndDialog(hDlg, 1);
                                 break;
                       }
                       break;
              }
              break;

         default:
              WM_DefaultProc(pMsg);
     }
}

lee_st · 2017-4-1 09:22:13

创建此对话框后的首次显示效果如下：

默认情况下，对话框创建后，系统会聚焦到对话框资源列表里面第一个支持聚焦的控件上（这点要特别注意）。具体到给每个控件发送键盘消息，大家可以使用本章节配套的例子在开发板上面实际操作下，另外，通过我们前面设置的按键K3发送GUI_KEY_TAB消息，按下K3按键后会切换聚焦到对话框资源列表中下一个支持聚焦的控件。

lee_st · 2017-4-1 09:22:32

62.5 实验例程说明（RTOS）

实验目的：
      1.    本实验主要学习实体按键操作控件的使用。
      2.    emWin功能的实现在MainTask.c文件里面。
实验内容：
      1.    K1按键按下，串口打印任务执行情况（波特率115200，数据位8，奇偶校验位无，停止位1）。
      2.    K2按键按下，实现截图功能，将图片以BMP格式保存到SD卡中。
      3.    针对本例子创建的界面，其余按键操作实现的功能如下，第4条到第9条。
      4.    K3按钮按下，实现控件聚焦的切换。
      5.    摇杆向上按，实现删除编辑框控件光标后的字符。
      6.    摇杆向下按，实现删除编辑框控件光标前的字符。
      7.    摇杆向左按，实现光标左移。
      8.    摇杆向右按，实现光标右移。
      9.    摇杆按下OK键，发送按键消息GUI_KEY_ENTER，如果当前聚焦到按钮控件上，发送此消息会关闭对话框。如果未聚焦到按钮控件上，发送消息GUI_KEY_ENTER会被对话框回调函数中WM_KEY消息所接受，同样也是实现关闭对话框功能。
      10.  各个任务实现的功能如下：
            App Task Start 任务：实现按键和触摸扫描。
            App Task MspPro任务：实现截图功能，将图片以BMP格式保存到SD卡中。
            App Task UserIF  任务：按键消息处理。
            App Task COM 任务：暂未使用。
         App Task GUI 任务：GUI任务。