emwin教程_emwin教程

大家好，又见面了，我是你们的朋友全栈君。如果您正在找激活码,请点击查看最新教程,关注关注公众号 “全栈程序员社区” 获取激活教程,可能之前旧版本教程已经失效.最新Idea2022.1教程亲测有效,一键激活。

Jetbrains全系列IDE稳定放心使用

1.位图显示

emWin 支持三种位图文件形式： .c 文件位图、 .dta 格式流位图和.bmp 格式位图

.c 文件形式的位图必须跟随工程文件一起放置在 MCU 的内部 FLASH 中，这就导致 c 文件位图的大小、质量和数量等受到内部 FLASH 容量的限制。相反流位图可放置在任何存储器中，并可按照与 C 文件位图相同的方式使用

(1)BmpCvt[位图转换器]
作用将位图从PC格式转换为C文件，emwin可使用的位图在C文件中定义为
GUI_BITMAP结构体。
注：如果图片要转化为bmp格式，可以用画图软件，像素大小要合适

1)配置颜色保存模式
设置如下：

2)打开文件添加图片
3)保存C文件
4)选择C文件的颜色格式
选择RGB565格式

通过上述步骤，即可成功创建 BMP 图像文件的 C 数组。如果需要生成.dta 格式的流位图，在保存文件时选择保存类型为.dta 文件即可。
生成的主要代码：

GUI_BITMAP 结构体

typedef struct { 
   
  U16P XSize;
  U16P YSize;
  U16P BytesPerLine;
  U16P BitsPerPixel;
  const U8 * pData;
  const GUI_LOGPALETTE * pPal;
  const GUI_BITMAP_METHODS * pMethods;
} GUI_BITMAP;

1) XSize：位图的宽度；
2) YSize：位图的高度；
3) BytesPerLine：位图图像每一行的字节数，该参数与位图的宽度和颜色格式有关，
假设位图使用的颜色格式是 ARGB8888，乘上图片的宽度，就是图像每一行的字节数；
4) BitsPerPixel：位图图像单个像素所占的位数，该参数和上一个参数都与位图的宽
度和颜色格式有关，假设位图使用的颜色格式是 ARGB8888，那么图像单个像素数据就
占 32 位；
5) pData：指向位图像素数据；
6) pPal：调色板，该参数在 24 位色及以上的位图中是没有的，只有低于 24 位色的
位图才有调色板；
7) pMethods： emWin 的绘图调色板，在位图转换时生成。

绘制位图API

GUI_DrawBitmap()
在当前窗口中的指定位置绘制位图图像。

void GUI_DrawBitmap(const GUI_BITMAP * pBM, int x, int y);
1) pBM：指向要显示的位图的指针；
2) x：位图在显示屏中左上角的 X 轴坐标；
3) y：位图在显示屏中左上角的 Y 轴坐标。

GUI_DrawBitmapEx()
通过此例程可以缩放和/或镜像显示屏上的位图

void GUI_DrawBitmapEx(const GUI_BITMAP * pBitmap,
					 int x0, int y0,
 					 int xCenter, int yCenter,
					 int xMag, int yMag);

1) pBM：指向要显示的位图的指针；
2) x0：显示屏中定位点的 X 坐标；
3) y0：显示屏中定位点的 Y 坐标；
4) xCenter：位图中定位点的 X 坐标；
5) yCentert：位图中定位点的 Y 坐标；
6) xMag:X方向的缩放比例因子，单位为 1/1000，当值为负值时将在 X 轴镜像位图；
7) yMag:Y方向的缩放比例因子，单位为 1/1000，当值为负值时将在 Y 轴镜像位图。

GUI_CreateBitmapFromStream()
函数通过传递任何类型的位图流来创建位图结构体

int GUI_CreateBitmapFromStream(	GUI_BITMAP * pBMP,
								GUI_LOGPALETTE * pPAL,
								const void * p);
1) pBMP：指向要由函数初始化的 GUI_BITMAP 结构体的指针；
2) pPAL：指向要由函数初始化的 GUI_LOGPALETTE 结构体的指针；
3) p：指向数据流的指针。

GUI_DrawStreamedBitmapAuto()
从任何支持格式的位图数据流中绘制位图。

void GUI_DrawStreamedBitmapAuto(const void * p, int x, int y);
1) p：指向数据流的指针；
2) x：显示屏中位图左上角的 X 坐标；
3) y：显示屏中位图左上角的 Y 坐标。

