【emWin实战教程V2.0】第50章 EDIT-编辑框控件

参与人数 1

转最新版本教程
本章节为大家讲解STemWin支持的编辑框控件，编辑框是人机交互方面非常重要的一个控件，望初学者一定要认真掌握。本章节配套的例子较简单，建议学习完毕本章节的内容后接着学习下一章节：实用的官方小键盘实例讲解，非常具有代表性，很好的使用了编辑框控件和按钮控件。
      50.1 初学者重要提示
      50.2 编辑框控件基础知识
      50.3 使用GUIBuilder创建编辑框控件并用模拟器显示出来
      50.4 官方WIDGET_Edit.c实例
      50.5 实验例程说明（RTOS）
      50.6 实验例程说明（裸机）
      50.7 总结

lee_st · 2017-3-5 08:42:44

50.1  初学者重要提示

1、初学者爱问的问题简单汇总：

      （1）问题1：编辑框中的光标可以去掉吗？
      答：可以的，通过函数WM_DisableWindow禁止编辑框即可，此时就看不到光标了，但是仍然可以操作编辑框添加或删除字符。或者通过函数EDIT_SetFocussable禁止聚焦也是可以的。
      （2）问题2：编辑框中的光标如何闪烁起来？
      答：通过函数EDIT_EnableBlink可以设置编辑框的闪烁周期。
2、编辑框创建后，默认的是文本模式，另外还有二进制，十进制，十六进制和浮点数模式，实际应用中学会了文本模式即可，因为我们可以使用C标准库中的函数sprintf将数值转换成文本，然后使用文本显示函数，这样我们仅需掌握文本显示函数即可。
3、编辑框控件不支持皮肤色。

lee_st · 2017-3-5 08:43:02

4、下拉列表控件的所有API函数在emWin手册中都有讲解，下图是中文版手册里面API函数位置：

lee_st · 2017-3-5 08:43:23

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

lee_st · 2017-3-5 08:43:45

50.2 编辑框控件基础知识

编辑框是用来输入文本的主要控件：

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

lee_st · 2017-3-5 08:45:44

早期版本，编辑框控件默认的显示效果如下：

现在版本，编辑框默认的显示效果如下（扁平化效果）：

lee_st · 2017-3-5 08:45:55

50.2.1 编辑框控件支持的通知代码

编辑框支持的通知代码主要是用来处理编辑框消息用的，编辑框控件主要支持四种消息事件，点击消息，释放消息，移开消息(点击了编辑框，且从编辑框所在的区域移开了但没有释放)和编辑框数值（内容）被更新消息。比如用户通过触摸屏点击了编辑框，窗口管理器会给编辑框父窗口回调函数发送消息WM_NOTIFY_PARENT来通知父窗口，进而再区分是四种消息中的哪一种，用户就可以在相应的消息代码里面加入要实现的功能。

以下事件是作为WM_NOTIFY_PARENT消息的一部分由编辑框控件发送给其父窗口，用来区分不同的编辑框消息。

lee_st · 2017-3-5 08:46:24

50.2.2 编辑框控件支持的键盘反应（输入聚焦）

编辑框控件支持输入聚焦，也支持外置键盘或者类似外置键盘的输入设备给编辑框控件发消息。当前仅支持以下七种按键消息：
（输入聚焦是一个重要的知识点，使用外置键盘或者类似外置键盘的输入设备要用到）

特别注意一点，对于编辑框来说，要先聚焦到这个控件上了，给编辑框发送按键消息才会有反应。

lee_st · 2017-3-5 08:46:35

50.2.3 编辑框控件API函数

编辑框控件的API函数比较多，但调用都不难，大家只需看官方手册中的API函数说明就够用了，后面用到的函数中有需要特别注意的再跟大家进行讲解。
本章节教程配套例子是将编辑框控件配合对话框一起使用的，实际项目中也推荐大家这么做，可以很方便的进行界面管理。在对话框上面使用编辑框控件是通过函数EDIT_CreateIndirect()来实现的。根据第41章41.7.1小节讲解的_CreateIndirect()函数，GUI_WIDGET_CREATE_INFO结构体类型定义如下：

lee_st · 2017-3-5 08:46:44

typedef struct {
GUI_WIDGET_CREATE_FUNC * pfCreateIndirect;    // 间接创建函数
const char * pName;                           // 控件名(不是所有控件都需要)
I16 Id;                                       // 控件ID
I16 x0, y0, xSize, ySize;                     // 控件的坐标位置和大小
I16 Flags;                                    // 控件用到的标志，没有就写0
I32 Para;                                     // 控件用到的参数，没有就写0
U32 NumExtraBytes;                            // 函数 _SetUserData & _GetUserData用到的
// 额外字节。
} GUI_WIDGET_CREATE_INFO;

lee_st · 2017-3-5 08:46:52

上面结构体成员里面的标记Flags和参数Para是可选的，函数EDIT_CreateIndirect()都用到了，标记Flags与函数EDIT_SetTextAlign()的形参Align是等效的，参数Para与函数EDIT_CreateEx()的形参MaxLen是等效，具体这两个形参的含义看emWin官方手册中的说明即可。
这里举一个对话框资源列表里面创建编辑框控件的例子，帮助大家更好的理解：

lee_st · 2017-3-5 08:47:00

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

/*
*********************************************************************************************************
*                           GUI_WIDGET_CREATE_INFO类型数组
*********************************************************************************************************
*/
static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
{
  { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 800, 480, 0, 0x64, 0 },
  { EDIT_CreateIndirect, "Edit", ID_EDIT_0, 38, 49, 81, 27, 0, 0x64, 0 },
  { EDIT_CreateIndirect, "Edit", ID_EDIT_1, 41, 105, 79, 27, 0, 0x64, 0 },
};

lee_st · 2017-3-5 08:47:10

上面的对话框资源列表里面依次创建了框架窗口控件，两个编辑框控件。编辑框控件的参数和GUI_WIDGET_CREATE_INFO结构成员的对应关系如下：

pfCreateIndirect = EDIT_CreateIndirect;
pName = "Edit";
Id = ID_EDIT_0;
x0 = 38;
y0 = 49;
xSize = 81;
ySzie = 27;
Flags = 0;
Para = 0x64;
NumExtraBytes = 0;

lee_st · 2017-3-5 08:47:20

对于这个对应关系要注意以下三点：
1、这里的x0和y0坐标位置是相对于对话框资源列表中框架窗口的客户端窗口的位置坐标。
2、参数Para取0x64是表示编辑框控件最大可以存入0x64，即100个字符。
3、Id号，这里的Id号是用户自定义的，emWin在GUI.h文件中也定义了部分编辑框控件的Id号，用户是可以直接使用的：