第3版emWin教程第43章 emWin6.x窗口管理器实例（含自定义消息）
Posted Simon223
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了第3版emWin教程第43章 emWin6.x窗口管理器实例（含自定义消息）相关的知识，希望对你有一定的参考价值。
教程不断更新中：第3版emWin教程和ThreadX GUIX教程开工，双管齐下，GUIX更新至第28章，emWin更新至第48章（2021-09-13） - uCOS & uCGUI & emWin & embOS & TouchGFX & ThreadX - 硬汉嵌入式论坛 - Powered by Discuz!
http://www.armbbs.cn/forum.php?mod=viewthread&tid=98429
第43章 emWin6.x窗口管理器实例（含自定义消息）
为了帮助大家更好的理解窗口管理器的回调函数和消息机制，本章教程专门做了两个相关的例子，帮助大家更好的理解。
目录
43.1 初学者重要提示
- 通过实例来学习emWin是最佳的学习捷径。
- 本章节举的两个例子都用到了对话框，对于初学者来说，仅需知道这是对话框即可，重点是看对话框回调函数的实现，后面章节会专门讲解对话框。
- 窗口管理器这块的API函数应该是emWin手册所有章节中函数最多的，以后需要用到什么功能了，查询就行，或者看官方的实例，哪个函数不理解了也可以查手册。下图是中文版手册里面API函数位置：
下图是英文版手册里面API函数的位置：
43.2 用户自定义消息类型实例
第42章为大家讲解的都是emWin支持的消息类型，这里我们通过一个实例来实现自定义消息，这个功能在大家以后的实际项目中都有机会用到，比较有实战价值。
下面我们直接通过如下的代码来讲解实现方法和用到的函数（可以直接将代码复制到模拟器或者开发板上面运行）。
#include "DIALOG.h"
/*
*********************************************************************************************************
* 变量
*********************************************************************************************************
*/
static GUI_COLOR _acColor[3] = {GUI_BLUE,GUI_RED,GUI_YELLOW}; //--------------（1）
static unsigned char ucBackColor;
/*
*********************************************************************************************************
* 宏定义
*********************************************************************************************************
*/
#define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
#define ID_BUTTON_0 (GUI_ID_USER + 0x01)
#define ID_SCROLLBAR_0 (GUI_ID_USER + 0x02)
#define ID_SLIDER_0 (GUI_ID_USER + 0x03)
#define WM_UPDATE (WM_USER + 0x00) /* 自定义消息 */ // --------------（2）
/*
*********************************************************************************************************
* GUI_WIDGET_CREATE_INFO类型数组
*********************************************************************************************************
*/
static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
{ FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 480, 272, 0, 0x64, 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 },
};
/*
*********************************************************************************************************
* 函 数 名: _cbDialog
* 功能说明: 对话框回调函数
* 形 参: pMsg 回调参数
* 返 回 值: 无
*********************************************************************************************************
*/
static void _cbDialog(WM_MESSAGE * pMsg)
{
WM_HWIN hItem;
int NCode;
int Id;
switch (pMsg->MsgId)
{
case WM_INIT_DIALOG:
//
// 初始化 'Framewin'
//
hItem = pMsg->hWin;
FRAMEWIN_SetFont(hItem, GUI_FONT_32B_ASCII);
FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
FRAMEWIN_SetText(hItem, "armfly");
//
// 初始化 'Button'
//
hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_0);
BUTTON_SetFont(hItem, GUI_FONT_24B_ASCII);
BUTTON_SetText(hItem, "armfly");
/* 默认颜色取*/
ucBackColor = 0;
break;
case WM_PAINT:
GUI_SetBkColor(_acColor[ucBackColor]);
GUI_Clear();
break;
case WM_UPDATE: //--------------（3）
ucBackColor++;
if (ucBackColor == 3)
{
ucBackColor = 0;
}
WM_InvalidateWindow(pMsg->hWin);
break;
case WM_KEY:
switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
{
case GUI_KEY_ESCAPE:
GUI_EndDialog(pMsg->hWin, 1);
break;
case GUI_KEY_ENTER:
GUI_EndDialog(pMsg->hWin, 0);
break;
}
break;
case WM_NOTIFY_PARENT:
Id = WM_GetId(pMsg->hWinSrc);
NCode = pMsg->Data.v;
switch(Id)
{
case ID_BUTTON_0:
switch(NCode)
{
case WM_NOTIFICATION_CLICKED:
break;
case WM_NOTIFICATION_RELEASED:
break;
}
break;
case ID_SCROLLBAR_0:
switch(NCode)
{
case WM_NOTIFICATION_CLICKED:
break;
case WM_NOTIFICATION_RELEASED:
break;
case WM_NOTIFICATION_VALUE_CHANGED:
break;
}
break;
case ID_SLIDER_0:
switch(NCode)
{
case WM_NOTIFICATION_CLICKED:
break;
case WM_NOTIFICATION_RELEASED:
break;
case WM_NOTIFICATION_VALUE_CHANGED:
break;
}
break;
}
break;
default:
WM_DefaultProc(pMsg);
break;
}
}
/*
*********************************************************************************************************
* 函 数 名: CreateFramewin
* 功能说明: 创建对话框
* 形 参: 无
* 返 回 值: 返回对话框句柄
*********************************************************************************************************
*/
WM_HWIN CreateFramewin(void)
{
WM_HWIN hWin;
hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), _cbDialog, WM_HBKWIN, 0, 0);
return hWin;
}
/*
*********************************************************************************************************
* 函 数 名: MainTask
* 功能说明: GUI主函数
* 形 参: 无
* 返 回 值: 无
*********************************************************************************************************
*/
void MainTask(void)
{
WM_HWIN hDlg;
/* 初始emWin */
GUI_Init();
/* 创建对话框 */
hDlg = CreateFramewin();
while(1)
{
/* 给对话框hDlg发送自定义消息WM_UPDATE */
WM_SendMessageNoPara(WM_GetClientWindow(hDlg), WM_UPDATE); // --------------（4）
GUI_Delay(500);
}
}
实现自定义消息的关键是函数WM_SendMessageNoPara的使用，学会了这个函数基本就学会了自定义消息的实现：
- 定义一个数组，里面有三种颜色，再定义一个变量，用于三种颜色的切换。
- 定义一个用户消息WM_UPDATE，一定要以WM_USER作为起始值，防止跟系统其他的数值冲突。如果还要实现其它自定义消息，在这个数值的基础上面定义即可。
- 在回调函数中加入自定义消息WM_UPDATE，在这个消息里面切换对话框的背景色变量，然后调用函数WM_InvalidateWindow将对话框进行无效化，从而会触发窗口管理器去执行WM_PAINT消息，这样就实现了对话框背景色的变化。
- 通过函数WM_SendMessageNoPara()每隔500ms给对话框发送WM_UPDATE消息。函数原型如下：
void WM_SendMessageNoPara(WM_HWIN hWin, int MsgId)
此函数用于将不带参数的消息发送到指定窗口，使用也比较简单，第一个参数hWin是要接受消息的窗口句柄，第二个参数MsgId是消息类型。其中第一个参数要特别注意，如果是给对话框发消息，且对话框的主体是框架窗口FrameWin或者直接给框架窗口FrameWin发消息，第一个参数必须要使用函数WM_GetClientWindow获得框架窗口的客户区，这一点非常重要，经常有初学者在这个地方犯错误。如果对话框的主体是Windows或者直接给Windows窗口发消息，无需使用函数WM_GetClientWindow，直接填句柄就可以了。
此时初学者还会有个疑问，能否使用函数WM_SendMessageNoPara可以发送类似WM_PAINT的系统消息？答案是可以的，不过跟发自定义消息稍有区别:
/* 设置要用于绘制操作的活动窗口 */
WM_SelectWindow(WM_GetClientWindow(hDlg));
/* 给对话框hDlg发送系统消息WM_PAINT */
WM_SendMessageNoPara(WM_GetClientWindow(hDlg), WM_PAINT);
/* 切换回默认的桌面窗口 */
WM_SelectWindow(WM_HBKWIN);
另外还有一个带参数的消息发送函数WM_SendMessage，在第38章会有一个例子调用这个函数。最后，本程序的显示效果如下（分辨率480*272）,每500ms更新一次对话框的客户区背景色：
43.3 桌面窗口回调函数实例
这个例子为大家讲解如何给桌面窗口配置回调函数。实现源码如下（可以直接将代码复制到模拟器或者开发板上面运行）。
#include "DIALOG.h"
/*
*********************************************************************************************************
* 宏定义
*********************************************************************************************************
*/
#define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
#define ID_BUTTON_0 (GUI_ID_USER + 0x01)
#define ID_SCROLLBAR_0 (GUI_ID_USER + 0x02)
#define ID_SLIDER_0 (GUI_ID_USER + 0x03)
/*
*********************************************************************************************************
* GUI_WIDGET_CREATE_INFO类型数组
*********************************************************************************************************
*/
static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = { //--------------（1）
{ FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 480, 272, FRAMEWIN_CF_MOVEABLE, 0x64, 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 },
};
/*
*********************************************************************************************************
* 函 数 名: _cbDialog
* 功能说明: 对话框回调函数
* 形 参: pMsg 回调参数
* 返 回 值: 无
*********************************************************************************************************
*/
static void _cbDialog(WM_MESSAGE * pMsg)
{
WM_HWIN hItem;
int NCode;
int Id;
switch (pMsg->MsgId)
{
case WM_INIT_DIALOG:
//
// 初始化 'Framewin'
//
hItem = pMsg->hWin;
FRAMEWIN_SetFont(hItem, GUI_FONT_32B_ASCII);
FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
FRAMEWIN_SetText(hItem, "armfly");
//
// 初始化 'Button'
//
hItem = WM_GetDialogItem(pMsg->hWin, ID_BUTTON_0);
BUTTON_SetFont(hItem, GUI_FONT_24B_ASCII);
BUTTON_SetText(hItem, "armfly");
break;
case WM_PAINT:
GUI_SetBkColor(GUI_RED);
GUI_Clear();
break;
case WM_KEY:
switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
{
case GUI_KEY_ESCAPE:
GUI_EndDialog(pMsg->hWin, 1);
break;
case GUI_KEY_ENTER:
GUI_EndDialog(pMsg->hWin, 0);
break;
}
break;
case WM_NOTIFY_PARENT:
Id = WM_GetId(pMsg->hWinSrc);
NCode = pMsg->Data.v;
switch(Id)
{
case ID_BUTTON_0:
switch(NCode)
{
case WM_NOTIFICATION_CLICKED:
break;
case WM_NOTIFICATION_RELEASED:
break;
}
break;
case ID_SCROLLBAR_0:
switch(NCode)
{
case WM_NOTIFICATION_CLICKED:
break;
case WM_NOTIFICATION_RELEASED:
break;
case WM_NOTIFICATION_VALUE_CHANGED:
break;
}
break;
case ID_SLIDER_0:
switch(NCode)
{
case WM_NOTIFICATION_CLICKED:
break;
case WM_NOTIFICATION_RELEASED:
break;
case WM_NOTIFICATION_VALUE_CHANGED:
break;
}
break;
}
break;
default:
WM_DefaultProc(pMsg);
break;
}
}
/*
*********************************************************************************************************
* 函 数 名: CreateFramewin
* 功能说明: 创建对话框
* 形 参: 无
* 返 回 值: 返回对话框句柄
*********************************************************************************************************
*/
WM_HWIN CreateFramewin(void)
{
WM_HWIN hWin;
hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), _cbDialog, WM_HBKWIN, 0, 0);
return hWin;
}
/*
*********************************************************************************************************
* 函 数 名: _cbBkWindow
* 功能说明: 桌面窗口回调函数
* 形 参: 无
* 返 回 值: 返回对话框句柄
*********************************************************************************************************
*/
static void _cbBkWindow(WM_MESSAGE * pMsg) //--------------（2）
{
WM_HWIN hWin = pMsg->hWin;
switch (pMsg->MsgId)
{
case WM_PAINT:
GUI_SetBkColor(GUI_BLUE);
GUI_Clear();
break;
default:
WM_DefaultProc(pMsg);
}
}
/*
*********************************************************************************************************
* 函 数 名: MainTask
* 功能说明: GUI主函数
* 形 参: 无
* 返 回 值: 无
*********************************************************************************************************
*/
void MainTask(void)
{
WM_HWIN hDlg;
/*
使能窗口使用内存设备，这样可以有效避免闪烁, 放在GUI_Init前面就包括桌面
窗口，如果放在后面就不包括桌面窗口。
*/
WM_SetCreateFlags(WM_CF_MEMDEV); //--------------（3）
/* 初始emWin */
GUI_Init();
/* 设置桌面窗口的回调函数 */
WM_SetCallback(WM_HBKWIN, _cbBkWindow); //--------------（4）
/* 创建对话框 */
hDlg = CreateFramewin();
while(1)
{
GUI_Delay(10);
}
}
- 对话框资源列表第一个选项FrameWin设置了一个参数FRAMEWIN_CF_MOVEABLE，这样对话框就是可以移动的，方便查看桌面窗口回调函数的刷新。关于对话框的使用会在后面章节为大家详细讲解，这里有个感性的认识即可。
- 桌面窗口的回调函数（桌面窗口是emWin最底层的窗口，是初始化后自动创建的），这里仅实现了一个WM_PAINT消息。
- 使用函数WM_SetCreateFlags(WM_CF_MEMDEV)分两种情况，如果此函数是放在函数GUI_Init前面，那么所有的窗口将自动使用内存设备，使用内存设备的好处是有效避免闪烁感。如果此函数是放在函数GUI_Init后面调用，那么桌面窗口是没有使用内存设备的，这点要特别注意。
- 通过函数WM_SetCallback来设置桌面窗口的回调函数，实现的功能比较简单，仅设置重绘消息。这里的功能基本等同于调用函数WM_SetDesktopColor(GUI_BLUE)。实现的效果是一样的，都是可以自动重绘桌面窗口。
另外，测试中还发现一点，如果用户将函数WM_SetCreateFlags(WM_CF_MEMDEV)放在GUI_Init前面，桌面窗口也是可以自动重绘的，这样就可以不需要使用WM_SetCallback来设置桌面窗口回调函数或者使用函数WM_SetDesktopColor(GUI_BLUE)，不过重绘的颜色固定为灰色。
----------------------------
这个程序的显示效果如下（分辨率480*272）：
用户可以拖动这个窗口，鼠标点击到标题栏就可以拖动了，跟操作电脑端软件是一样的：
如果不设置桌面窗口回调函数，且函数WM_SetCreateFlags(WM_CF_MEMDEV)没有放在GUI_Init前面调用，那么拖动窗口的话，显示效果就是这个样子的：
显示成这个样子是因为桌面窗口没有执行重绘，导致拖动对话框的时候一直有上次显示的残影。
43.4 总结
本章节就跟大家讲这么多，希望通过本章教程让大家对窗口管理器有更好的认识，不过还需要大家在模拟器或者开发板上面多做这方面的练习，将其它的窗口管理器API函数也调用测试下。
以上是关于第3版emWin教程第43章 emWin6.x窗口管理器实例（含自定义消息）的主要内容，如果未能解决你的问题，请参考以下文章
第3版emWin教程第41章 emWin6.x窗口管理器基础知识（重要）
第3版emWin教程第46章 emWin6.x窗口管理器之ToolTip的使用
第3版emWin教程第42章 emWin6.x窗口管理器之回调消息类型