效果：

2.颜色

逻辑颜色和物理颜色

逻辑颜色:应用程序处理的颜色，包含三个 8位的颜色分量和一个 8 位的 alpha 通道。
逻辑颜色有ABGR和ARGB
ABGR:

ARGB:

现在主要使用ARGB这个格式
物理颜色是显示器实际显示的颜色，在运行时，逻辑颜色映射到物理颜色

预定义颜色：这一篇文章中有详情
添加链接描述

调色板：

注:
调色板的标识符有些带有字母 M，而另外一些则不带字母 M。这也是跟之前的逻辑颜色格式有关，含字母 M 的表示 ARGB 颜色格式使用的板，不带 M的表示在 ABGR 格式下使用的调色板

色彩深度和像素格式

色彩深度 (color depth)，也称为位深度 (bit depth)，表示图像中存储一个像素的色彩信息所占用的位数，单位是位/像素 (bits per pixel) 或 bpp。
通常说的什么 8 位、 24 位图像，这个多少位指的就是色彩深度。色彩深度越大，则单个像素包含的色彩信息越多，图像整体的颜色就越丰富。常见的色彩深度有 1bpp、 4bpp、 8bpp、 16bpp、 24bpp 和 32bpp。

像素格式 (pixel format)，它表示为一个像素的颜色信息以什么样的方式和顺序进行存储。
如 RGB565 表示用 16 位的色彩深度存储单个像素的颜色信息，从高位到低位依次存放红绿蓝三色，其中红色和蓝色占 5 位，绿色占 6 位。同一种色彩深度可以对应不同的像素格式。还是刚才的 RGB565 像素格式，这次我交换红色和蓝色的存放顺序，就变成了另一种像素格式 BGR565，但色彩深度还是 16 位

重要颜色API

GUI_SetBkColor()      设置背景色颜色
GUI_SetColor()         设置前景色颜色

3.内存设备

内存设备是 emWin 的一种绘图机制，可以用在各种绘图操作中，可以通过它实现一些华丽炫酷的界面效果。不过其最主要的作用是用来消除在绘制重叠项目时出现的屏幕闪烁。

基本思路：
内存设备消除屏幕闪烁的基本思路很简单，不使用内存设备时，每一步绘制操作都会直接写入屏幕，这就导致屏幕刷新时内容出现闪烁，例如要显示一张位图并在位图上绘制透明文本，首先必须绘制位图，然后绘制透明文本，那么效果就是文本会出现闪烁。

如果使用内存设备，所有的绘制操作都在内存中进行，绘制完成后才更新到屏幕，所以没有闪烁。所谓闪烁其实就是屏幕出现了明显可观察到的绘图过程，而内存设备机制只将绘制完成的图形写入屏幕，所以观察不到明显的绘图过程，也就消除了闪烁。

常用API

1.GUI_MEMDEV_CopyToLCD()
将内存设备的内容从内存复制到 LCD

void GUI_MEMDEV_CopyToLCD(GUI_MEMDEV_Handle hMem );
 hMem：内存设备的句柄。

注：该函数忽略窗口管理器的剪切区域和 alpha 通道。因此，不建议在 paint 事件中使用此函数。为了显示关于剪切区域和 alpha 通道的内存设备，应该使用函数 GUI_MEMDEV_WriteAt()。

2.GUI_MEMDEV_CopyToLCDAt()
将内存设备的内容复制到 LCD 的指定位置。

void GUI_MEMDEV_CopyToLCDAt(GUI_MEMDEV_Handle hMem, int x, int y);
1) hMem：内存设备的句柄；
2) x：指定的 X 位置；
3) y：指定的 Y 位置。

3.GUI_MEMDEV_Create()
创建一个内存设备。

GUI_MEMDEV_Handle GUI_MEMDEV_Create(int x0, int y0, int xSize, int ySize);
1) x0：内存设备的 X 位置；
2) y0：内存设备的 Y 位置；
3) xSize：内存设备的 X 方向大小；
4) ySize：内存设备的 Y 方向大小。
返回值：创建的内存设备句柄，如果创建失败，则返回值为 0。

4.GUI_MEMDEV_CreateFixed()
创建一个具有固定色彩深度和调色板的内存设备。

GUI_MEMDEV_Handle GUI_MEMDEV_CreateFixed
(
int x0, int y0,
int xSize, 
int ySize, 
int Flags,
const tLCDDEV_APIList * pMemDevAPI,
const LCD_API_COLOR_CONV *pColorConvAPI
);

