特别说明：完整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. */
    
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 总结

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

多谢分享！

控件好搞不

Mark            学习学习

学习学习