【STemWin教程】第49章 MESSAGEBOX-消息框控件

席萌0209

特别说明：完整STemWin的1-60期教程和配套实例下载地址：链接

第49章 MESSAGEBOX-消息框控件

    本期教程讲解STemWin支持的消息框控件。
    49. 1 消息框控件介绍
    49. 2 官方DIALOG_MessageBox实例
    49. 3官方DIALOG_MessageBoxUser实例
    49. 4 总结
49.1 消息框控件介绍
    使用MESSAGEBOX控件可在带有标题栏和 “确定”按钮 （必须按下才能关闭窗口）的框架窗口中显示消息。创建消息框或者创建并执行消息框仅需一行代码。下表显示MESSAGEBOX小工具的外观：

    消息控件的使用比较简单，仅有两个相关的API：GUI_MessageBox()和MESSAGEBOX_Create()。
49.2 官方DIALOG_MessageBox实例
    官方的这个实例很好的演示了MessageBox的使用，这个例子在模拟器中的位置：

源码如下（程序中进行了详细的注释）：

1. ----------------------------------------------------------------------
2. File        : DIALOG_MessageBox.c
3. Purpose     : Example demonstrating GUI_MessageBox
4. Requirements: WindowManager - (x)
5.               MemoryDevices - (x)
6.               AntiAliasing  - ( )
7.               VNC-Server    - ( )
8.               PNG-Library   - ( )
9.               TrueTypeFonts - ( )
10. ----------------------------------------------------------------------
11. */
13. #include "GUI.h"
14. #include "WM.h"
16. /*******************************************************************
17. *
18. *       Static code
19. *
20. ********************************************************************
21. */
22. /*********************************************************************
23. *
24. *       _cbBkWindow
25. *    桌面窗口的回调函数
26. */
27. static void _cbBkWindow(WM_MESSAGE* pMsg) {
28.   switch (pMsg->MsgId) {
29.   case WM_PAINT:
30.     GUI_SetBkColor(GUI_RED);
31.     GUI_Clear();
32.     GUI_SetColor(GUI_WHITE);
33.     GUI_SetFont(&GUI_Font24_ASCII);
34.     GUI_DispStringHCenterAt("DIALOG_MessageBox - Sample", 160, 5);
35.     break;
36.   default:
37.     WM_DefaultProc(pMsg);
38.   }
39. }
41. /*********************************************************************
42. *
43. *       Public code
44. *
45. **********************************************************************
46. */
47. /*********************************************************************
48. *
49. *       MainTask
50. */
51. void MainTask(void) {
52.   GUI_Init();
54.   /* 开启窗口使用内存设备 */
55.   #if GUI_SUPPORT_MEMDEV
56.     WM_SetCreateFlags(WM_CF_MEMDEV);
57.   #endif
58.   /* 设置桌面窗口的回调函数 */
59.   WM_SetCallback(WM_HBKWIN, &_cbBkWindow);
61.   //
62.   // 创建消息框，等待直到他被关闭
63.   //
64.   while (1) {
65.     GUI_MessageBox("This text is shown\nin a message box",
66. "Caption/Title", GUI_MESSAGEBOX_CF_MOVEABLE);
67.     GUI_Delay(750);                    // 延迟一段时间
68.     GUI_MessageBox("New message !",
69. "Caption/Title", GUI_MESSAGEBOX_CF_MOVEABLE);
70.     GUI_Delay(750);
71.   }
72. }

复制代码

实际显示效果如下：

49.3 官方DIALOG_MessageBoxUser实例
    官方的这个实例很好的演示了MessageBox的使用，这个例子在模拟器中的位置：

源码如下（程序中进行了详细的注释）：

1. /*********************************************************************
2. *
3. *       Static code
4. *
5. **********************************************************************
6. */
7. /*********************************************************************
8. *
9. *       _CreateMessageBox
10. */
11. static WM_HWIN _CreateMessageBox(const char * sMessage, const char * sCaption, int Flags, const GUI_FONT * pFont) {
12.   WM_HWIN  hWin;
13.   WM_HWIN  hItem;
14.   GUI_RECT Rect;
16.   hWin = MESSAGEBOX_Create(sMessage, sCaption, Flags);
17.   //
18.   // 设置消息框中标题的字体，消息框本质上也是框架窗口，所以这里可以直接的调用修改
19.   //
20.   FRAMEWIN_SetFont(hWin, pFont);
21.   //
22.   // 调整大小
23.   //
24.   WM_GetWindowRectEx(hWin, &Rect);
25.   WM_SetWindowPos(hWin, Rect.x0 - 15,
26.                         Rect.y0 - 15,
27.                         Rect.x1 - Rect.x0 + 1 + 30,
28.                         Rect.y1 - Rect.y0 + 1 + 30);
29.   //
30.   // 设置按钮控件的字体
31.   //
32.   hItem = WM_GetDialogItem(hWin, GUI_ID_OK);
33.   BUTTON_SetFont(hItem, pFont);
34.   //
35.   // 调节按钮控件的大小
36.   //
37.   WM_GetWindowRectEx(hItem, &Rect);
38.   WM_SetWindowPos(hItem, Rect.x0,
39.                          Rect.y0 + 10,
40.                          Rect.x1 - Rect.x0 + 1 + 30,
41.                          Rect.y1 - Rect.y0 + 1 +  5);
42.   //
43.   // 设置文本控件的字体
44.   //
45.   hItem = WM_GetDialogItem(hWin, GUI_ID_TEXT0);
46.   TEXT_SetFont(hItem, pFont);
47.   //
48.   // 调节文本控件的大小
49.   //
50.   WM_GetWindowRectEx(hItem, &Rect);
51.   WM_SetWindowPos(hItem, Rect.x0,
52.                          Rect.y0,
53.                          Rect.x1 - Rect.x0 + 1 + 30,
54.                          Rect.y1 - Rect.y0 + 1 + 12);
55.   return hWin;
56. }
58. /*********************************************************************
59. *
60. *       _EnableSkinning
61. */
62. static void _EnableSkinning(void) {
63.   FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
64.   BUTTON_SetDefaultSkin  (BUTTON_SKIN_FLEX);
65. }
67. /*********************************************************************
68. *
69. *       Public code
70. *
71. **********************************************************************
72. */
73. /*********************************************************************
74. *
75. *       MainTask
76. */
77. void MainTask(void) {
78.   GUI_Init();
79.   /* 使能皮肤 */
80.   _EnableSkinning();
81.   while (1) {
82.     GUI_SetFont(&GUI_Font20B_ASCII);
83.     GUI_DispStringHCenterAt("Applicatoin defined MESSAGEBOX", 160, 5);
84. /* 执行已经创建的对话框 */
85.     GUI_ExecCreatedDialog(_CreateMessageBox("Message", "Caption", 0, &GUI_Font24));
86.     GUI_Clear();
87.     GUI_Delay(1000);
88.   }
89. }

复制代码

实际显示效果如下：

49.4 总结
    本期教程主要是跟大家讲解了消息框的两种创建方法，一种是系统自带的，直接调用即可显示，也就是本期教程中的第一个例子。另一种是用户的创建方式，这种模式下用户可以自定义在消息框中要显示的内容。