【STM32H7】第24章 ThreadX GUIX按钮回调事件处理

最新教程下载：http://www.armbbs.cn/forum.php?mod=viewthread&tid=98429

第24章 ThreadX GUIX按钮回调事件处理

本章节为大家讲解GUIX按钮回调事件处理。这个功能用的到地方很多，比如点击按钮控制硬件外设。

24.1初学者重要提示

24.2 GUIX Studio窗口控件每个参数的含义

24.3 GUIX Studio按钮控件每个参数的含义

24.4 GUIX Studio设置窗口回调事件

24.4 实验例程设计框架

24.5实验例程

24.6 总结

24.1 初学者重要提示

务必看第11章学习GUIX Studio的使用方法和第12章学习GUIX Studio生成的代码移植到硬件平台的方法。
本章讲解的按钮回调事件处理本质是按钮父窗口的回调函数里面处理按钮按下消息。

24.2 GUIX Studio窗口控件每个参数的含义

GUIX Studio中窗口控件每个参数的定义如下（了解每个参数的作用，做到心里有底）：

Widget Type

控件类型。

Windget Name

控件名

Widget Id

控件ID

User Data

控件用户数据，通过宏定义GX_WIDGET_USER_DATA使能，只是个简单的int型变量。

Left
Top

窗口左上角位置。

Width
Height

窗口的宽和高。

Border

边界效果

Transparent

设置透明，对应创建标志GX_STYLE_TRANSPARENT。

Draw Selected

默认显示选中状态。

对应创建标志GX_STYLE_DRAW_SELECTED。

Enabled

使能窗口，允许控件接收用户输入事件和产生输出信号。

对应创建标志GX_STYLE_ENABLED。

Accepts Focus

使能聚焦，对应标志GX_STATUS_ACCEPTS_FOCUS。

Runtime Allocate

使能运行时动态申请和释放内存。

Normal fill

正常状态填充色

Seclected fill

选中状态填充色

Disable fill

禁止状态填充色

Template

将当前创建的窗口设置为模板，可以通过GUIX Studio创建这种模板

Visible At Starup

设置GUIX首先显示的界面。

Draw Function

重绘函数。

Event Functiong

事件处理函数。

Wallpaper

设置背景图

Title Wallpaper

窗口将平铺所有分配的背景图到窗口客户端。

对应宏定义GX_STYLE_TILE_WALLPAPER。

24.3 GUIX Studio按钮控件每个参数的含义

GUIX Studio中窗口控件的参数如下（左侧是Text Button，右侧是标准Button）：

Widget Type

控件类型。

Windget Name

控件名。

Widget Id

控件ID

User Data

控件用户数据，通过宏定义GX_WIDGET_USER_DATA使能。

只是个简单的int型变量。

Left
Top

窗口左上角位置。

Width
Height

窗口的宽和高。

Border

边界效果

Transparent

设置透明。

对应创建标志GX_STYLE_TRANSPARENT。

Draw Selected

默认显示选中状态。

对应创建标志GX_STYLE_DRAW_SELECTED。

Enabled

使能窗口，允许控件接收用户输入事件和产生输出信号。

对应创建标志GX_STYLE_ENABLED。

Accepts Focus

使能聚焦，对应标志GX_STATUS_ACCEPTS_FOCUS。

Runtime Allocate

使能运行时动态申请和释放内存。

Normal fill

正常状态填充色

Seclected fill

选中状态填充色

Disable fill

禁止状态填充色

Template

将当前创建的窗口设置为模板，可以通过GUIX Studio创建这种模板

Visible At Starup

设置GUIX首先显示的界面。

Draw Function

重绘函数

Event Functiong

事件处理函数

Pushed

设置按钮在按下或者选中状态。

对应宏定义GX_STYLE_BUTTON_PUSHED。

Toggle

设置按钮为按下和取消按下两种状态，类似Checkbox控件。

对应宏定义GX_STYLE_BUTTON_TOGGLE

Radio

类似Radio控件。

对应宏定义GX_STYLE_BUTTON_RADIO。

Auto Repeat

长时间按下按钮，使能连发功能。

对应宏定义GX_STYLE_BUTTON_REPEAT。

String ID

按钮字符ID。

Text

按钮字符内容。

Font

按钮字符字体。

Text Align

按钮字符对齐方式。

Normal Text Color

按钮字符颜色。

Selected Text Color

选择按钮时，字符颜色。

Disabled Text Color

取消按钮选中时，字符颜色

Private Text Copy

使能字符可以动态更新。

24.4 GUIX Studio设置窗口回调事件

GUIX Studio的设置方法与第11章一样，我们这里把控件的位置和大小做了调整，并为window窗口创建一个回调函数。

新调整的界面效果如下：

24.4.1 窗口事件回调设置

下面我们为窗口控件设置一个Event Function，此功能是窗口的事件回调函数。在这个回调函数里面，大家可以处理各种事件。

这里为Event Function设置的回调函数名为_cbEventWindow，然后就可以使用GUIX Studio生成新的代码。生成的代码移植到硬件平台的方法看第12章即可。

24.4.2 按钮控件ID设置

注意按钮的ID设置GUIX_ID_TextButton0，后面要用到：

24.5 GUIX定时器更新功能

在GUIX Studio上设置好事件回调函数名后，剩下就是在程序里面实现事件回调的处理，这里把实现方法为大家做个说明。

24.5.1 窗口里事件回调的消息处理（按钮点击）

GUIX Studio窗口上按钮点击消息处理要在窗口事件回调函数里面实现。窗口的Event Function事件回调函数实现框架如下：

代码语言：javascript复制

UINT _cbEventWindow(GX_WINDOW *widget, GX_EVENT *event_ptr)
{
    switch (event_ptr->gx_event_type)
    {
        /* 控件显示事件 */
        case GX_EVENT_SHOW:
            break;

        /* 按钮点击消息处理 */
        case GX_SIGNAL(GUIX_ID_TextButton0, GX_EVENT_CLICKED):
            break;

        default:
            return gx_window_event_process(widget, event_ptr);
    }

    return 0;
}

事件回调函数还有很多其它事件供用户使用。这个框架基本是固定的，大家直接调用即可，下面举一个实例来说明按钮点击消息的使用。

24.5.2 窗口里面定时器更新功能实例（重要）

实例代码如下，本章教程配套例子也是用的这个代码：

代码语言：javascript复制

/*
*********************************************************************************************************
*    函 数 名: _cbEventWindow
*    功能说明: 窗口window的事件回调函数
*    形    参: widget     窗口句柄 
*             event_ptr  事件指针
*    返 回 值: 返回0表示成功
*********************************************************************************************************
*/
UINT _cbEventWindow(GX_WINDOW *widget, GX_EVENT *event_ptr)
{

    switch (event_ptr->gx_event_type)
    {
        /* 控件显示事件 */
        case GX_EVENT_SHOW:

            /* 默认事件处理 */
            gx_window_event_process(widget, event_ptr);
            break;
       
        /* 按钮GUIX_ID_TextButton0的点击消息处理 */
        case GX_SIGNAL(GUIX_ID_TextButton0, GX_EVENT_CLICKED):
            bsp_LedToggle(2); 
            break;

        default:
            return gx_window_event_process(widget, event_ptr);
    }

    return 0;
}