1) x0：内存设备的 X 位置；
2) y0：内存设备的 Y 位置；
3) xSize：内存设备的 X 方向大小；
4) ySize：内存设备的 Y 方向大小；

5) Flags：创建标志，允许的参数如下：
GUI_MEMDEV_HASTRANS：默认值，内存设备使用透明标志创建，该标志确保正确
绘制背景；
GUI_MEMDEV_NOTRANS：创建不透明的内存设备，必须正确绘制背景。可用于非
矩形区域，比透明标志内存设备快 30 - 50%。

6) pMemDevAPI：定义内存设备的色彩深度，允许的参数值如下：
GUI_MEMDEV_APILIST_1：创建具有 1bpp 色彩深度的内存设备；
GUI_MEMDEV_APILIST_8：创建具有 8bpp 色彩深度的内存设备；
GUI_MEMDEV_APILIST_16：创建具有 16bpp 色彩深度的内存设备；
GUI_MEMDEV_APILIST_32：创建具有 32bpp 色彩深度的内存设备。

7) pColorConvAPI：所需的固定调色板，允许的参数值如下：
GUICC_1：固定调色板模式 1(黑/白)；
GUICC_2：固定调色板模式 2(4 种灰度)；
GUICC_4：固定调色板模式 4(16 种灰度)；
GUICC_565：固定调色板模式 565；
GUICC_M565：固定调色板模式 M565；
GUICC_8666：固定调色板模式 8666；
GUICC_888：固定调色板模式 888；
GUICC_8888：固定调色板模式 8888。
返回值：创建的内存设备句柄，如果创建失败，则返回值为 0

5.GUI_MEMDEV_Delete()
删除内存设备。

void GUI_MEMDEV_Delete(GUI_MEMDEV_Handle MemDev);
 hMem：需要删除的内存设备句柄。

6.GUI_MEMDEV_Select()
激活内存设备 / (如果句柄为 0，则激活 LCD)。

GUI_MEMDEV_Handle GUI_MEMDEV_Select(GUI_MEMDEV_Handle hMemDev);
 hMem：内存设备的句柄。
 返回值：上一个内存设备的句柄，如果上一次选择的是 LCD，则返回 0。

大致步骤：

GUI_MEMDEV_Handle hMem = 0; //创建一个句柄对象
hMem = GUI_MEMDEV_Create(Rect.x0, Rect.y0, Rect.x1 - Rect.x0, Rect.y1 - Rect.y0);	//创建存储设备 其实就是一个矩形框
GUI_MEMDEV_Select(hMem);	//选择hMem作为绘制操作目标的存储设备
_Draw(0);  					//执行要显示的内容复制到存储设备中
GUI_MEMDEV_Select(0);  		//选中LCD ，激活内存设备 (如果句柄为 0，则激活 LCD)。

GUI_MEMDEV_CopyToLCDAt(hMem, LCD_GetXSize() - Rect.x1, Rect.y0); //将存储设备的内容从内存复制到LCD的指定位置

4.窗口管理器

窗口管理器是 emWin 的核心功能。窗口就是应用程序对应的一个个矩形区域，而窗口管理器用来管理这些矩形区域。

一些术语：

活动窗口：当前用于绘图操作的窗口称为活动窗口。它不一定就是最上层的窗口

回调函数：回调函数由用户程序定义，指示图形系统在发生特定事件时调用特定函数。
通常，当窗口的内容发生更改时，它们用于自动重绘窗口

子窗口/父窗口 ：
子窗口是相对于其他窗口（称为父窗口）定义的。只要父窗口移动，其子窗口就
会相应移动。子窗口始终完全包含在其父窗口中，并在必要时会被裁剪。具有相
同父窗口的多个子窗口被视为同属窗口

客户区：
客户区就是窗口的的可用区域。如果一个窗口包含一个框架或标题栏，那么客户
端区域就是矩形的内部区域。如果没有这样的框架，则客户端区域的坐标与窗口
本身的坐标相同。

裁剪，裁剪区域：
裁剪是将输出限制为窗口或窗口的一部分的过程。窗口的剪辑区域是其可见区
域，是窗口区域减去被更高 Z 轴阶层的同属窗口遮挡的区域，然后减去没有放入
父窗口可见区域的任何部分

坐标：
坐标通常是二维坐标，以像素为单位表示(x,y)

