【emWin实战教程V2.0】第53章 MESSAGEBOX-消息框控件

开发板

转最新版本教程
本章节为大家讲解STemWin支持的消息框控件，消息框控件实际上是由框架窗口，按钮控件和文本控件组成的对话框。消息框主要用于信息提示，实际使用也比较简单。
由于消息框控件较简单，我们没有配套开发板例子，将官方的两个例子给大家讲解下。
53.1 初学者重要提示
53.2 消息框控件基础知识
53.3 官方DIALOG_MessageBox.c实例讲解
53.4 官方DIALOG_MessageBoxUser.c实例讲解
53.5 总结

lee_st · 2017-3-10 17:16:54

53.1  初学者重要提示

1、初学者爱问的问题简单汇总：
      问题1：消息框控件的大小可以改变吗，默认方式显示的太小了？
      答：可以的，详情请看本章节53.4小节讲解的官方例子。

lee_st · 2017-3-10 17:18:32

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

lee_st · 2017-3-10 17:18:52

下图是英文版手册里面API函数的位置（新的emWin版本已经将这部分知识放在了对话框部分）：

lee_st · 2017-3-10 17:19:15

53.2 消息框控件基础知识

下面我们先来看看消息对话框长什么样子，不开启皮肤色时显示效果如下：

开启皮肤后显示效果如下：

lee_st · 2017-3-10 17:19:27

相信大家在电脑端经常见到这种提示窗口，没错，就是它，一般主要用于消息提示。消息框控件的组成也比较简单，由
框架窗口，文本控件和按钮控件组成的阻塞式对话框，只有用户点击了上面的按钮才会将此消息框控件关闭。
消息框控件的使用也比较简单，仅有两个相关的函数：GUI_MessageBox()和MESSAGEBOX_Create()。

lee_st · 2017-3-10 17:19:36

53.2.1 消息框控件支持的通知代码

消息框控件不支持通知代码。

lee_st · 2017-3-10 17:19:44

53.2.2 消息框控件支持的键盘反应（输入聚焦）

由于消息框控件是由框架窗口，文本控件和按钮控件组成，而只有按钮控件是支持聚焦的，所以消息框控件的聚
焦就是按钮的聚焦，按钮支持的键盘消息在第45章的45.2.2小节有讲解，这里不再赘述。

lee_st · 2017-3-10 17:19:57

53.3 官方DIALOG_MessageBox.c实例讲解

这个例子在模拟器中的位置：

lee_st · 2017-3-10 17:20:11

主要功能介绍：
这个例子比较简单，就是函数GUI_MessageBox的调用。
程序代码如下：

lee_st · 2017-3-10 17:20:22

#include "GUI.h"
#include "WM.h"

/*********************************************************************
*
*       Defines
*
**********************************************************************
*/
//
// Recommended memory to run the sample with adequate performance
//
#define RECOMMENDED_MEMORY (1024L * 10)

/*******************************************************************
*
*       Static code
*
********************************************************************
*/
/*********************************************************************
*
*       _cbBkWindow
*/
static void _cbBkWindow(WM_MESSAGE* pMsg) {
  switch (pMsg->MsgId) {
  case WM_PAINT:
    GUI_SetBkColor(GUI_RED);
    GUI_Clear();
    GUI_SetColor(GUI_WHITE);
    GUI_SetFont(&GUI_Font24_ASCII);
    GUI_DispStringHCenterAt("DIALOG_MessageBox - Sample", 160, 5);
    break;
  default:
    WM_DefaultProc(pMsg);
  }
}

/*********************************************************************
*
*       Public code
*
**********************************************************************
*/
/*********************************************************************
*
*       MainTask
*/
void MainTask(void) {
  GUI_Init();
  //
  // Check if recommended memory for the sample is available
  //
  if (GUI_ALLOC_GetNumFreeBytes() < RECOMMENDED_MEMORY) {
    GUI_ErrorOut("Not enough memory available.");
    return;
  }
  #if GUI_SUPPORT_MEMDEV
    WM_SetCreateFlags(WM_CF_MEMDEV);
  #endif
  WM_SetCallback(WM_HBKWIN, &_cbBkWindow);
  //
  // Create message box and wait until it is closed
  //
  while (1) {
    GUI_MessageBox("This text is shownnin a message box",      //--------------（1）
                   "Caption/Title", GUI_MESSAGEBOX_CF_MOVEABLE);
    GUI_Delay(750);                    // Wait for a short moment ...
    GUI_MessageBox("New message !",
                   "Caption/Title", GUI_MESSAGEBOX_CF_MOVEABLE); //--------------（2）
    GUI_Delay(750);
  }
}

lee_st · 2017-3-10 17:20:33

1. 通过函数GUI_MessageBox创建消息框控件，这个函数的使用也比较简单，第一个参数是用来设置标题栏显示的内容，第二个参数是文本控件显示的内容，第三个参数用来设置此消息框控件是否可移动。点击OK按钮后，这个消息框控件就关闭了。
2. 再次调用函数GUI_MessageBox创建消息框控件。

lee_st · 2017-3-10 17:20:45

实际显示效果如下：

lee_st · 2017-3-10 17:20:58

53.4 官方DIALOG_MessageBoxUser.c实例讲解

