【emWin实战教程V2.0】第43章 WINDOW-窗口控件

转最新版本教程

转最新版本教程
本章节为大家讲解STemWin支持的窗口控件，窗口控件和前面讲的窗口本质上面是一样的，只不过这里是以控件的形式存在。
43.1 初学者重要提示
43.2 窗口控件基础知识
43.3 使用GUIBuilder创建窗口控件并用模拟器显示出来
43.4 官方WIDGET_Window.c实例讲解
43.5 实验例程说明（RTOS）
43.6 实验例程说明（裸机）
43.7 总结

lee_st · 2017-2-24 18:43:59

43.1  初学者重要提示

u  窗口控件相对比较容易，本章节也没什么要特别注意的，重点是学习对话框的资源列表里面创建窗口控件的方法。
u  窗口控件的所有API函数在emWin手册中都有讲解，下图是中文版手册里面API函数位置：

lee_st · 2017-2-24 18:44:11

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

lee_st · 2017-2-24 18:44:22

43.2 窗口控件基础知识

窗口控件与前面讲解窗口管理器时介绍的窗口基本是没有区别的，这里的窗口控件主要是配合对话框一起使用，当然，单独创建也是没有问题的。窗口控件是使用对话框必须创建的控件之一，另一个是框架窗口控件，这两个控件必须二选一作为对话框资源列表里面的第一个控件。
窗口控件是对话框的主体，其余的按钮控件，编辑框控件，滚动条等控件都是建立在窗口控件上的。

lee_st · 2017-2-24 18:44:30

43.2.1 键盘反应（输入聚焦）

窗口控件不支持输入聚焦，这点要特别注意。不支持输入聚焦的话，外置键盘或者类似外置键盘的输入设备给窗口控件发消息是没有任何反应的。
（输入聚焦是一个重要的知识点，使用外置键盘或者类似外置键盘的输入设备要用到）

lee_st · 2017-2-24 18:44:39

43.2.2 窗口控件API函数

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

lee_st · 2017-2-24 18:44:47

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-2-24 18:45:03

上面结构体成员里面的标记Flags和参数Para是可选的，函数WINDOW_CreateIndirect()没有用到参数Para，但用到了标记Flags，与函数WINDOW_CreateEx的形参WinFlags是等效的，具体形参WinFlags支持哪些标记参看emWin官方手册中的说明即可。
这里举一个对话框资源列表里面创建窗口控件的例子，帮助大家更好的理解：

lee_st · 2017-2-24 18:45:11

/*
*********************************************************************************************************
*                           GUI_WIDGET_CREATE_INFO类型数组
*********************************************************************************************************
*/
static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
  { WINDOW_CreateIndirect, "Window", ID_WINDOW_0, 0, 0, 800, 480, 0, 0x0, 0},
  { TEXT_CreateIndirect,   "Text",   ID_TEXT_0,   20, 35, 86, 31, 0, 0x64, 0 },
  { BUTTON_CreateIndirect, "Button", ID_BUTTON_0, 16, 87, 128, 37, 0, 0x0, 0 },
};

lee_st · 2017-2-24 18:45:20

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

pfCreateIndirect = WINDOW_CreateIndirect;
pName = "Window";
Id = ID_WINDOW_0;
x0 = 0;
y0 = 0
xSize = 800;
ySzie = 480;
Flags = 0;
Para = 0x0;
NumExtraBytes = 0;

lee_st · 2017-2-24 18:45:30

43.3使用GUIBuilder创建窗口控件并用模拟器显示出来

首先需要大家按照第2章2.3.4小节的说明下载STemWin的软件包，其中GUIBuilder5.32位于路径：STM32Cube_FW_F4_V1.13.0MiddlewaresSTSTemWinSoftware里面

lee_st · 2017-2-24 18:45:44

43.3.1 第一步：添加一个对话框，主体是窗口控件

1、找到GUIBuilder后，打开这个软件，并按照如下方式添加一个窗口控件。

lee_st · 2017-2-24 18:45:56

2、修改窗口控件的大小为800*480。

lee_st · 2017-2-24 18:46:09

43.3.2 第二步：在对话框上面建立文本控件

仅显示一个窗口控件的话，内容太少了，我们在上面添加一个文本控件。文本控件的的建立方法和上面窗口控件的建立方法是一样的。文本控件的字体大小和显示内容，大家可以任意设置。
1、添加文本控件。

lee_st · 2017-2-24 18:46:22

2、对于添加的文本控件，用户是可以用鼠标任意拖动的，下面设置文本控件的字体，对齐方式，和显示的文本。首先，鼠标左击选中刚刚添加的文件，然后右击鼠标，选择Set font。

lee_st · 2017-2-24 18:46:35

弹出如下界面，并选择字体GUI_FONT_32B_ASCII，点击OK。

lee_st · 2017-2-24 18:46:48

设置字体后文本显示不全，用户可以通过鼠标调整其大小，调整方法如下：先左击选中相应控件，会出现绿色的边框，在边框的地方拖动鼠标即可修改大小

lee_st · 2017-2-24 18:46:59

设置好字体以后再设置对齐方式，还是右击鼠标，选择Set text alignment，并选择居中

lee_st · 2017-2-24 18:47:16

最后还是右击鼠标，选择Set text，并更改Content为armfly，修改的地方在左下角：

设置好以后，文本控件就算建立完毕。

lee_st · 2017-2-24 18:47:27

43.3.3 第三步：在对话框上面建立按钮控件

为了使窗口控件内容不至于太少，我们在上面再添加一个按钮控件。文本控件的的建立方法和上面窗口控件的建立方法是一样的。按钮上面的字体大小和显示内容，大家可以任意设置。按钮上的文本不支持对齐方式设置，默认是居中显示，这里是显示字符armfly，字体GUI_FONT_24B_ASCII，建立后的效果如下所示：

搜索历史

【emWin实战教程V2.0】第43章 WINDOW-窗口控件

相关推荐

54 条评论

评论

精选推荐

热门帖

浏览过的版块

站长推荐 /9