【STemWin教程】第44章 FrameWin-框架窗口控件

席萌0209

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

第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>
2. #include <string.h>
3. #include "GUI.h"
4. #include "FRAMEWIN.h"
6. /*********************************************************************
7. *
8. *       Defines
9. *
10. **********************************************************************
11. */
12. #define SPEED   1200
14. #define MSG_CHANGE_MAIN_TEXT (WM_USER + 0) （1）
16. /*********************************************************************
17. *
18. *       Static data
19. *
20. **********************************************************************
21. */
22. static FRAMEWIN_Handle  _hFrame;
23. static WM_CALLBACK*     _pcbOldFrame;
24. static char             _acMainText[100];
25. static int              _LockClose = 1;
27. /*******************************************************************
28. *
29. *       Static code
30. *
31. ********************************************************************
32. */
33. /*******************************************************************
34. *
35. *       _ChangeMainText
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. */
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);
48. }
50. /*******************************************************************
51. *
52. *       _cbChild
53. */
54. static void _cbChild(WM_MESSAGE * pMsg) {（3）
55.   WM_HWIN hWin = (FRAMEWIN_Handle)(pMsg->hWin);
56.   switch (pMsg->MsgId) {
57.   case WM_PAINT:
58.     //
59.     // Handle the paint message
60.     //
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,
68.                             WM_GetWindowSizeY(hWin) / 2);
69.     break;
70.   default:
71.     WM_DefaultProc(pMsg);
72.   }
73. }
75. /*******************************************************************
76. *
77. *       _cbFrame
78. */
79. static void _cbFrame(WM_MESSAGE * pMsg) {  （4）
80.   switch (pMsg->MsgId) {
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) {
85.         if (_LockClose) {
86.           return;
87.         }
88.         _hFrame = 0;
89.       }
90.     }
91.     break;
92.   }
93.   if (_pcbOldFrame) {
94.     (*_pcbOldFrame)(pMsg);
95.   }
96. }
98. /*******************************************************************
99. *
100. *       _cbBkWindow
101. *
102. * Function description
103. *   This callback is necessary to redraw the background when
104. *   frame window is moved
105. */
106. static void _cbBkWindow(WM_MESSAGE * pMsg) {（5）
107.   switch (pMsg->MsgId) {
108.     case MSG_CHANGE_MAIN_TEXT:
109.       strcpy(_acMainText, (char const *)pMsg->Data.p);
110.       WM_InvalidateWindow(pMsg->hWin);
111.       break;
112.     case WM_PAINT:
113.       GUI_SetBkColor(GUI_BLACK);
114.       GUI_Clear();
115.       GUI_SetColor(GUI_WHITE);
116.       GUI_SetFont(&GUI_Font24_ASCII);
117.       GUI_DispStringHCenterAt("WIDGET_FrameWin - Sample", 160, 5);
118.       GUI_SetFont(&GUI_Font8x16);
119.       GUI_DispStringHCenterAt(_acMainText, 160, 40);
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);
123.       break;
124.     default:
125.       WM_DefaultProc(pMsg);
126.   }
127. }
129. /*******************************************************************
130. *
131. *       _DemoFramewin
132. *
133. * Function description
134. *   Creates the frame window and sets the callback for frame, child
135. *   and background window
136. */
137. static void _DemoFramewin(void) {（6）
138.   int i;
139.   char acInfoText[] = "-- sec to play with window";
140.   WM_HWIN hChild;
143.   WM_SetCallback(WM_HBKWIN, _cbBkWindow);
144.   //
145.   // Create and configure frame window
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）
152.   FRAMEWIN_SetMoveable(_hFrame, 1);（11）
153.   //
154.   // Create buttons
155.   //
156.   FRAMEWIN_AddCloseButton(_hFrame, FRAMEWIN_BUTTON_LEFT, 0);（12）
157.   FRAMEWIN_AddMaxButton(_hFrame, FRAMEWIN_BUTTON_RIGHT, 0);
158.   FRAMEWIN_AddMinButton(_hFrame, FRAMEWIN_BUTTON_RIGHT, 2);
159.   //
160.   // Modify frame window attributes
161.   //
162.   _ChangeMainText("FRAMEWIN_SetActive", SPEED);
163.   FRAMEWIN_SetActive(_hFrame, 1);（13）
164.   _ChangeMainText("FRAMEWIN_SetFont", SPEED);
165.   FRAMEWIN_SetFont(_hFrame, &GUI_Font16B_ASCII); （14）
166.   FRAMEWIN_SetTitleHeight(_hFrame, 20);
167.   _ChangeMainText("FRAMEWIN_SetTextColor", SPEED);
168.   FRAMEWIN_SetTextColor(_hFrame, GUI_YELLOW); （15）
169.   _ChangeMainText("FRAMEWIN_SetTextAlign", SPEED);
170.   FRAMEWIN_SetTextAlign(_hFrame, GUI_TA_HCENTER);（16）
171.   _ChangeMainText("FRAMEWIN_Minimize", SPEED);
172.   FRAMEWIN_Minimize(_hFrame);（17）
173.   _ChangeMainText("FRAMEWIN_Maximize", SPEED);
174.   FRAMEWIN_Maximize(_hFrame);  （18）
175.   _ChangeMainText("FRAMEWIN_Restore", SPEED);
176.   FRAMEWIN_Restore(_hFrame);（19）
177.   _ChangeMainText("FRAMEWIN_SetTitleVis", SPEED);
178.   for (i = 0; i < 5; i++) {
179.     FRAMEWIN_SetTitleVis(_hFrame, 0);  （20）
180.     GUI_Delay(200);
181.     FRAMEWIN_SetTitleVis(_hFrame, 1);
182.     GUI_Delay(200);
183.   }
184.   //
185.   // Time to play with frame window
186.   //
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);
191.     _ChangeMainText(acInfoText, 0);
192.     GUI_Delay(100);
193.   }
194.   if (_hFrame) {
195.     _ChangeMainText("FRAMEWIN_Delete", SPEED);
196.     FRAMEWIN_Delete(_hFrame);（21）
197.   } else {
198.     _ChangeMainText("", 50);
199.   }
200. }
202. /*********************************************************************
203. *
204. *       Public code
205. *
206. **********************************************************************
207. */
208. /*********************************************************************
209. *
210. *       MainTask
211. */
212. void MainTask(void) {
213.   GUI_Init();
214.   WM_EnableMemdev(WM_HBKWIN); （22）
215.   while(1) {
216. _DemoFramewin();
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大家都可以试试。