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

第44章 FrameWin-框架窗口控件

% S' o- B# N7 S6 K9 h4 y. v

    本期教程讲解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>
   
3. #include "GUI.h"
   : i* a# G) R6 I
4. #include "FRAMEWIN.h"
   
5. 
   
6. /*********************************************************************
   7 H2 f; q7 }; m4 f' W$ G& v- j0 |
7. *
   
8. *       Defines
   + a, ?- x+ T* J( u: r8 c3 d
9. *
   2 v3 b5 C+ j0 c$ q0 W! y9 m
10. **********************************************************************
    
11. */
    
12. #define SPEED   1200
    , r/ Z1 \0 V" ~8 M  h$ O
13. 
    + @1 T* O# X- J+ `- ?
14. #define MSG_CHANGE_MAIN_TEXT (WM_USER + 0) （1）
    
15. 
    
16. /*********************************************************************
    9 A7 J$ u: D" O) u! l
17. *
    
18. *       Static data
    . x5 y# U+ ?, z6 g0 T9 C
19. *
    
20. **********************************************************************
    9 O; Q8 ~3 L' S: {
21. */
    
22. static FRAMEWIN_Handle  _hFrame;
    
23. static WM_CALLBACK*     _pcbOldFrame;
    
24. static char             _acMainText[100];
    
25. static int              _LockClose = 1;
    6 o- `; {5 i) k% O+ [7 F  `
26. 
    " y; o) i, z6 P
27. /*******************************************************************
    
28. *
    0 K0 _7 ?+ F. @. ?8 ]; R
29. *       Static code
    $ b5 @1 ~- H* F9 {7 h  D  Y
30. *
    ( u/ Z7 X$ t' y6 V7 T9 i
31. ********************************************************************
    0 }5 C3 [; K' r, v
32. */
    2 n  ^: f6 W% T5 C& R6 s1 ^
33. /*******************************************************************
      Q/ m/ X1 x1 k5 I
34. *
    
35. *       _ChangeMainText
    
36. *
    0 E7 Z0 g8 d% j: O. R
37. *  Sends a message to the background window and invalidate it, so
    % `% ~! Z: S  F. \/ d* B
38. *  the callback of the background window display the new text.
    / n& z7 M$ \$ }2 V+ R4 x( y9 ]
39. */
    
