特别说明：完整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. ----------------------------------------------------------------------
   - h/ f% X' f  W" W' {
2. File        : DIALOG_MessageBox.c
   
3. Purpose     : Example demonstrating GUI_MessageBox
   
4. Requirements: WindowManager - (x)
   
5.               MemoryDevices - (x)
   ' W$ a& r6 p) a+ Y* u7 g8 _
6.               AntiAliasing  - ( )
   
7.               VNC-Server    - ( )
   
8.               PNG-Library   - ( )
   
9.               TrueTypeFonts - ( )
   
10. ----------------------------------------------------------------------
    # M3 {" f8 f0 T3 ?2 l3 a
11. */
    ! r  Y! |5 S% L% n% f
12. 
    
13. #include "GUI.h"
    1 E8 h* J' K* I  u/ M- D/ e' W
14. #include "WM.h"
    
15. 
    9 {% S' {5 {( {4 @9 z
16. /*******************************************************************
    
17. *
    
18. *       Static code
    
19. *
    
20. ********************************************************************
    
21. */
    ) G! b9 [2 l$ w
22. /*********************************************************************
    
23. *
    
24. *       _cbBkWindow
      r2 l0 l& D6 N3 I
25. *    桌面窗口的回调函数
    ( h6 q6 g8 X) v/ j0 _% i3 Z
26. */
    1 ]4 A0 ]6 f+ X/ C& a. I. m' \* k# d
27. static void _cbBkWindow(WM_MESSAGE* pMsg) {
    
28.   switch (pMsg->MsgId) {
    
29.   case WM_PAINT:
    % ]7 U/ F  Y" q* S
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);
    1 t* W2 J" D0 b- ^+ J/ m
35.     break;
    
36.   default:
    
37.     WM_DefaultProc(pMsg);
    ; ~$ \" g/ }  U. S# d2 o6 u
38.   }
    5 x; T4 E2 \. G8 Q, s! \6 ]
39. }
    
40. 
    ; L* J- s. b1 m' J- d- H3 L0 }& j
41. /*********************************************************************
    * S' J8 {: g' f2 x( f) o
42. *
    ! J3 w- ^! J2 h' a) q
43. *       Public code
    
44. *
    7 C1 x8 U& {* c% }, B; x
45. **********************************************************************
    2 t, c0 N! Q$ N( L' e
46. */
    
47. /*********************************************************************
    / q& {; g6 M7 {3 |/ {' l
48. *
    
49. *       MainTask
    
50. */
    " c! f! x2 C, B4 B
51. void MainTask(void) {
    1 p5 Q! ~+ B3 X# Z' e8 ?8 i6 D
52.   GUI_Init();
    
53. 
    
54.   /* 开启窗口使用内存设备 */
    # |# J8 i0 F0 x/ o4 Q  V  @8 {4 f
55.   #if GUI_SUPPORT_MEMDEV
    
56.     WM_SetCreateFlags(WM_CF_MEMDEV);
    - ^( q3 ^' ?6 a2 K& _# }. w; d0 S
57.   #endif
    " @7 U3 t2 x/ _" {: E$ U+ e
58.   /* 设置桌面窗口的回调函数 */
    
59.   WM_SetCallback(WM_HBKWIN, &_cbBkWindow);
    : G& l# J, `5 S! _
60. 
    1 y3 W& X5 }- v: s0 J
61.   //
    
62.   // 创建消息框，等待直到他被关闭
    
63.   //
    . I3 G3 A3 h4 Y/ n- M: ~
64.   while (1) {
    * g$ D5 L. I# K. d; K
65.     GUI_MessageBox("This text is shown\nin a message box",
    
66. "Caption/Title", GUI_MESSAGEBOX_CF_MOVEABLE);
    
67.     GUI_Delay(750);                    // 延迟一段时间
    : e% G5 P5 J8 r: a+ e# |% D
68.     GUI_MessageBox("New message !",
    6 J% A3 _) ]7 m. g' b
69. "Caption/Title", GUI_MESSAGEBOX_CF_MOVEABLE);
    
70.     GUI_Delay(750);
    
71.   }
    ! ]7 g% a7 |  Z4 j
72. }

复制代码

实际显示效果如下：

49.3 官方DIALOG_MessageBoxUser实例

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

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

1. /*********************************************************************
   
2. *
   1 R9 x* {% L% D& I. Q9 @
3. * Static code
   
4. *
   
5. **********************************************************************
   
6. */
   . c3 \/ I9 ]8 c4 |3 }4 R