这个例子在模拟器中的位置：

lee_st · 2017-3-10 17:21:12

主要功能介绍：
由于函数GUI_MessageBox创建的消息框控件比较小，所以官方提供了一个用户自定义方式创建消息框控件，
通过这个例子用户就可以学会如何重新设置消息框控件中的框架窗口，按钮控件和文本控件。
程序代码如下：

lee_st · 2017-3-10 17:21:20

#include "DIALOG.h"
#include "MESSAGEBOX.h"

/*********************************************************************
*
*       Defines
*
**********************************************************************
*/
//
// Recommended memory to run the sample with adequate performance
//
#define RECOMMENDED_MEMORY (1024L * 10)

/* 字体部分代码省略未贴 */

/*********************************************************************
*
*       Static code
*
**********************************************************************
*/
/*********************************************************************
*
*       _CreateMessageBox
*/
static WM_HWIN _CreateMessageBox(const char * sMessage, const char * sCaption, int Flags, const GUI_FONT * pFont) {
  WM_HWIN  hWin;
  WM_HWIN  hItem;
  GUI_RECT Rect;

  hWin = MESSAGEBOX_Create(sMessage, sCaption, Flags); //--------------（1）
  //
  // Change font of message box window
  //
  FRAMEWIN_SetFont(hWin, pFont);            //--------------（2）
  //
  // Adjust size
  //
  WM_GetWindowRectEx(hWin, &Rect);          //--------------（3）
  WM_SetWindowPos(hWin, Rect.x0 - 15,
                        Rect.y0 - 15,
                        Rect.x1 - Rect.x0 + 1 + 30,
                        Rect.y1 - Rect.y0 + 1 + 30);
  //
  // Change font of button widget
  //
  hItem = WM_GetDialogItem(hWin, GUI_ID_OK); //--------------（4）
  BUTTON_SetFont(hItem, pFont);
  //
  // Adjust size of button widget
  //
  WM_GetWindowRectEx(hItem, &Rect);           //--------------（5）
  WM_SetWindowPos(hItem, Rect.x0,
                         Rect.y0 + 10,
                         Rect.x1 - Rect.x0 + 1 + 30,
                         Rect.y1 - Rect.y0 + 1 +  5);
  //
  // Change font of text widget
  //
  hItem = WM_GetDialogItem(hWin, GUI_ID_TEXT0); //--------------（6）
  TEXT_SetFont(hItem, pFont);
  //
  // Adjust size text widget
  //
  WM_GetWindowRectEx(hItem, &Rect);           //--------------（7）
  WM_SetWindowPos(hItem, Rect.x0,
                         Rect.y0,
                         Rect.x1 - Rect.x0 + 1 + 30,
                         Rect.y1 - Rect.y0 + 1 + 12);
  return hWin;
}

/*********************************************************************
*
*       _EnableSkinning
*/
static void _EnableSkinning(void) {
  FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
  BUTTON_SetDefaultSkin  (BUTTON_SKIN_FLEX);
}

/*********************************************************************
*
*       Public code
*
**********************************************************************
*/
/*********************************************************************
*
*       MainTask
*/
void MainTask(void) {
  GUI_Init();
  //
  // Check if recommended memory for the sample is available
  //
  if (GUI_ALLOC_GetNumFreeBytes() < RECOMMENDED_MEMORY) {
    GUI_ErrorOut("Not enough memory available.");
    return;
  }
  _EnableSkinning();
  while (1) {
    GUI_SetFont(&GUI_Font20B_ASCII);
    GUI_DispStringHCenterAt("Application defined MESSAGEBOX", 160, 5);
    GUI_ExecCreatedDialog(_CreateMessageBox("Message", "Caption", 0, &GUI_Font24)); //--------------（8）
    GUI_Clear();
    GUI_Delay(1000);
  }
}

lee_st · 2017-3-10 17:21:41

1. 通过函数MESSAGEBOX_Create创建消息框控件，这个函数的使用也比较简单，第一个参数是用来设置文本控件显示的内容，第二个参数是标题栏显示的内容，第三个参数用来设置是否将其设置为模态。
2. 由于消息框控件的组成是框架窗口，文本控件和按钮控件组成的对话框，所以函数MESSAGEBOX_Create返回的句柄实际上就是框架窗口的句柄，从而可以通过函数FRAMEWIN_SetFont调用这个句柄来设置框架窗口的标题字体。
3. 通过函数WM_GetWindowRectEx和WM_SetWindowPos来设置消息框控件（其实就是框架窗口）的大小。
4. 通过函数WM_GetDialogItem获取消息框控件上按钮的句柄（此按钮的ID是GUI_ID_OK），然后设置按钮的字体。

lee_st · 2017-3-10 17:21:49

5. 通过函数WM_GetWindowRectEx和WM_SetWindowPos来设置按钮控件的大小。
6. 通过函数WM_GetDialogItem获取消息框控件上文本的句柄（此文本的ID是GUI_ID_TEXT0），然后设置文本的字体。
7. 通过函数WM_GetWindowRectEx和WM_SetWindowPos来设置文本控件的大小。
8. 通过函数GUI_ExecCreatedDialog将消息框控件以阻塞式运行。只有点击了消息框控件上面的按钮，此函数才可以返回。