17. 框架窗口控件

框架窗口控件和Window控件都是emWin整个对话框功能的核心承载体，几乎所有使用对话框形式创建的界面，都是以这两种控件为基础的。 其中window控件实际上跟桌面窗口是同一种东西，只不过又独立做了一种控件而已。桌面窗口的基本操作在窗口管理器章节有说明，本章只对框架窗口控件进行讲解。

FRAMEWIN框架窗口控件为用户的应用程序提供了类似PC端应用程序的窗口外观。它由周围的框架、标题栏和用户区域组成。 图 框架窗口控件结构 展示了框架窗口控件的详细结构。

框架窗口控件实际上是由主窗口和子窗口两个部分组成。其中子窗口被称为客户窗口（Client window）。表格 框架窗口控件参数 是框架窗口控件的一些参数。

从V5.28版本开始，emWin默认使能了所有控件的皮肤效果。带皮肤的框架窗口控件如图 带皮肤的框架窗口控件 所示。

在使用框架窗口控件的时候请一定注意：框架窗口控件是有两个回调函数的，主窗口有一个，客户窗口也有一个。 主窗口回调负责绘制边框、标题栏等外观以及处理边框上按钮的消息，客户窗口回调负责绘制控件的客户区以及处理子控件的消息， 因为在框架窗口控件中创建的子控件，会以客户窗口作为他们的父窗口。大部分基础应用只需要用到客户窗口回调， 通常很少去使用主窗口的回调函数，除非是为了实现一些高级效果。emWin有一个默认的主窗口回调， 所以在直接创建框架窗口控件的时候一般情况下只需要编写客户窗口回调。如果是用对话框形式间接创建的框架窗口控件，则对话框回调函数就是控件的客户窗口回调。

17.1. 创建框架窗口
17.1.1. 框架窗口API
框架窗口控件的 API 函数比较多，这里我们只列出一些比较常用的，见表格 框架窗口API 。完整的API函数请查阅emWin官方手册。

17.1.2. 框架窗口创建函数
17.1.2.1. FRAMEWIN_CreateEx()
以直接方式在指定位置创建具有指定大小的框架窗口控件。

代码清单:框架窗口-1 直接方式创建桌面窗口函数FRAMEWIN_CreateEx

FRAMEWIN_Handle FRAMEWIN_CreateEx (int x0, int y0, int xSize, int ySize,
                                    WM_HWIN hParent, int WinFlags,
                                    int ExFlags, int Id,
                                    const char * pTitle, WM_CALLBACK * cb);

1. x0： 框架窗口控件在父坐标中的最左侧像素；

2. y0： 框架窗口控件在父坐标中的最顶侧像素；

3. xSize： 框架窗口的水平尺寸，以像素为单位；

4. ySize： 框架窗口的垂直尺寸，以像素为单位；

5. hParent： 父窗口句柄。如果为0，则将桌面窗口作为其父窗口；

6. WinFlags： 窗口创建标志。由于控件本质上是窗口，所以他们在创建时可以使用所有的窗口创建标志。这些标志中最常用的有WM_CF_SHOW、WM_CF_FGND、WM_CF_MEMDEV等。 全部创建标志请参考emWin手册的窗口管理器章节；

7. ExFlags： 额外标志。用于设置框架窗口是否可移动，为0时不可移动，为FRAMEWIN_CF_MOVEABLE时可移动。也可使用FRAMEWIN_SetMoveable函数进行设置；

8. Id： 控件ID号；

9. pTitle： 需要显示在标题栏的文本；

10. cb： 指向用户回调函数的指针。用户回调函数实际上就是客户窗口的回调函数，它有两个作用，一是绘制客户窗口，二是响应并处理子控件的消息。 不过用户回调函数并不会接收所有发送到客户窗口的消息，一些系统消息会由默认的框架窗口回调函数接收并处理，而WM_PAINT消息、 用户自定义消息和所有的通知代码都会交给用户回调函数处理。

返回值：创建成功后返回已创建的控件句柄，创建失败则返回0。

17.1.2.2. FRAMEWIN_CreateIndirect()
使用对话框方式间接创建一个框架窗口。

代码清单:框架窗口-2 对话框方式创建窗口FRAMEWIN_CreateIndirect

FRAMEWIN_Handle FRAMEWIN_CreateIndirect(const GUI_WIDGET_CREATE_INFO *pCreateInfo,
                                        WM_HWIN hWinParent,
                                        int x0, int y0,
                                        WM_CALLBACK * cb);

1. pCreateInfo： 指向GUI_WIDGET_CREATE_INFO结构的指针；

2. hParent： 父窗口的句柄；

3. x0： 控件在父坐标中的最左边像素；

4. y0