特别说明：完整STemWin的1-60期教程和配套实例下载地址：链接
4 |& K; G4 `- u! ?4 ~  H

第44章 FrameWin-框架窗口控件

    本期教程讲解STemWin支持的框架窗口控件。

    44. 1 框架窗口控件介绍

    44 2 官方WIDGET_FrameWin实例

    44. 3 总结

44.1 框架窗口控件介绍

    框架窗口为您的应用提供一个PC应用程序的窗口外观。这些窗口由周围框架、标题栏和用户区组成。标题栏的颜色改变以显示窗口是否激活，如下图所示：

    如下图所示，可将预定义的按钮附加到标题栏，也可将自己的按钮附加到标题栏：

    设置皮肤后显示效果如下：

44.1.1 框架窗口的结构

    下图显示了框架窗口的详细结构和外观：

    框架窗口实际上由2种窗口组成；主窗口和子窗口。子窗口称为客户端窗口。处理回调函数时意识到此点非常重要：存在具有2种不同回调函数的2种窗口。创建子窗口时，这些子窗口通常作为客户端窗口的子窗口而创建；它们的父窗口因此是客户端窗口。

细节	描述
B	框架窗口的边框尺寸。默认的边框尺寸为3像素。
H	标题栏的高度。取决于标题所用字体的尺寸。
D	标题栏和客户端窗口的间距。（1像素）
标题栏	标题栏是框架窗口的一部分，不是单独的窗口。
客户端窗口	客户端窗口是一个单独的窗口，作为框架窗口的子窗口创建。

44.2 官方WIDGET_FrameWin实例

    官方的这个实例简单的演示了FrameWin的部分功能，这个例子在模拟器中的位置：

源代码如下：

1. #include <stddef.h>
   + n! }& l8 g7 T- N
2. #include <string.h>
   8 o+ c: ?6 A/ d" ~0 q7 m
3. #include "GUI.h"
   : s# o% G, M! D$ d4 x( R
4. #include "FRAMEWIN.h"
   # p) F0 |& z  g  G, u- q
5. 
   6 k- m- t1 z3 x% G) L
6. /*********************************************************************
   
7. *
   & ~. Z7 M0 m9 \! f( w% e- _, L
8. *       Defines
   
9. *
   
10. **********************************************************************
    9 m9 e5 r' y% {
11. */
    ; H# f+ Q& m" T& r3 v
12. #define SPEED   1200
    
13. 
    
14. #define MSG_CHANGE_MAIN_TEXT (WM_USER + 0) （1）
    
15. 
    & c. V/ ?1 ^  N" U5 [
16. /*********************************************************************
    3 Y5 T/ f. U" r: a
17. *
    
18. *       Static data
    
19. *
    
20. **********************************************************************
      f8 ?/ I" M( I, u+ c. F
21. */
    ( X) @2 R8 K6 u( i
22. static FRAMEWIN_Handle  _hFrame;
    
23. static WM_CALLBACK*     _pcbOldFrame;
    , X0 z; _. i" g3 T
24. static char             _acMainText[100];
    7 m/ w* P( w5 F; R' b
25. static int              _LockClose = 1;
      y7 S4 Z$ B4 d6 ~
26. 
    
27. /*******************************************************************
    
28. *
    
29. *       Static code
    
30. *
    
31. ********************************************************************
    + P  n4 C$ G2 Y2 C! c4 {
32. */
    $ U6 j3 N$ }- r  B
33. /*******************************************************************
    + i: R* M% j* I. l5 ~
34. *
    4 n4 ~" f& n# F$ h4 C* D4 u5 D3 F
35. *       _ChangeMainText
    
36. *
    
37. *  Sends a message to the background window and invalidate it, so
    7 J- B, f; C3 N! C) Q$ P7 R: \4 V
38. *  the callback of the background window display the new text.
    . z2 r4 l" Y$ o3 v1 Y
39. */
    
40. static void _ChangeMainText(char* pStr, int Delay) {（2）
    
41.   WM_MESSAGE Message;
    
42.   Message.MsgId  = MSG_CHANGE_MAIN_TEXT;
    9 T" ^: M* @# Q; R5 I
43.   Message.Data.p = pStr;
    
44.   GUI_Delay(Delay);
    % f; ]0 w  V& \* P! r& z7 q
45.   WM_SendMessage(WM_HBKWIN, &Message);
    3 H; S8 Z8 j6 z' R$ X$ q
46.   WM_InvalidateWindow(WM_HBKWIN);
    
47.   GUI_Delay(Delay/3);
    1 L' z8 L% x6 B) q# i
48. }
    - S0 M7 U8 \, s" d$ l# q, N
49. 
    
50. /*******************************************************************
    " o" T) @% |5 a; u) t; Y( j
51. *
    
52. *       _cbChild
    
53. */
    
54. static void _cbChild(WM_MESSAGE * pMsg) {（3）
    6 \/ [# {& Y' O8 D8 ^2 i
55.   WM_HWIN hWin = (FRAMEWIN_Handle)(pMsg->hWin);
    , |2 h- m1 J. o: k; s: \! [: k- T, P
56.   switch (pMsg->MsgId) {
    0 r" K- c9 m, W" j5 r2 q3 a
57.   case WM_PAINT:
    . w0 \: `6 l  Q
