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

第44章 FrameWin-框架窗口控件

7 |4 I' H  j$ |/ T

    本期教程讲解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>
   
2. #include <string.h>
     F3 e! |. M  [$ C$ a- y" K1 o9 U! V" R
3. #include "GUI.h"
   
4. #include "FRAMEWIN.h"
   2 g/ W7 L7 E- ]: C& w/ ]
5. 
   % |: n. [- K8 I  }! E- q, b
6. /*********************************************************************
   
7. *
   
8. *       Defines
   $ A6 X2 I% t2 a1 J$ |' b6 k
9. *
   
10. **********************************************************************
    
11. */
    
12. #define SPEED   1200
    
13. 
    . E3 o. H! @2 C
14. #define MSG_CHANGE_MAIN_TEXT (WM_USER + 0) （1）
    - ~; p7 t9 A4 k0 l! z1 ^
15. 
    1 ^9 U6 Z  w9 h4 P" S( d
16. /*********************************************************************
    & p+ ]0 [. d  x6 l6 ^' f! T, @/ \
17. *
    
18. *       Static data
    
19. *
    
20. **********************************************************************
    
21. */
    
22. static FRAMEWIN_Handle  _hFrame;
    
23. static WM_CALLBACK*     _pcbOldFrame;
    
24. static char             _acMainText[100];
    ; y- ?) o* i4 u. c
25. static int              _LockClose = 1;
    
26. 
    . N3 g' ?( u9 N7 Y+ w$ b
27. /*******************************************************************
    
28. *
    
29. *       Static code
    / l9 I9 K8 ^6 F: @) j1 {
30. *
    6 c* ]* |9 I( |. a+ t' X
31. ********************************************************************
    ( [. k! R6 |) L1 u* D! [
32. */
    ; ?" G7 H) ^1 R
33. /*******************************************************************
    
34. *
    & }# v& r' O* n
35. *       _ChangeMainText
    : c: v2 i9 d1 Y: b
36. *
    
37. *  Sends a message to the background window and invalidate it, so
    
38. *  the callback of the background window display the new text.
    
39. */
    / E1 `+ Y7 X& c: g+ H6 i
40. static void _ChangeMainText(char* pStr, int Delay) {（2）
    # c3 O! V( ^# {' _* x; I. `' U4 ]; F7 _
41.   WM_MESSAGE Message;
    
42.   Message.MsgId  = MSG_CHANGE_MAIN_TEXT;
    3 g. `$ t0 c0 c0 g# g
43.   Message.Data.p = pStr;
    9 A6 p" l7 c6 i- E
44.   GUI_Delay(Delay);
    9 x  b! n' V( |2 S9 b
45.   WM_SendMessage(WM_HBKWIN, &Message);
    
46.   WM_InvalidateWindow(WM_HBKWIN);
    3 Q; Y  V) Q- f/ O) l3 ~5 B+ h9 R
47.   GUI_Delay(Delay/3);
    5 f" O  v5 A. w/ t& i5 x6 D# R$ [
48. }
    ) e, q' O) t- ^: R. C
49. 
    
50. /*******************************************************************
    & r* H$ B4 g# p! e
51. *
    
52. *       _cbChild
    / v6 _5 H, k6 p1 S! h5 T4 l
53. */
    1 Q) D0 j0 u$ i+ W8 m4 l0 H' f
54. static void _cbChild(WM_MESSAGE * pMsg) {（3）
    8 G3 J* R2 t3 F! p
55.   WM_HWIN hWin = (FRAMEWIN_Handle)(pMsg->hWin);
    
56.   switch (pMsg->MsgId) {
    ; M4 Z$ _% s3 I
57.   case WM_PAINT:
    8 r( X: ~3 M0 Z0 D& |, v
58.     //
    ; |+ S9 F% O0 K  v8 x
59.     // Handle the paint message
    
60.     //
    9 ?+ R! Q2 T. ]1 r/ ]
61.     GUI_SetBkColor(GUI_WHITE);
    
62.     GUI_SetColor(GUI_BLACK);
    ' K! d) r% l  W/ |
63.     GUI_SetFont(&GUI_FontComic24B_ASCII);
    
64.     GUI_SetTextAlign(GUI_TA_HCENTER | GUI_TA_VCENTER);
    - }9 b! s8 \8 R! M" m7 K% H* U2 `
65.     GUI_Clear();
    
66.     GUI_DispStringHCenterAt("Client window",
    & E8 Q" T1 ?7 n# n
67.                             WM_GetWindowSizeX(hWin) / 2,
    
68.                             WM_GetWindowSizeY(hWin) / 2);
    
69.     break;
    
70.   default:
    ! V6 d& _5 t* {' |5 y0 \
71.     WM_DefaultProc(pMsg);
    
72.   }
    , B  j9 \% g/ K) u/ N9 \$ }8 n
