18. 按钮控件

emWin提供了三种按键式的控件，分别是：按钮（Button）、复选框（Checkbox）和单选按钮（Radio button）。本章我们先学习使用按钮控件。

按钮控件主要用于触屏设备的交互，可以说是用户最重要的界面元素之一。按钮控件具有输入焦点， 所以也可以响应GUI_KEY_SPACE和GUI_KEY_ENTER键盘消息。按钮中可以显示文本，也可以用位图贴图，甚至可以更改按钮形状。

emWin中的按钮样式如图 18‑1所示。

图 不同效果的按钮样式 中左侧是不带皮肤的经典按钮样式，右侧是V5.28版本以后自带皮肤效果的按钮样式。

按钮控件支持三种通知代码，以区分不同的按钮动作。如表格 按钮支持的通知代码 所示。

这三种通知代码是作为WM_NOTIFY_PARENT消息的一部分发送到其父窗口的。当用户点击按钮后， 窗口管理器向父窗口发送WM_NOTIFY_PARENT消息时，会在消息结构的Data.v成员中附加相应的通知代码， 用户程序可以读取此成员来检测不同的按钮动作以及实现各种功能。

按钮控件支持输入焦点，支持键盘或其他类似键盘的外部输入设备对按钮的控制。如果按钮控件已被聚焦， 那它可以接收表格 按钮控件支持的键盘消息 中的按键消息。

18.1. 创建按钮控件
18.1.1. 按钮控件API
按钮控件的 API 函数较多，这里我们只列出一些比较常用的，见表格 按钮API函数 。完整的API函数请查阅emWin官方手册。

18.1.2. 按钮控件创建函数
18.1.2.1. BUTTON_CreateEx()
在指定位置创建指定大小的按钮控件。

代码清单:按钮-1 按钮创建函数

BUTTON_Handle BUTTON_CreateEx(int x0, int y0, int xSize, int ySize,
                            WM_HWIN hParent, int WinFlags,
                            int ExFlags, int Id);

1. x0： 按钮控件在父坐标中的最左侧像素；

2. y0： 按钮控件在父坐标中的最顶侧像素；

3. xSize： 按钮的水平尺寸，以像素为单位；

4. ySize： 按钮的垂直尺寸，以像素为单位；

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

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

7. ExFlags： 预留，未使用；

8. 控件ID号 。

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

18.1.2.2. BUTTON_CreateIndirect()
代码清单:按钮-2 对话框方式创建按钮函数

BUTTON_Handle BUTTON_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： 按钮控件在父坐标中的最顶部像素；

5. cb： 回调函数指针。

此函数的第一个参数指向的是 代码清单:控件基础-3 的资源表结构，但不使用其中的Flag参数和para参数。

18.2. 按钮控件基础实验
接下来我们来讲解如何以对话框的方式间接创建一个按钮控件，通过API函数直接创建的实验可参考官方例程WIDGET_ButtonSimple.c，例程路径如下：

SeggerEval_WIN32_MSVC_MinGW_GUI_V548\Sample\Tutorial\WIDGET_ButtonSimple.c

18.2.1. 代码分析
18.2.1.1. 创建对话框
代码清单:按钮-3 创建对话框（ButtonDLG.c文件）

/* 控件ID */
#define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
#define ID_BUTTON_0 (GUI_ID_USER + 0x01)
#define ID_BUTTON_1 (GUI_ID_USER + 0x02)
#define ID_BUTTON_2 (GUI_ID_USER + 0x03)

/* 资源表 */
static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
   
    {
    FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 800,
    480, 0, 0x0, 0 },
    {
    BUTTON_CreateIndirect, "Button0", ID_BUTTON_0, 10, 30, 160, 48,
    0, 0x0, 0 },
    {
    BUTTON_CreateIndirect, "Button1", ID_BUTTON_1, 10, 138, 160, 48,
    0, 0x0, 0 },
    {
    BUTTON_CreateIndirect, "Button2", ID_BUTTON_2, 50, 246, 80, 80,
    0, 0x0, 0 },
};

/**
* @brief 以对话框方式间接创建控件
* @note 无
* @param 无
* @retval hWin：资源表中第一个控件的句柄
*/
WM_HWIN CreateFramewin(void)
{
   
    WM_HWIN hWin;

    hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(
        _aDialogCreate), _cbDialog, WM_HBKWIN,