58.     //
    1 Y+ X( ^: H! H& r+ c
59.     // Handle the paint message
    6 g& D* n6 K$ V9 _" G: H2 Q
60.     //
    ' x/ W( Z) q' D" l
61.     GUI_SetBkColor(GUI_WHITE);
    
62.     GUI_SetColor(GUI_BLACK);
    
63.     GUI_SetFont(&GUI_FontComic24B_ASCII);
    
64.     GUI_SetTextAlign(GUI_TA_HCENTER | GUI_TA_VCENTER);
    
65.     GUI_Clear();
    
66.     GUI_DispStringHCenterAt("Client window",
    
67.                             WM_GetWindowSizeX(hWin) / 2,
    $ P3 w+ R. i2 E) w1 @! S& d0 w
68.                             WM_GetWindowSizeY(hWin) / 2);
    4 X% p& y. m; o/ S' m. l
69.     break;
    
70.   default:
    % a1 i* X  t9 ?" i' q
71.     WM_DefaultProc(pMsg);
    
72.   }
    3 y- t. ?0 \% f' [
73. }
    / R- F, N4 I* b! W
74. 
    
75. /*******************************************************************
    ; y, q! B, ?' z- k" p8 ?4 h* m
76. *
    0 Q+ I' g8 P8 {7 E( Q: D2 _( j9 D
77. *       _cbFrame
    - A4 [; t5 H1 b4 h" b+ Z
78. */
    + W0 r7 @) T, |1 s4 B