40. static void _ChangeMainText(char* pStr, int Delay) {（2）
    
41.   WM_MESSAGE Message;
    
42.   Message.MsgId  = MSG_CHANGE_MAIN_TEXT;
    
43.   Message.Data.p = pStr;
    
44.   GUI_Delay(Delay);
    
45.   WM_SendMessage(WM_HBKWIN, &Message);
    
46.   WM_InvalidateWindow(WM_HBKWIN);
    
47.   GUI_Delay(Delay/3);
    4 x0 M8 \2 \+ U( l3 _0 ?
48. }
    
49. 
    ! H* p; [* n3 t/ R4 c
50. /*******************************************************************
    , B0 h6 a( R% p( \( h6 q
51. *
    1 |0 K+ i% c, u2 B7 m
52. *       _cbChild
    % i' R" r8 y% _* j8 T3 M  f& B
53. */
    
54. static void _cbChild(WM_MESSAGE * pMsg) {（3）
    5 o6 ^% `- G5 f2 g0 m; m4 d, ^
55.   WM_HWIN hWin = (FRAMEWIN_Handle)(pMsg->hWin);
    
56.   switch (pMsg->MsgId) {
    
57.   case WM_PAINT:
    " x/ n" Z. q" h  j) F; H8 c2 D" N/ b
58.     //
    : Y' O' b' D1 B" j0 p
59.     // Handle the paint message
    / M$ H6 e) N8 `4 Z7 s! ]
60.     //
    ; G) t; `, R, H
61.     GUI_SetBkColor(GUI_WHITE);
    
62.     GUI_SetColor(GUI_BLACK);
    9 q5 f5 [7 q3 r0 H
63.     GUI_SetFont(&GUI_FontComic24B_ASCII);
    
64.     GUI_SetTextAlign(GUI_TA_HCENTER | GUI_TA_VCENTER);
    & m7 S: }; L" ?
65.     GUI_Clear();
    5 A6 |$ Q% r% F1 S
66.     GUI_DispStringHCenterAt("Client window",
    4 r) N6 f4 c, |9 e" n
67.                             WM_GetWindowSizeX(hWin) / 2,
    * u( U0 H! R4 @* J, j
68.                             WM_GetWindowSizeY(hWin) / 2);
    
69.     break;
    
70.   default:
    / ]) f  U8 O  s& \) b
71.     WM_DefaultProc(pMsg);
    % Z# t. M1 ?) x* i& W5 n( ]$ R0 h
72.   }
    
73. }
    ( g$ q% z9 q7 Q* X- U1 _. ^
74. 
    2 \! E: n' J" j9 R
75. /*******************************************************************
    
76. *
    2 h8 e; ?( S+ W4 v  N
77. *       _cbFrame
    ) B1 |8 R6 K" I. n
78. */
    " }# J( E; X5 M4 u
79. static void _cbFrame(WM_MESSAGE * pMsg) {  （4）
    & j' ~3 z4 |# D7 P1 p  i
80.   switch (pMsg->MsgId) {
    
81.   case WM_NOTIFY_PARENT:
    
82.     if (pMsg->Data.v == WM_NOTIFICATION_RELEASED) {
    % E& ~+ j  Z) \1 f& [9 k4 T
83.       int Id = WM_GetId(pMsg->hWinSrc);      // Id of widget
    
84.       if (Id == GUI_ID_CLOSE) {
    
85.         if (_LockClose) {
    * z. X$ m$ j, V# _# I' v
86.           return;
    5 d) k/ z$ J5 L* g1 v
87.         }
    
88.         _hFrame = 0;
    ! o" X4 O5 }# B9 Q
89.       }
    # T7 L- c. E# {
90.     }
    6 Q( r; R( @" J) a! y
91.     break;
    
92.   }
    
93.   if (_pcbOldFrame) {
    # p# d. h& A! C
94.     (*_pcbOldFrame)(pMsg);
    
95.   }
    
96. }
    
97. 
    . r8 V3 m) K8 g( I2 L
98. /*******************************************************************
    # W4 F4 d: S- X4 D3 q
99. *
    0 y0 D3 V8 ?5 U9 A: u
100. *       _cbBkWindow
     , o  h, b& r7 d5 C9 }  g: t( ]5 \5 a
101. *
     
102. * Function description
     1 ]# j& p* u6 x( t4 L# D
103. *   This callback is necessary to redraw the background when
     ; m. g- l1 F. g& p
104. *   frame window is moved
     8 t: l# Q  x  o$ j( d( s3 A
105. */
     5 \' J8 D) u* K
106. static void _cbBkWindow(WM_MESSAGE * pMsg) {（5）
     + J5 s4 X0 }: N9 X3 [7 D! z
107.   switch (pMsg->MsgId) {
     
108.     case MSG_CHANGE_MAIN_TEXT:
     
109.       strcpy(_acMainText, (char const *)pMsg->Data.p);
     " J& O2 |8 B! J4 j
110.       WM_InvalidateWindow(pMsg->hWin);
     
111.       break;
     
112.     case WM_PAINT:
     / J* }# x" {) g, q1 U- e
113.       GUI_SetBkColor(GUI_BLACK);
     
114.       GUI_Clear();
     ; @" D7 ~) I+ C5 t+ g7 @
115.       GUI_SetColor(GUI_WHITE);
     
116.       GUI_SetFont(&GUI_Font24_ASCII);
     
117.       GUI_DispStringHCenterAt("WIDGET_FrameWin - Sample", 160, 5);
     
118.       GUI_SetFont(&GUI_Font8x16);
     6 [* M3 {' s5 {9 o6 B$ e
119.       GUI_DispStringHCenterAt(_acMainText, 160, 40);
     1 O$ }; w, P% o( ?2 a- @- f4 N. k. p
120.       GUI_SetFont(&GUI_Font6x8);
     4 ^& e& q/ {( K4 R6 f6 L
121.       GUI_DispStringHCenterAt("The function FRAMEWIN_Create creates both the\n"
     : d& |4 c/ `8 ~- |- ]) e' P