73. }
    4 m8 U4 n( z' d$ ]6 y9 W0 [& b$ D
74. 
    
75. /*******************************************************************
    
76. *
    ( o3 x$ N" s( m
77. *       _cbFrame
    2 }6 ?- W* P+ O. v7 M' t9 F
78. */
    
79. static void _cbFrame(WM_MESSAGE * pMsg) {  （4）
    
80.   switch (pMsg->MsgId) {
    9 o& D( l3 t! T+ S* [1 o
81.   case WM_NOTIFY_PARENT:
    
82.     if (pMsg->Data.v == WM_NOTIFICATION_RELEASED) {
    * b$ W# U4 `& |; C0 z  q
83.       int Id = WM_GetId(pMsg->hWinSrc);      // Id of widget
    9 m$ u: L: P3 g  k3 B. w* w
84.       if (Id == GUI_ID_CLOSE) {
    
85.         if (_LockClose) {
    
86.           return;
    9 [/ S: c: r0 z0 E
87.         }
    $ c1 o  V6 E& o5 T9 m0 [% e
88.         _hFrame = 0;
    
89.       }
    
90.     }
    ) l+ i( a# R3 h: D9 \+ s
91.     break;
    3 f& ]) B9 y; j) N; k
92.   }
    
93.   if (_pcbOldFrame) {
    ) V6 l) O# V3 r5 Y1 r- h
94.     (*_pcbOldFrame)(pMsg);
    
95.   }
    
96. }
    
97. 
    
98. /*******************************************************************
    $ e2 B4 R$ l  i. J8 K: H; D
99. *
    
100. *       _cbBkWindow
     
101. *
     
102. * Function description
     
103. *   This callback is necessary to redraw the background when
     7 b7 c0 D1 w/ C. p  a4 d) V
104. *   frame window is moved
     
105. */
     % q0 ~* b+ o/ B8 F) I0 I