79. static void _cbFrame(WM_MESSAGE * pMsg) {  （4）
    
80.   switch (pMsg->MsgId) {
    " p/ t8 T! Q! u. J8 R
81.   case WM_NOTIFY_PARENT:
    
82.     if (pMsg->Data.v == WM_NOTIFICATION_RELEASED) {
    
83.       int Id = WM_GetId(pMsg->hWinSrc);      // Id of widget
    
84.       if (Id == GUI_ID_CLOSE) {
    8 e1 O2 i: A# u6 z
85.         if (_LockClose) {
    
86.           return;
    + T5 Z( w6 g; K0 L. n) w
87.         }
    ( D# [' A/ N! j& P3 e
88.         _hFrame = 0;
    ! Y, o. n2 \3 M* s0 W
89.       }
    
90.     }
    ) d* z: H0 V* ^6 Y3 {
91.     break;
    
92.   }
    
93.   if (_pcbOldFrame) {
      u3 T6 s' Q1 I/ ?1 W8 r3 |* M
94.     (*_pcbOldFrame)(pMsg);
    . a5 Z" j( L1 y$ t0 n5 Y
95.   }
    
96. }
    
97. 
    
98. /*******************************************************************
    
99. *
    
100. *       _cbBkWindow
     
101. *
     1 G/ m2 `5 O* Y% q: C* g
102. * Function description
     
103. *   This callback is necessary to redraw the background when
     9 \( A  u! U- \  U6 W1 v7 ~
104. *   frame window is moved
     
105. */
     
106. static void _cbBkWindow(WM_MESSAGE * pMsg) {（5）
     
107.   switch (pMsg->MsgId) {
     
108.     case MSG_CHANGE_MAIN_TEXT:
     & S- T2 V7 L7 _5 L( N
109.       strcpy(_acMainText, (char const *)pMsg->Data.p);
     
110.       WM_InvalidateWindow(pMsg->hWin);
     ( y7 v: E* f' H7 T
111.       break;
     $ T$ m6 Q, C! R% ~% e: S( g
112.     case WM_PAINT:
     ' Z, }" u& H# Q  B
113.       GUI_SetBkColor(GUI_BLACK);
     2 K/ X7 w; u5 t! N
114.       GUI_Clear();
     
115.       GUI_SetColor(GUI_WHITE);
     ( a# t) k# l' P
116.       GUI_SetFont(&GUI_Font24_ASCII);
     & T$ P" @. i) P3 f% D
117.       GUI_DispStringHCenterAt("WIDGET_FrameWin - Sample", 160, 5);
     / t' j9 c* a; _8 o- ]3 s; k
118.       GUI_SetFont(&GUI_Font8x16);
     
119.       GUI_DispStringHCenterAt(_acMainText, 160, 40);
       l$ N" J3 _: r, e1 |1 Q
120.       GUI_SetFont(&GUI_Font6x8);
     
121.       GUI_DispStringHCenterAt("The function FRAMEWIN_Create creates both the\n"
     
122. "frame window and the client window.", 160, 190);
     3 S/ s) Z4 U5 ~
123.       break;
     
124.     default:
     
125.       WM_DefaultProc(pMsg);
     1 X/ O5 G8 N4 v! G5 h
126.   }
     1 s5 {4 d* @; K2 _
127. }
     
128. 
     0 \3 C5 \5 R7 H
129. /*******************************************************************
     
130. *
     
131. *       _DemoFramewin
     
132. *
     
133. * Function description
     8 u/ {7 o  A/ A9 s; v/ R
134. *   Creates the frame window and sets the callback for frame, child
     ( g  C9 u9 y# S
135. *   and background window
     ) ]! r% t# J2 f# W. {" x. k1 ?3 ^
136. */
     
137. static void _DemoFramewin(void) {（6）
     
138.   int i;
     8 n4 n3 K2 x8 E
139.   char acInfoText[] = "-- sec to play with window";
     6 e. a" C( I! k/ r: _5 J
140.   WM_HWIN hChild;
     6 F0 X7 C' B3 `8 G+ Q: M7 C
141. 
     . J0 {, u" p  X1 G; U" J8 b" N
142. 
     9 Y+ |0 R$ G: B1 E( V. a
143.   WM_SetCallback(WM_HBKWIN, _cbBkWindow);
     * y4 [" g, {  t# w( E7 {; @
144.   //
     ( s; x  ^1 [  ^! G6 D
145.   // Create and configure frame window
     8 M0 M9 X8 p( k: {
146.   //
     
147.   _ChangeMainText("FRAMEWIN_Create", SPEED);
     
148.   _hFrame = FRAMEWIN_Create("Frame window", 0, WM_CF_SHOW, 50, 75, 220, 100);（7）
     
149.   _pcbOldFrame = WM_SetCallback(_hFrame, _cbFrame);（8）
     
150.   hChild = WM_GetClientWindow(_hFrame);（9）
     
151.   WM_SetCallback(hChild, _cbChild);（10）
     ' F6 @( {  S$ B$ T
152.   FRAMEWIN_SetMoveable(_hFrame, 1);（11）
     " c# F$ m; c6 H9 s; H* F1 G; ]
153.   //
     
154.   // Create buttons
     , e: D- G" e0 W& L) C7 F
155.   //
     
156.   FRAMEWIN_AddCloseButton(_hFrame, FRAMEWIN_BUTTON_LEFT, 0);（12）
     1 h# H6 Z5 N( m. l$ D2 o) X
157.   FRAMEWIN_AddMaxButton(_hFrame, FRAMEWIN_BUTTON_RIGHT, 0);
     
158.   FRAMEWIN_AddMinButton(_hFrame, FRAMEWIN_BUTTON_RIGHT, 2);
     ; n& r* l) f# V6 |
159.   //
     
160.   // Modify frame window attributes
     
161.   //
       F. Q( Q# P* B8 y# u. i% ~9 O8 e
162.   _ChangeMainText("FRAMEWIN_SetActive", SPEED);
     0 B3 O, R+ c$ O! o2 [& Y  y
163.   FRAMEWIN_SetActive(_hFrame, 1);（13）
     9 [  U+ q" ?7 I
164.   _ChangeMainText("FRAMEWIN_SetFont", SPEED);
     3 ~0 t& `1 ^. |+ ~9 r* c. a
165.   FRAMEWIN_SetFont(_hFrame, &GUI_Font16B_ASCII); （14）
     7 j9 i8 b0 Z5 x
166.   FRAMEWIN_SetTitleHeight(_hFrame, 20);
     
167.   _ChangeMainText("FRAMEWIN_SetTextColor", SPEED);
     $ L. Q7 `2 V# x
168.   FRAMEWIN_SetTextColor(_hFrame, GUI_YELLOW); （15）
     
169.   _ChangeMainText("FRAMEWIN_SetTextAlign", SPEED);
     5 h7 k' T  J6 G+ ]9 ^  y- z2 l
170.   FRAMEWIN_SetTextAlign(_hFrame, GUI_TA_HCENTER);（16）
     
171.   _ChangeMainText("FRAMEWIN_Minimize", SPEED);
     3 y5 p3 M/ d" P/ s3 n* p% x7 s( |
172.   FRAMEWIN_Minimize(_hFrame);（17）
     
173.   _ChangeMainText("FRAMEWIN_Maximize", SPEED);
     
174.   FRAMEWIN_Maximize(_hFrame);  （18）
     ' A& J, @1 h1 n# D4 V' ?* K; k
175.   _ChangeMainText("FRAMEWIN_Restore", SPEED);
       Z) L/ ^6 K0 N
176.   FRAMEWIN_Restore(_hFrame);（19）
     + Z  _& o, O; v7 Y- G  n
177.   _ChangeMainText("FRAMEWIN_SetTitleVis", SPEED);
     
178.   for (i = 0; i < 5; i++) {
     1 b9 {; b/ h4 F
179.     FRAMEWIN_SetTitleVis(_hFrame, 0);  （20）
     
180.     GUI_Delay(200);
     - ^: \. u  Q7 k6 L
181.     FRAMEWIN_SetTitleVis(_hFrame, 1);
     
182.     GUI_Delay(200);
     
183.   }
     * r9 m8 X! o' s4 F) ^. E7 R% J1 h
184.   //
     5 m# x) Z& v  z; J% S8 v
185.   // Time to play with frame window
     
186.   //
     
187.   _LockClose = 0;
     
188.   for (i = 250; (i > 0) && _hFrame; i--) {
     7 s9 ^& p+ ?8 f$ o* ^
189.     acInfoText[0] = '0' + ((i + 9) / 100);
     
190.     acInfoText[1] = '0' + (((i + 9) / 10) % 10);
     / M4 m3 Y. x; w) v( [
191.     _ChangeMainText(acInfoText, 0);
     
192.     GUI_Delay(100);
     9 I+ {# b7 E. C( V, B6 P
193.   }
     
194.   if (_hFrame) {
     5 O1 P$ w9 J) m& c9 `& G+ j8 Y
195.     _ChangeMainText("FRAMEWIN_Delete", SPEED);
     ( m0 s. H' w9 B  o2 g' L
196.     FRAMEWIN_Delete(_hFrame);（21）
     
197.   } else {
     3 A1 B3 [& t, z$ a( u6 B2 J: f
198.     _ChangeMainText("", 50);
     
199.   }
     
200. }
     
201. 
     + n9 B" q+ G8 ]4 q9 Q) \
202. /*********************************************************************
     
203. *
     
204. *       Public code
     4 @8 y( t* w& ?" l9 e2 l, t
205. *
     
206. **********************************************************************
     
207. */
     
208. /*********************************************************************
     3 Y  ^" p3 _$ h- ], p: Z
209. *
     7 F0 T% M6 A; a" M% B8 ^" _! X' Q
210. *       MainTask
     
211. */
     9 r# s* f6 S" x* ]8 F6 G
212. void MainTask(void) {
     6 x; Y# T5 q3 w- y
213.   GUI_Init();
     
214.   WM_EnableMemdev(WM_HBKWIN); （22）
     " l% J4 k* Q4 j2 q4 o- ~6 J8 @
215.   while(1) {
     
216. _DemoFramewin();
     . q' Y$ }, q( Q+ C7 X
217.   }
     3 h, D) B, e' A" b& w& s4 J+ S
218. }

复制代码

1. 自定义的一个回调消息类型。

2. 用于给桌面窗口发送自定义的回调函数消息类型。发送后将桌面窗口变得无效，然后系统就会去执行桌面窗口回调函数中的WM_PAINT消息。

3. 框架窗口中客户窗口的回调函数。

4. 框架窗口的回调函数。

5. 桌面窗口的回调函数。

6. 框架窗口中部分API函数的演示函数。

7. 创建框架窗口。

8. 设置框架窗口的回调函数。

9. 得到框架窗口中客户端窗口句柄。

10. 设置客户端窗口的回调函数。

11. 设置框架窗口可移动。

12. 为框架窗口添加最小化，最大化和关闭按钮。

13. 激活框架窗口。

14. 设置框架窗口中标题的字体。

15. 设置框架窗口中标题的颜色。

16. 设置框架窗口中标题文本的对齐。

17. 最小化框架窗口。

18. 最大化框架窗口。

19. 恢复最小化或最大化的框架窗口。

20. 设置框架窗口的标题可见。

21. 删除框架窗口。

22. 使能桌面窗口的内存设备。

   这个例子中变量_LockClose的作用也很重要，它的主要作用就是在演示框架窗口时锁住关闭按钮，防止在演示的时候，用户点击了关闭按钮。大家也特别注意框架窗口回调函数_cbFrame的处理。

实际显示效果如下：

44.3 总结

    本期教程主要是跟大家讲解了框架窗口的使用，希望大家可以把本期教程中讲的这个例子跑跑，然后自己设计一个相关的例子进行试验学习。教程中只是使用了部分的框架窗口API，其它的API大家都可以试试。

( |2 G- i; [. @6 {

学习学习，初学者看到这个感觉比较高深，确实挺感兴趣的