【emWin实战教程V2.0】第44章 FrameWin-框架窗口控件

转最新版本教程

转最新版本教程
本章节为大家讲解STemWin支持的框架窗口控件，外加上一章节为大家讲解的窗口控件，对话框所必须的两个主体控件就为大家都进行了讲解，这样可以方便我们后续讲解其它控件。
      44.1 初学者重要提示
      44.2 框架窗口控件基础知识
      44.3 使用GUIBuilder创建框架窗口控件并用模拟器显示出来
      44.4 官方WIDGET_FrameWin.c实例讲解
      44.5 实验例程说明（RTOS）
      44.6 实验例程说明（裸机）
      44.7 总结

lee_st · 2017-2-25 19:57:42

44.1  初学者重要提示

u  学习框架窗口要将框架窗口和框架窗口的客户端窗口区分开，而且他们对应的回调函数也是不一样的。
u  框架窗口控件的所有API函数在emWin手册中都有讲解，下图是中文版手册里面API函数位置：

lee_st · 2017-2-25 19:57:52

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

lee_st · 2017-2-25 19:58:04

44.2 框架窗口控件基础知识

框架窗口控件为用户的应用程序提供了一个类似PC应用程序的窗口外观。这些窗口由周围框架、标题栏和用户区组成。标题栏的颜色改变由显示窗口是否被激活决定，如下图所示：

lee_st · 2017-2-25 19:58:15

另外，还可以将预定义的按钮附加到标题栏，也可将自定义的按钮附加到标题栏：

lee_st · 2017-2-25 19:58:28

如果设置皮肤色后，框架窗口的显示效果如下：

lee_st · 2017-2-25 19:58:40

44.2.1 框架窗口控件的结构

下图显示了框架窗口控件的详细结构和外观：

lee_st · 2017-2-25 19:58:51

框架窗口控件实际上由2种窗口组成；主窗口和子窗口，子窗口称为客户端窗口。处理回调函数时意识到此点非常重要：主窗口和客户端窗口都有自己的回调函数，在框架窗口上面创建子窗口或者控件时，这些子窗口或者控件通常作为客户端窗口的子窗口或者子控件而创建，也就是说它们的父窗口是客户端窗口。

更多对话框上面创建框架窗口的注意事项在第42章42.5小节详细进行了讲解，这里不再赘述。

lee_st · 2017-2-25 19:59:00

44.2.2 键盘反应（输入聚焦）

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

lee_st · 2017-2-25 19:59:17

44.2.3 框架窗口控件API函数

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

上面结构体成员里面的标记Flags和参数Para是可选的，函数FRAMEWIN_CreateIndirect()没有用到参数Para，但用到了标记Flags，与函数FRAMEWIN_CreateEx的形参ExFlags是等效的，具体形参ExFlags支持哪些标记参看emWin官方手册中的说明即可。
      这里举一个对话框资源列表里面创建框架窗口控件的例子，帮助大家更好的理解：
/*
*********************************************************************************************************
*                           GUI_WIDGET_CREATE_INFO类型数组
*********************************************************************************************************
*/
static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
{
     { FRAMEWIN_CreateIndirect,  "Framewin",   ID_FRAMEWIN_0,   0, 0, 800, 480, 0, 0, 0 },
     { BUTTON_CreateIndirect,    "Button",     ID_BUTTON_0,   130, 28, 147, 35, 0, 0x0, 0 },
     { SCROLLBAR_CreateIndirect, "Scrollbar",  ID_SCROLLBAR_0,129, 74, 147, 28, 0, 0x0, 0 },
     { SLIDER_CreateIndirect,    "Slider",     ID_SLIDER_0,   133, 118, 137, 25, 0, 0x0, 0 },
};

lee_st · 2017-2-25 19:59:40

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

pfCreateIndirect = FRAMEWIN_CreateIndirect;
pName = "Framewin";
Id = ID_FRAMEWIN_0;
x0 = 0;
y0 = 0
xSize = 800;
ySzie = 480;
Flags = 0;
Para = 0x0;
NumExtraBytes = 0;

lee_st · 2017-2-25 19:59:51

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

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

lee_st · 2017-2-25 20:00:12

44.3.1 第一步：建立一个对话框，主体是框架窗口

1、找到GUIBuilder后，打开这个软件，并按照如下方式建立一个对话框。

lee_st · 2017-2-25 20:00:23

2、修改框架窗口大小为800*480。

lee_st · 2017-2-25 20:00:37

3、下面设置对话框标题的字体，对齐方式，和显示的文本。首先，在建立的对话框上面右击鼠标，选择Set font。

lee_st · 2017-2-25 20:00:58

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

lee_st · 2017-2-25 20:01:10

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

lee_st · 2017-2-25 20:01:23

配置完成后，上面的字体Framewin会居中显示，然后还是鼠标右击，选择Set title text，并更改Framewin为armfly，修改的地方在左下角：

设置好以后，对话框就算建立完毕。

lee_st · 2017-2-25 20:01:53

44.3.2 第二步：在对话框上面建立按钮控件

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

搜索历史

【emWin实战教程V2.0】第44章 FrameWin-框架窗口控件

相关推荐

69 条评论

评论

精选推荐

热门帖

站长推荐 /7