7. /*********************************************************************
   : Y! e3 d% ]8 W" D2 J5 ]
8. *
   % Z5 V7 y5 [1 O6 k6 a5 R" L
9. * _CreateMessageBox
   $ O7 N4 u; n4 p9 m" S3 z$ D+ R
10. */
    
11. static WM_HWIN _CreateMessageBox(const char * sMessage, const char * sCaption, int Flags, const GUI_FONT * pFont) {
    
12. WM_HWIN hWin;
    : a. v+ y* Z3 X  z' V' `! r4 E
13. WM_HWIN hItem;
    $ d' o$ [( R0 l8 I0 A
14. GUI_RECT Rect;
    # q9 V8 p9 j" U/ x8 t1 ~
15. 
    % V' L* \/ w) z3 b0 Z
16. hWin = MESSAGEBOX_Create(sMessage, sCaption, Flags);
    ( o# h. P8 k# r$ s; A: {
17. //
    
18. // 设置消息框中标题的字体，消息框本质上也是框架窗口，所以这里可以直接的调用修改
    
19. //
    
20. FRAMEWIN_SetFont(hWin, pFont);
    8 Q" g8 y* z2 [) T
21. //
      H! K% {7 A$ `" W
22. // 调整大小
    1 x1 i/ ?& p& ?7 e- G- k4 K
23. //
    1 u* C) p" D$ m! b  R7 W
24. WM_GetWindowRectEx(hWin, &Rect);
    
25. WM_SetWindowPos(hWin, Rect.x0 - 15,
    
26. Rect.y0 - 15,
    , c* @" N" q! z$ q1 `9 }$ q
27. Rect.x1 - Rect.x0 + 1 + 30,
    
28. Rect.y1 - Rect.y0 + 1 + 30);
    
29. //
    
30. // 设置按钮控件的字体
    9 @  ]6 d2 L2 M$ g
31. //
    
32. hItem = WM_GetDialogItem(hWin, GUI_ID_OK);
    
33. BUTTON_SetFont(hItem, pFont);
    
34. //
    
35. // 调节按钮控件的大小
    + ]; w+ u6 V, u/ a0 d
36. //
    
37. WM_GetWindowRectEx(hItem, &Rect);
    
38. WM_SetWindowPos(hItem, Rect.x0,
    : m5 \; y% Y9 Q- B8 X, P
39. Rect.y0 + 10,
    
40. Rect.x1 - Rect.x0 + 1 + 30,
    ( D3 R. o4 A5 U
41. Rect.y1 - Rect.y0 + 1 + 5);
    & S' `+ y/ i0 E6 }" ^4 O! Z( E
42. //
    9 K% K  u9 R/ o. l7 x5 V
43. // 设置文本控件的字体
    
44. //
    # r7 W4 M: Q. u2 g7 G0 i, f( E
45. hItem = WM_GetDialogItem(hWin, GUI_ID_TEXT0);
    2 B3 D- _! |8 ~) W% k# L3 ^
46. TEXT_SetFont(hItem, pFont);
    
47. //
    5 S0 G. Q8 J4 b* C6 Z
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. 
    1 r2 N" ]- @4 A( m5 R3 D
58. /*********************************************************************
    ' a0 q0 D4 b: u" {5 w6 M  o' N0 p2 Q& w
59. *
    
60. * _EnableSkinning
      Y9 m: U9 X% `
61. */
    , l8 u) S1 d- p, V8 e0 A$ M' y
62. static void _EnableSkinning(void) {
    : u' q2 j. J- G  b" D
63. FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
    
64. BUTTON_SetDefaultSkin (BUTTON_SKIN_FLEX);
    
65. }
    
66. 
    
67. /*********************************************************************
    
68. *
    
69. * Public code
    
70. *
    ) X( K. `/ X/ J/ X! G
71. **********************************************************************
    
72. */
    
73. /*********************************************************************
    ) k; Z7 g4 `- F, |
74. *
    
75. * MainTask
    * \1 M0 ?5 d0 V; O0 E
76. */
    
77. void MainTask(void) {
    5 @5 e7 N) k: k& t8 a" a
78. GUI_Init();
    + P7 N5 F/ J. x) W4 o* S3 q6 n  K
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));
    , l$ \3 b) F- M! |
86. GUI_Clear();
    
87. GUI_Delay(1000);
    
88. }
    " h6 v4 ?2 K+ n6 J8 E$ `" ]6 g
89. }

复制代码

实际显示效果如下：

49.4 总结

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

# i6 }4 o# e" H8 ~  ]: V. {

多谢分享！

控件好搞不

Mark            学习学习

学习学习