桌面坐标:
桌面坐标是桌面窗口的坐标。屏幕的左上角位置 (原点) 是 (0,0)

桌面窗口(背景窗口):
由窗口管理器自动创建的，并且总是覆盖整个显示区域。
桌面窗口在 emWin 初始化完成后就创建好了，
之后所有的操作都在桌面窗口基础上进行

前期裁剪/后期裁剪:
前期裁剪是默认的裁剪模式。
裁剪动作在窗口接收绘制事件之前执行。
如果需要裁剪当前窗口，它将在单个绘图过程中接收多个 WM_PAINT 消息。

后期裁剪,窗口始终只接收一条 WM_PAINT 消息，
此时裁剪动作在绘图操作中执行

句柄:
创建新窗口时，窗口管理器会为其分配一个名为句柄的唯一标识符。句柄用于在
该特定窗口上执行的任何进一步操作

隐藏/显示窗口:
一个隐藏的窗口是不可见的，尽管它仍然存在 (有一个句柄)。
创建窗口时，如果没有指定创建标志，则默认情况下它是隐藏的。

父坐标:
父坐标是相对于父窗口的窗口坐标。窗口的左上角位置（原点）是（0,0）

窗口坐标:
窗口坐标是窗口的坐标。窗口的左上位置（原点）是（0,0）。

透明度:
具有透明度的窗口包含不随窗口其余部分重新绘制的区域。这些区域的运作方式
就像“透过”它们背后的窗口一样。在这种情况下，重要的是要在窗口之前以透
明的方式重新绘制后面的窗口。窗口管理器自动按照正确的顺序处理重绘。

有效化/无效化:
一个有效的窗口是一个完全更新的窗口，它不需要重新绘制。无效窗口尚未反映
所有更新，因此需要全部或部分重新绘制。
当发生影响特定窗口的更改时，窗口
管理器将该窗口标记为无效。下一次重新绘制窗口 (手动或通过回调例程) 时，将
验证它

Z 轴位置，底部/顶部:
虽然窗口以 X 和 Y 的形式显示在二维屏幕上，但窗口管理器还可管理 Z-位置 (深
度坐标) 即虚拟三维中的一个位置，它决定了窗口从背景到前景的位置。
将一个窗口设置为底部将把它“放在”它所的同属窗口 (如果有的话) 下面；
将它设置为顶部将会将它“置于”它的同属窗口之上。
创建窗口时，如果没有指定创建标志，则默认将其设置为顶部。

窗口的特点：

是矩形的；
有一个 Z 位置；
可能隐藏或显示；
可能包含有效和/或无效区域；
可能有也可能没有透明度；
可能有也可能没有回调函数。

窗口管理器的回调机制、无效化和渲染

1)使用回调函数渲染窗口
想要创建具有回调的窗口，必须定义一个回调函数
当使用 WM_CreateWindow() 函数创建窗口时，这个回调函数将作为参数

回调函数

void Callback(WM_MESSAGE * pMsg);
// pMsg：指向 WM_MESSAGE 类型结构体的指针

结构体：
struct WM_MESSAGE 
{ 
   
	int MsgId; /* 消息类型 */
	WM_HWIN hWin; /* 目标窗口 */
	WM_HWIN hWinSrc; /* 源窗口 */
	union { 
   
	const void * p;/* 消息特定数据指针 */
	int v;
	GUI_COLOR Color;
	void (* pFunc)(void);
		} Data;
};

1) MsgId：消息类型；
2) hWin：目标窗口；
3) hWinSrc：源窗口；
4) Data：数据联合体，其中比较重要的两个参数如下：
• p：消息特定数据指针；
• v：消息数据

**回调函数中执行的具体操作取决于它接收的消息类型。**窗口回调函数中需要构建一个 switch 语句，它使用一个或多个 case 语句为不同的消息定义不同的行为。通常至少需要存在一个 WM_PAINT消息

窗口通过 WM_PAINT 消息重绘自身，不过在将此消息发送到窗口之前，窗口管理器需要确保需要重绘的窗口已被选中。普通窗口收到 WM_PAINT 消息后，默认情况下会重绘自身整个区域。为了加快绘制过程，窗口管理器的裁剪机制会确保只重绘窗口的无效区域

注：在 WM_PAINT 消息中，除了重绘窗口内容外不得执行其他操作。不得在 WM_PAINT 消息中调用以下函数： WM_SelectWindow()、 WM_PAINT()、 WM_DeleteWindow() 和 WM_CreateWindow()。
此外，类似 WM_Move() 和 WM_Resize() 这类改变窗口属性的函数也都不得在 WM_PAINT 消息中调用