122. "frame window and the client window.", 160, 190);
     4 b5 J2 h4 s) ]! _: Q- p. ~6 i6 M
123.       break;
     
124.     default:
     
125.       WM_DefaultProc(pMsg);
     7 o$ b' V4 d8 C% o) F
126.   }
     6 E) [) g. P) D7 c6 I2 W: D1 L
127. }
     
128. 
     ) C1 C9 \5 x- S2 `! N
129. /*******************************************************************
     : e4 k; ], Y: Q$ g: f/ i$ z
130. *
     . M8 d7 _# }2 D) j
131. *       _DemoFramewin
     7 H1 B5 R$ ~  h3 f/ \5 |# b( `% C+ ?
132. *
     : ?* E) N' k* ?  F
133. * Function description
     
134. *   Creates the frame window and sets the callback for frame, child
     ) E& Q& \: M& w5 o6 k
135. *   and background window
     
136. */
     
137. static void _DemoFramewin(void) {（6）
     ( y* b. n9 u( ?9 \- I
138.   int i;
     - O3 ]. V' [/ ]( e7 ?3 c" F
139.   char acInfoText[] = "-- sec to play with window";
     
140.   WM_HWIN hChild;
     ; q9 d' Q' d  P/ d5 F2 T( y4 t
141. 
     
142. 
     
143.   WM_SetCallback(WM_HBKWIN, _cbBkWindow);
     7 M2 M, P. K- g2 k7 }+ X, b
144.   //
     6 o- N  N  ^' F1 p; o) ^
145.   // Create and configure frame window
     
146.   //
     0 N) i: s! P3 n6 \2 B# G. b/ c
147.   _ChangeMainText("FRAMEWIN_Create", SPEED);
     $ D. y; r+ G" N/ J, @
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）
     
152.   FRAMEWIN_SetMoveable(_hFrame, 1);（11）
     1 }7 i' g1 W3 y: r% y- w
153.   //
     3 b2 g, W, J; X' i
154.   // Create buttons
     
155.   //
     - M2 e1 q8 n, `2 h' n* D
156.   FRAMEWIN_AddCloseButton(_hFrame, FRAMEWIN_BUTTON_LEFT, 0);（12）
     
157.   FRAMEWIN_AddMaxButton(_hFrame, FRAMEWIN_BUTTON_RIGHT, 0);
     3 w1 e' \: u7 D* f8 B
158.   FRAMEWIN_AddMinButton(_hFrame, FRAMEWIN_BUTTON_RIGHT, 2);
     ; C* l1 q: m( C- I/ I
159.   //
     
160.   // Modify frame window attributes
     
161.   //
     $ k$ ^; X; s* l8 G
162.   _ChangeMainText("FRAMEWIN_SetActive", SPEED);
     
163.   FRAMEWIN_SetActive(_hFrame, 1);（13）
     8 w4 E; G* t4 o* V+ f6 t& y- M  `; s
164.   _ChangeMainText("FRAMEWIN_SetFont", SPEED);
     1 A' p3 Y2 d3 S8 s+ U4 ^: S' j! e
165.   FRAMEWIN_SetFont(_hFrame, &GUI_Font16B_ASCII); （14）
     ) g$ E+ H, t7 ^