106. static void _cbBkWindow(WM_MESSAGE * pMsg) {（5）
     7 A( e6 C8 a1 E! m, _/ F/ @- i4 E
107.   switch (pMsg->MsgId) {
     
108.     case MSG_CHANGE_MAIN_TEXT:
     ) q/ P; j  k8 _- Z* n1 k" W
109.       strcpy(_acMainText, (char const *)pMsg->Data.p);
     
110.       WM_InvalidateWindow(pMsg->hWin);
     . Q* w$ A/ J, c, F( `  V
111.       break;
     
112.     case WM_PAINT:
     # R, w3 ?& w( e# j
113.       GUI_SetBkColor(GUI_BLACK);
     * v' {. X; J4 b) A3 [$ h5 t1 k# T
114.       GUI_Clear();
     
115.       GUI_SetColor(GUI_WHITE);
     : |7 G1 Z4 o( Q9 ]) q
116.       GUI_SetFont(&GUI_Font24_ASCII);
     : U) t2 p/ Y& n: V
117.       GUI_DispStringHCenterAt("WIDGET_FrameWin - Sample", 160, 5);
     
118.       GUI_SetFont(&GUI_Font8x16);
     ( e9 y2 R8 ?  L& l
119.       GUI_DispStringHCenterAt(_acMainText, 160, 40);
     
120.       GUI_SetFont(&GUI_Font6x8);
     
121.       GUI_DispStringHCenterAt("The function FRAMEWIN_Create creates both the\n"
     2 {% M8 f1 ]9 Y2 M2 ?# s
122. "frame window and the client window.", 160, 190);
     
123.       break;
     $ x# H5 Z3 b6 C! Z: r
124.     default:
     
125.       WM_DefaultProc(pMsg);
     9 @5 W3 j" N8 Q% Z) P  H# o
126.   }
     
127. }
     . J1 {& p# Z- b0 Z7 d4 t6 G4 Q
128. 
     
129. /*******************************************************************
     : W* {' n2 b7 O9 l
130. *
     / J1 Y# d! N6 \& h: N
131. *       _DemoFramewin
     ) m3 V3 F" l9 v7 s' o
132. *
     
133. * Function description
     
134. *   Creates the frame window and sets the callback for frame, child
     : T6 `$ a' _) P, y" t+ u8 n- P
135. *   and background window
     4 ]6 U  W2 g3 }9 u
136. */
     
137. static void _DemoFramewin(void) {（6）
     
138.   int i;
     
139.   char acInfoText[] = "-- sec to play with window";
     7 z4 X* N& t' o' \% c- h3 l
140.   WM_HWIN hChild;
     * w$ e6 x1 [' v
141. 
     
142. 
     - @0 `; c. ^( }
143.   WM_SetCallback(WM_HBKWIN, _cbBkWindow);
     
144.   //
     9 w5 ~; y) ?/ ~
145.   // Create and configure frame window
     9 n# r' G" e* n7 S# D  E
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）
     3 E. `. z# q0 a: r& @$ X6 e
151.   WM_SetCallback(hChild, _cbChild);（10）
     - m1 G5 E% t2 ?" F- h+ z2 b% A
152.   FRAMEWIN_SetMoveable(_hFrame, 1);（11）
     
153.   //
     
154.   // Create buttons
       T* \. m% k3 K9 ~" K0 o
155.   //
     
156.   FRAMEWIN_AddCloseButton(_hFrame, FRAMEWIN_BUTTON_LEFT, 0);（12）
     9 o$ N# h1 D  M& E1 k0 `) ?( v) r
157.   FRAMEWIN_AddMaxButton(_hFrame, FRAMEWIN_BUTTON_RIGHT, 0);
     2 j* I: i! g2 w/ ?2 q  Y2 z
158.   FRAMEWIN_AddMinButton(_hFrame, FRAMEWIN_BUTTON_RIGHT, 2);
     
159.   //
     ' p8 a" G% s* t2 H; {' @$ |6 v
160.   // Modify frame window attributes
     0 O. b( {2 m7 I3 I+ }
161.   //
     / T  @3 A, G3 _1 ]8 D% f
162.   _ChangeMainText("FRAMEWIN_SetActive", SPEED);
     
163.   FRAMEWIN_SetActive(_hFrame, 1);（13）
     
164.   _ChangeMainText("FRAMEWIN_SetFont", SPEED);
     7 f0 c/ _, h8 i1 D
165.   FRAMEWIN_SetFont(_hFrame, &GUI_Font16B_ASCII); （14）
     0 A+ V% J$ y7 L' n# k5 v1 x
166.   FRAMEWIN_SetTitleHeight(_hFrame, 20);
     
167.   _ChangeMainText("FRAMEWIN_SetTextColor", SPEED);
     
168.   FRAMEWIN_SetTextColor(_hFrame, GUI_YELLOW); （15）
     $ l* r. d; s0 _3 G5 ?0 R
169.   _ChangeMainText("FRAMEWIN_SetTextAlign", SPEED);
     ' z. b: n/ }3 y# Z" C
170.   FRAMEWIN_SetTextAlign(_hFrame, GUI_TA_HCENTER);（16）
     
171.   _ChangeMainText("FRAMEWIN_Minimize", SPEED);
     9 R" O. j1 r. R7 z" j8 M5 {$ x# @
172.   FRAMEWIN_Minimize(_hFrame);（17）
     
173.   _ChangeMainText("FRAMEWIN_Maximize", SPEED);
     # e+ ~8 S! V5 W+ k
174.   FRAMEWIN_Maximize(_hFrame);  （18）
     4 Y# w* \$ m- ?  k- n5 G
175.   _ChangeMainText("FRAMEWIN_Restore", SPEED);
     ! k% c5 `( g& W! ?
176.   FRAMEWIN_Restore(_hFrame);（19）
     & Y4 A8 V' N& |- x" O" \: p- ^
177.   _ChangeMainText("FRAMEWIN_SetTitleVis", SPEED);
     
178.   for (i = 0; i < 5; i++) {
     
179.     FRAMEWIN_SetTitleVis(_hFrame, 0);  （20）
     ) R$ M& a; z5 u- l# \$ z( l( U
180.     GUI_Delay(200);
     
181.     FRAMEWIN_SetTitleVis(_hFrame, 1);
     
182.     GUI_Delay(200);
     2 {; k, |" A. a& L4 J0 v1 L* {
183.   }
     
184.   //
     
185.   // Time to play with frame window
     : v' R2 d+ S0 S6 ~/ R$ i' {
186.   //
     $ v5 J# w5 r7 d# R# h1 C
187.   _LockClose = 0;
     
188.   for (i = 250; (i > 0) && _hFrame; i--) {
     
189.     acInfoText[0] = '0' + ((i + 9) / 100);
     
190.     acInfoText[1] = '0' + (((i + 9) / 10) % 10);
     ; G* x6 x1 U+ h- }! i
191.     _ChangeMainText(acInfoText, 0);
     
192.     GUI_Delay(100);
     
193.   }
     6 C" m/ H0 R& z2 K. E
194.   if (_hFrame) {
     . q( Q  S7 Z# E6 }$ G) ]& r. Y
195.     _ChangeMainText("FRAMEWIN_Delete", SPEED);
     
196.     FRAMEWIN_Delete(_hFrame);（21）
     " M! X. N9 S* B' f
197.   } else {
     & s. G5 O  g7 }) \, F3 j
198.     _ChangeMainText("", 50);
     
199.   }
     , R9 j' S$ V5 ^1 H! e5 Y
200. }
     
201. 
     
202. /*********************************************************************
     
203. *
     
204. *       Public code
     
205. *
     
206. **********************************************************************
     
207. */
     * f- i# s' [3 d  e; ]
208. /*********************************************************************
     * k! w1 m% H# [5 w
209. *
     
210. *       MainTask
     " T5 [2 z5 q$ W
211. */
     
212. void MainTask(void) {
       K2 v. t8 V9 {, I
213.   GUI_Init();
     
214.   WM_EnableMemdev(WM_HBKWIN); （22）
     
215.   while(1) {
     . [- F3 @" p1 o! S
216. _DemoFramewin();
     
217.   }
     2 _1 n  P& p: y- r
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大家都可以试试。

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