emWin 支持多种消息类型，主要分为四大类

桌面窗口重绘和回调

在窗口管理器初始化期间，会创建一个包含整个 LCD 区域的窗口作为桌面窗口。这个窗口的句柄是 WM_HBKWIN。

由于没有默认的背景颜色，窗口管理器并不会自动重绘桌面窗口区域。
如果你创建了一个新的窗口然后删除它，这个窗口仍然可见不会消失。
解决办法是通过WM_SetDesktopColor() 函数设置用于重绘桌面窗口的颜色。
或者可以设置一个回调函数来处理这个问题。如果像上面一样创建并删除一个窗口，回调函数将触发窗口管理器确认桌面窗口不再有效并自动重绘。

窗口无效化

无效窗口或窗口的一部分失效区域会告诉窗口管理器，在下一次调用重绘函数时重绘窗口的无效区域。

emWin 提供的无效化函数不负责重绘窗口的无效部分，它们只负责管理窗口的无效区域。

无效化函数：

void WM_InvalidateWindow(WM_HWIN hWin);  使指定窗口无效。hWin 窗口句柄

void WM_InvalidateRect(WM_HWIN hWin, GUI_RECT* pRect); 
使窗口的指定矩形区域无效。  hWin 窗口句柄
pRect  指向带父窗口的窗口坐标的GUI_RECT结构的指针

void WM_InvalidateArea(GUI_RECT* pRect);
使显示器的指定矩形区域无效
pRect：指向带有桌面坐标的GUI_RECT结构的指针

真正负责重绘的是 GUI_Exec() 或 GUI_Delay() 等函数。

裁剪机制

窗口的绘制或重绘通常是通过发送一次 WM_PAINT 消息来完成的。

但是，如果一个窗口的部分区域被子窗口或任何其他窗口覆盖，那么被覆盖的窗口将会重复接收到若干次的 WM_PAINT 消息。

窗口管理器将窗口未被覆盖的区域裁剪成若干子矩形。在此过程中，
窗口管理器将每个子矩形都设置为裁剪区域，并将所有子矩形的 WM_PAINT 消息都发送给被覆盖的窗口。

窗口被覆盖的区域越碎片，存在的矩形就越多，发送的消息就越多。因此，在处理WM_PAINT 消息的程序中不应该执行费时的操作。

渲染透明窗口

如果需要绘制或重绘透明窗口，窗口管理器将自动确保在透明窗口收到 WM_PAINT 消息之前绘制窗口的背景。

实现方法是，在向透明窗口发送 WM_PAINT 消息前，先重绘透明窗口无效区域下的所有窗口区域，然后再向透明窗口发送 WM_PAINT 消息。

透明窗口的重绘操作必须在WM_PAINT 消息内进行，否则可能无法正确绘制外观。透明窗口比普通不透明窗口更耗费 CPU。

自动使用内存设备

窗口管理器的默认行为是向每个需要重绘的窗口发送 WM_PAINT 消息，这可能导致闪烁现象。使用内存设备可以在绘图操作时自动抑制每个窗口的闪烁现象

通过在创建窗口时设置WM_CF_MEMDEV 标志，或使用 WM_SetCreateFlags() 函数设置默认创建标志即可使用内存设备进行重绘操作，或使用函数 WM_EnableMemdev() 为指定窗口开启内存设备

窗口管理器将 WM_PAINT 消息的输出位置重定向到内存设备中，重绘完成后把内存设备中的内容复制到屏幕上。

以上这些内存设备都是在窗口管理器发送 WM_PAINT 消息之前在内部创建的，并在重绘完成后立即删除。如果使用内存设备重绘透明窗口，那么窗口无效区域下方的内容也会放到内存设备中进行重绘。

重要窗口管理器 API

void WM_BringToBottom(WM_HWIN hWin);
将指定的窗口放在其同属窗口的底部。  hWin：窗口句柄
注：执行该函数后，窗口将被放置在所有其他同属窗口的下方，但仍将位于其父窗口的
前面。WM_BringToTop() 函数与其相反

WM_HWIN WM_CreateWindow(int x0, int y0, int xSize, int ySize, 
							U32Style, WM_CALLBACK * cb, 
							int NumExtraBytes);

