【emWin实战教程V2.0】第55章 MULTIPAGE-多页控件

ti

转最新版本教程
本章节为大家讲解STemWin支持的多页控件，通过使用多页控件，可以很方便的在窗口上面扩展出多个页面，这样就可以集成更多的功能到这个窗口上面，使用此控件的最大好处也就在这里了。
55.1 初学者重要提示
55.2 多页控件基础知识
55.3 使用GUIBuilder创建多页控件并用模拟器显示出来
55.4 官方WIDGET_Multipage.c实例
55.5 实验例程说明（RTOS）
55.6 实验例程说明（裸机）
55.7 总结

lee_st · 2017-3-13 17:41:07

55.1  初学者重要提示

u  初学者爱问的问题简单汇总：
      问题1：多页控件选项卡的位置是否可以任意设置
      答：可以的，函数MULTIPAGE_SetAlign配合MULTIPAGE_SetRotation就可以实现。
2、本教程配套的emWin版本是5.32，从emWin5.28版本开始，皮肤色是自动使能的，所以部分多页控件的API函数是失效的，主要是多页控件颜色设置函数，此问题也经常被初学者问。
3、实际项目中，建议用户将对话框附加到多页控件的页面窗口上，这样页面窗口的管理将非常方便，而且这个对话框也可以使用GUIBuilder进行创建，本章节配套的例子都是采用的这种方法。

lee_st · 2017-3-13 17:41:23

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

lee_st · 2017-3-13 17:41:39

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

lee_st · 2017-3-13 17:41:53

55.2 多页控件基础知识

先通过下面的图表看看多页控件是什么样子的：

lee_st · 2017-3-13 17:42:05

相信大家在电脑端经常见到这种类似的控件，通过使用多页控件，可以很方便的在窗口上面扩展出多个页面，这样就可以集成更多的功能到这个窗口上面，使用此控件的最大好处也就在这里了。另外，如果窗口中无法显示所有选项卡，就如上表第二个图中创建了6个页面，选项卡无法全部显示出来，右下角就会显示出一个滚动条。

      下面接着说说多页控件的组成结构，一个多页控件是由1个MultiPage窗口，1个客户端窗口和n个用户所创建的页面窗口组成，n的大小由用户决定，用户创建了几个，n就是几：
                  （1）1个MULTIPAGE窗口
                  （2）1个客户端窗口
                  （3）N个页面窗口

lee_st · 2017-3-13 17:42:17

页面窗口是被添加到客户端窗口上的，具体的层次关系如下：

用户的应用程序是创建到各个页面窗口上的。

lee_st · 2017-3-13 17:42:29

不开启皮肤色时，多页控件的显示效果就是上面图表中所示的，开启皮肤后显示效果如下：

lee_st · 2017-3-13 17:42:42

55.2.1 多页控件支持的通知代码

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

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

注意，实际测试发现消息WM_NOTIFICATION_VALUE_CHANGED很奇葩，点击选项卡或者切换选项卡，这个消息都会被触发，感觉这个消息没有什么用，有些多余了。

lee_st · 2017-3-13 17:42:54

55.2.2 多页控件支持的键盘反应（输入聚焦）

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

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

lee_st · 2017-3-13 17:43:06

55.2.3 多页控件API函数

      多行文本控件的API函数比较多，但调用都不难。我们这里把以下两个比较相似的函数特别解释下：
MULTIPAGE_AddPage
      此函数用于将窗口添加到多页控件的页面窗口。
MULTIPAGE_AddEmptyPage
      此函数也是用于将窗口添加到多页控件的页面窗口，跟函数MULTIPAGE_AddPage的区别是此函数可以在无窗口需要添加时，可以将窗口句柄参数设置为0。

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

本章节教程配套例子是将多页控件配合对话框一起使用的，实际项目中也推荐大家这么做，可以很方便的进行界面管理。在对话框上面使用多页控件是通过函数MULTIPAGE_CreateIndirect()来实现的。根据第41章41.7.1小节讲解的_CreateIndirect()函数，GUI_WIDGET_CREATE_INFO结构体类型定义如下：

lee_st · 2017-3-13 17:43:24

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-13 17:43:33

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

lee_st · 2017-3-13 17:43:41

/*
*********************************************************************************************************
*                           宏定义
*********************************************************************************************************
*/
#define ID_FRAMEWIN_0  (GUI_ID_USER + 0x00)
#define ID_MULTIPAGE_0 (GUI_ID_USER + 0x01)

/*
*********************************************************************************************************
*                           GUI_WIDGET_CREATE_INFO类型数组
*********************************************************************************************************
*/
static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
{
{ FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 800, 480, 0, 0x0, 0 },
  { MULTIPAGE_CreateIndirect, "Multipage", ID_MULTIPAGE_0, 23, 25, 400, 240, 0, 0x0, 0 },
};

lee_st · 2017-3-13 17:43:52

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

pfCreateIndirect = MULTIPAGE_CreateIndirect;
pName = "Multipage";
Id = ID_MULTIPAGE_0;
x0 = 23;
y0 = 25;
xSize = 400;
ySzie = 240;
Flags = 0;
Para = 0x0;
NumExtraBytes = 0;

lee_st · 2017-3-13 17:44:08

对于这个对应关系要注意以下两点：
1、这里的x0和y0坐标位置是相对于对话框资源列表中框架窗口的客户端窗口的位置坐标。
2、Id号，这里的Id号是用户自定义的，emWin在GUI.h文件中也定义了部分多行文本控件的Id号，用户是可以直接使用的：
#define GUI_ID_MULTIPAGE0 0x230
#define GUI_ID_MULTIPAGE1 0x231
#define GUI_ID_MULTIPAGE2 0x232
#define GUI_ID_MULTIPAGE3 0x233