166.   FRAMEWIN_SetTitleHeight(_hFrame, 20);
     % o3 j% t- Q9 d6 t+ Y( z2 N+ B
167.   _ChangeMainText("FRAMEWIN_SetTextColor", SPEED);
     
168.   FRAMEWIN_SetTextColor(_hFrame, GUI_YELLOW); （15）
     % u' a/ Q4 @2 g
169.   _ChangeMainText("FRAMEWIN_SetTextAlign", SPEED);
     + o& \& G& o- q$ v& I" X
170.   FRAMEWIN_SetTextAlign(_hFrame, GUI_TA_HCENTER);（16）
     
171.   _ChangeMainText("FRAMEWIN_Minimize", SPEED);
     - ~5 ^' O- H. @; m. o
172.   FRAMEWIN_Minimize(_hFrame);（17）
     
173.   _ChangeMainText("FRAMEWIN_Maximize", SPEED);
     " K6 l& d% U. }
174.   FRAMEWIN_Maximize(_hFrame);  （18）
     1 R# O9 ]% c$ m9 }/ Q
175.   _ChangeMainText("FRAMEWIN_Restore", SPEED);
     
176.   FRAMEWIN_Restore(_hFrame);（19）
     
177.   _ChangeMainText("FRAMEWIN_SetTitleVis", SPEED);
     ! d% R% x: ~/ [# o* ?7 K2 _% x
178.   for (i = 0; i < 5; i++) {
     / H4 S4 y+ z2 H1 X; h% I* q
179.     FRAMEWIN_SetTitleVis(_hFrame, 0);  （20）
     
180.     GUI_Delay(200);
     
181.     FRAMEWIN_SetTitleVis(_hFrame, 1);
     " o; @5 |; A6 a# v2 o
182.     GUI_Delay(200);
       W- j* h! H/ H
183.   }
     
184.   //
     
185.   // Time to play with frame window
     
186.   //
     % l/ V: t; ]5 ?1 y! S
187.   _LockClose = 0;
     : w6 M+ [9 c+ J! s0 [  [
188.   for (i = 250; (i > 0) && _hFrame; i--) {
     
189.     acInfoText[0] = '0' + ((i + 9) / 100);
     1 a* B: E0 B$ h8 e( i  |
190.     acInfoText[1] = '0' + (((i + 9) / 10) % 10);
     
191.     _ChangeMainText(acInfoText, 0);
     
192.     GUI_Delay(100);
     ; a4 g$ i# p- |
193.   }
     + a' x5 ^  g4 e. x% G8 C
194.   if (_hFrame) {
     
195.     _ChangeMainText("FRAMEWIN_Delete", SPEED);
     7 n& B8 o+ p& W7 v1 D
196.     FRAMEWIN_Delete(_hFrame);（21）
     2 X6 X" r9 p' e; D6 a3 I3 M" z* C9 _
197.   } else {
     9 q' O1 i# A7 w( H8 `9 D
198.     _ChangeMainText("", 50);
       K, K6 {$ B6 e' q: W7 V
199.   }
     ! L* Q  C- x- Z1 G/ U2 o3 O
200. }
     
201. 
     
202. /*********************************************************************
     
203. *
     / \# ]+ d9 c) j2 A4 v9 H
204. *       Public code
     
205. *
     ( ^* e. ?% g* t6 r- f$ p+ F
206. **********************************************************************
     ( Q# E. a- A, _* {: a2 @" t) }+ p3 U1 e
207. */
     # T# J4 M- ~* I' x, j1 Q0 y
208. /*********************************************************************
     * d6 B& d7 z* R1 t& F( w' F! |
209. *
     
210. *       MainTask
     " B# W- B+ N5 P; `0 W; h+ i
211. */
     5 c% s; `) ~. w
212. void MainTask(void) {
     
213.   GUI_Init();
     $ Z# l1 _) y* w% g
214.   WM_EnableMemdev(WM_HBKWIN); （22）
     
215.   while(1) {
     
216. _DemoFramewin();
     : w1 ^% v' ^% f
217.   }
     
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大家都可以试试。

0 {  y) F6 k! _& }

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