1) x0：窗口坐标中的左上 X 位置；
2) y0：窗口坐标中的左上 Y 位置；
3) xSize：窗口的 X 方向大小；
4) ySize：窗口的 Y 方向大小；
5) Style：窗口创建标志，最常用的有 WM_CF_MEMDEV(使用内存设备)、 WM_CF_SHOW(开启显示) 等标志
6) cb：指向回调函数的指针，如果没有使用回调函数则填 NULL；
7) NumExtraBytes：要分配的额外字节数，通常为 0。
返回值：创建好的窗口的句柄


WM_HWIN WM_CreateWindowAsChild(int x0, int y0, int xSize, int ySize,
 								WM_HWIN hWinParent, 
 								U32 Style,
 								WM_CALLBACK* cb, 
 								int NumExtraBytes);
1) x0：窗口坐标中的左上 X 位置；
2) y0：窗口坐标中的左上 Y 位置；
3) xSize：窗口的 X 方向大小；
4) ySize：窗口的 Y 方向大小；
5) hWinParent：父窗口的句柄；
6) Style：窗口创建标志，同 WM_CreateWindow()；
7) cb：指向回调函数的指针，如果没有使用回调函数则填 NULL；
8) NumExtraBytes：要分配的额外字节数，通常为 0。
返回值：创建好的窗口的句柄。
注：如果 hWinParent 参数设置为 0，则使用桌面窗口作为父窗口

void WM_DefaultProc(WM_MESSAGE * pMsg);
默认的消息处理函数
x0：消息指针。
该函数用来处理用户不关心或不处理的各种消息。

void WM_DeleteWindow(WM_HWIN hWin);
删除指定窗口。并释放窗口动态分配的内存
如果指定的窗口具有子窗口，则在删除窗口本身之前，自动删除这些子窗口。


WM_HWIN WM_GetDialogItem(WM_HWIN hDialog, int Id);
返回指定对话框中的指定控件的句柄
hDialog：对话框句柄；
Id：控件 ID。
返回值：控件句柄。
创建对话框时必须使用此函数，因为对话框中使用的控件 ID 必须在使用前转换为句柄

void WM_HideWindow(WM_HWIN hWin);
调用此函数后，窗口不会立即隐藏。只有当执行 WM_Exec() 重绘后，才会被隐藏
如果需要立即隐藏一个窗口，应该调用 WM_Paint 来重绘。 WM_ShowWindow() 函数与其类似

void WM_InvalidateWindow(WM_HWIN hWin);
无效化指定窗口

void WM_MoveTo(WM_HWIN hWin, int x, int y);
将指定的窗口移动到指定位置

void WM_MoveWindow(WM_HWIN hWin, int dx, int dy);
将指定的窗口移动一定距离
1) hWin：需要移动的窗口的句柄；
2) dx：水平移动距离；
3) dy：垂直移动距离。


WM_CALLBACK * WM_SetCallback(WM_HWIN hWin, WM_CALLBACK * cb);
设置要由窗口管理器执行的回调例程，可以是自定义回调
1) hWin：需要设置的窗口的句柄；
2) cb：指向回调函数的指针。
返回值：上一个回调函数的指针。


U8 WM_SetCreateFlags(U8 Flags);
设置创建新窗口时默认使用的标志
1) Flags：窗口创建标志，
此函数设置的创建标志会影响到所有窗口，可以通过此函数在 GUI_Init() 之前设置
创建标志。通常此函数与 WM_CF_MEMDEV 标志一起使用，用于在所有窗口上启用内存
设备


GUI_COLOR WM_SetDesktopColor(GUI_COLOR Color);
设置桌面窗口的颜色。
由于桌面窗口默认没有指定颜色，所以它没有重绘功能。使用此函数设置桌面窗口颜色
后，桌面窗口就可以重绘自身


void WM_GetInsideRect(GUI_RECT* pRect)
返回客户区的坐标，该区域由活动小工具尺寸减去边界尺寸确定

int GUI_Exec(void);
执行回调函数（通常为重新绘制窗口）。
如果未执行任务，则返回值为0。
如果执行了一个任务，则返回值为1。
此函数将自动重复调用GUI_Exec1()，直至完成所有作业–实质是直至返回0值为止。
正常情况下，用户应用不需要调用此函数。它自动由GUI_Delay()调用。


int GUI_Exec1(void);
执行一个回调函数（仅一个任务——通常为重新绘制窗口）。

窗口创建标志