第49章 MESSAGEBOX-消息框控件

    本期教程讲解STemWin支持的消息框控件。

    49. 1 消息框控件介绍

    49. 2 官方DIALOG_MessageBox实例

    49. 3官方DIALOG_MessageBoxUser实例

    49. 4 总结

    使用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. */
    
12. 
    
13. #include "GUI.h"
    
14. #include "WM.h"
    
15. 
    
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. }
    
40. 
    
41. /*********************************************************************
    
42. *
    
43. *       Public code
    
44. *
    
45. **********************************************************************
    
46. */
    
47. /*********************************************************************
    
48. *
    
49. *       MainTask
    
50. */
    
51. void MainTask(void) {
    
52.   GUI_Init();
    
53. 
    
54.   /* 开启窗口使用内存设备 */
    
55.   #if GUI_SUPPORT_MEMDEV
    
56.     WM_SetCreateFlags(WM_CF_MEMDEV);
    
57.   #endif
    
58.   /* 设置桌面窗口的回调函数 */
    
59.   WM_SetCallback(WM_HBKWIN, &_cbBkWindow);
    
60. 
    
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;
    
15. 
    
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. }
    
57. 
    
58. /*********************************************************************
    
59. *
    
60. *       _EnableSkinning
    
61. */
    
62. static void _EnableSkinning(void) {
    
63.   FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
    
64.   BUTTON_SetDefaultSkin  (BUTTON_SKIN_FLEX);
    
65. }
    
66. 
    
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  总结

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

对论坛没啥贡献啊