【emWin实战教程V2.0】第38章 窗口管理器官方

席萌0209

完整65章+12章附件教程下载地址：
http://www.armbbs.cn/forum.php?mod=viewthread&tid=19834




第38章      窗口管理器官方实例简单讲解


    为了帮助大家更好的理解窗口管理器的回调和消息机制，官方也提供了好几个这方面的例子，本章节我们将官方这几个例子也跟大家进行简单讲解，进一步帮助大家更好的学习窗口管理器。
38.1 初学者重要提示
38.2 官方WM_Redraw.c实例讲解
38.3  官方WM_Sample.c实例讲解（含大量窗口API操作）
38.4 官方WM_LateClipping.c实例讲解
38.5 官方WM_Video.c实例讲解
38.6 总结

席萌0209

38.1  初学者重要提示


u  通过实例来学习emWin是最佳的学习捷径。
u  本章节讲解的例子中用到的部分功能还没有讲解到，但是不影响大家学习窗口管理器相关的知识。没有讲解到的知识基本都会在后面章节中跟大家讲解。
u  窗口管理器这块的API函数应该是emWin手册所有章节中函数最多的，以后需要用到什么功能了，查询就行，或者看官方的实例，哪个函数不理解了也可以查手册。下图是中文版手册里面API函数位置：

下图是英文版手册里面API函数的位置：

席萌0209

38.2 官方WM_Redraw.c实例讲解


        这个DEMO在模拟器中的位置：

主要功能介绍：
        这个例子与第37章37.3小节中的例子相似，分别演示桌面窗口配置了重绘操作和不配置重绘操作下，移动窗口的效果。其实不光在桌面窗口上面移动窗口要重绘，其它创建的窗口上面移动是一样的，也需要设置重绘。如果用户新窗口的窗口回调函数里面没有写重绘消息WM_PAINT，窗口管理器就会按照系统默认的颜色的进行重绘，如果用户写了WM_PAINT消息就会按照用户设置的进行重绘。
下面我们将这个代码分析一下：

1. #include "GUI.h"
2. #include "WM.h"
4. /*********************************************************************
5. *
6. *       Defines
7. *
8. **********************************************************************
9. */
10. //
11. // Recommended memory to run the sample with adequate performance
12. //
13. #define RECOMMENDED_MEMORY (1024L * 5)
15. /*******************************************************************
16. *
17. *       static code
18. *
19. ********************************************************************
20. */
21. /*******************************************************************
22. *
23. *       _cbBkWindow
24. */
25. static void _cbBkWindow(WM_MESSAGE* pMsg) {      //--------------（1）
26.   switch (pMsg->MsgId) {
27.   case WM_PAINT:
28.     GUI_ClearRect(0, 50, 319, 239); //--------------（2）
29.   default:
30.     WM_DefaultProc(pMsg);
31.   }
32. }
34. /*******************************************************************
35. *
36. *       _cbWindow
37. */
38. static void _cbWindow(WM_MESSAGE* pMsg) {  //--------------（3）
39.   GUI_RECT Rect;
41.   switch (pMsg->MsgId) {
42.   case WM_PAINT:
43.     WM_GetInsideRect(&Rect); //--------------（4）
44.     GUI_SetBkColor(GUI_RED);
45.     GUI_SetColor(GUI_YELLOW);
46.     GUI_ClearRectEx(&Rect); //--------------（5）
47.     GUI_DrawRectEx(&Rect);
48.     GUI_SetColor(GUI_BLACK);
49.     GUI_SetFont(&GUI_Font8x16);
50.     GUI_DispStringHCenterAt("Foreground window", 75, 40);
51.     break;
52.   default:
53.     WM_DefaultProc(pMsg);
54.   }
55. }
57. /*******************************************************************
58. *
59. *       _MoveWindow
60. */
61. static void _MoveWindow(const char* pText) {
62.   WM_HWIN hWnd;
63.   int     i;
65.   //
66.   // Create foreground window
67.   //
68.   hWnd = WM_CreateWindow(10, 50, 150, 100, WM_CF_SHOW, _cbWindow, 0); //--------------（6）
69.   GUI_Delay(500);
70.   //
71.   // Move foreground window
72.   //
73.   for (i = 0; i < 40; i++) {
74.     WM_MoveWindow(hWnd, 2, 2); //--------------（7）
75.     GUI_Delay(10);
76.   }
77.   //
78.   // Show text before deleting window if we have one
79.   //
80.   if (pText) {
81.     GUI_DispStringAt(pText, 5, 50);
82.     GUI_Delay(2500);
83.   }
84.   //
85.   // Delete foreground window
86.   //
87.   WM_DeleteWindow(hWnd); //--------------（8）
88.   WM_Invalidate(WM_HBKWIN); //--------------（9）
89.   GUI_Exec();
90. }
92. /*******************************************************************
93. *
94. *       _DemoRedraw
95. */
96. static void _DemoRedraw(void) {
97.   WM_CALLBACK * _cbOldBk;
99.   GUI_SetBkColor(GUI_BLACK);
100.   GUI_Clear();
101.   GUI_SetColor(GUI_WHITE);
102.   GUI_SetFont(&GUI_Font24_ASCII);
103.   GUI_DispStringHCenterAt("WM_Redraw - Sample", 160, 5);
104.   GUI_SetFont(&GUI_Font8x16);
105.   while(1) {
106.     //
107.     // Move a window over background
108.     //
109.     _MoveWindow("Background has not been redrawn");  //--------------（10）
110.     //
111.     // Clear background
112.     //
113.     GUI_ClearRect(0, 50, 319, 239);
114.     GUI_Delay(1000);
115.     //
116.     // Set callback for background window
117.     //
118.     _cbOldBk = WM_SetCallback(WM_HBKWIN, _cbBkWindow); //--------------（11）
119.     //
120.     // Move a window over background
121.     //
122.     _MoveWindow("Background has been redrawn");
123.     //
124.     // Delete callback for Background window
125.     //
126.     WM_SetCallback(WM_HBKWIN, _cbOldBk); //--------------（12）
127.   }
128. }
130. /*********************************************************************
131. *
132. *       Public code
133. *
134. **********************************************************************
135. */
136. /*********************************************************************
137. *
138. *       MainTask
139. */
140. void MainTask(void) {
141.   GUI_Init();
142.   //
143.   // Check if recommended memory for the sample is available
144.   //
145.   if (GUI_ALLOC_GetNumFreeBytes() < RECOMMENDED_MEMORY) {
146.     GUI_ErrorOut("Not enough memory available.");
147.     return;
148.   }
149.   _DemoRedraw();
150. }

复制代码

1.     桌面窗口回调函数。
2.     在桌面窗口回调函数的WM_PAINT消息中刷一块矩形区域。
3.     另外一个新创建窗口的回调函数。
4.     函数WM_GetInsideRect返回客户区的坐标，即实际可供用户使用的显示区。
5.     调用函数GUI_ClearRectEx清屏一块矩形区。
6.     函数WM_CreateWindow用来创建一个窗口，其中每个参数的含义需要大家详细研究官方手册，这里就不做解释了。
7.     通过函数WM_MoveWindow()实现窗口位置的移动，注意这里移动的是相对距离。
8.     删除创建的窗口。
9.     通过函数WM_Invalidate(WM_HBKWIN)使得桌面窗口无效，然后调用函数GUI_Exec()就会通过窗口管理给桌面窗口回调函数发送WM_PAINT消息，从而执行重绘。
10.  执行第一种情况：移动窗口，但是不做桌面窗口的重绘。
11.  给桌面窗口设置专门的回调函数。
12.  执行第二种情况：移动窗口，并执行桌面窗口的重绘。
        这个实例主要演示了两种情况，一种是演示：移动窗口的情况下，但是不做桌面窗口的重绘。另一种是：移动窗口，并执行桌面窗口的重绘。通过这两种情况的演示可以帮助大家对回调函数有一个更好的认识。
第一种情况：没有执行桌面回调函数的显示效果

第二种情况：执行桌面回调函数的显示效果

席萌0209

38.3   官方WM_Sample.c实例讲解（含大量窗口API操作）


        这个DEMO在模拟器中的位置：

主要功能介绍：
        这个例子最主要的特点是将大部分窗口管理器的API函数都进行了调用，方便用户查看演示效果。如果那个函数不太会使用了，看这个例子也是比较方便。
下面我们将这个代码分析一下，这里捡几个重要的部分跟大家讲解一下：

38.3.1   桌面窗口回调函数自定义消息的使用

1. #define MSG_CHANGE_TEXT     (WM_USER + 0) //--------------（1）
3. /*******************************************************************
4. *
5. *       _ChangeInfoText
6. *
7. * Function description
8. *   Sends a message to the background window and invalidate it, so
9. *   the callback of the background window display the new text.
10. */
11. static void _ChangeInfoText(char * pStr) { //--------------（2）
12.   WM_MESSAGE Message;
14.   Message.MsgId  = MSG_CHANGE_TEXT;
15.   Message.Data.p = pStr;
16.   WM_SendMessage(WM_HBKWIN, &Message);
17.   WM_InvalidateWindow(WM_HBKWIN);
18. }
20. /*******************************************************************
21. *
22. *       _DrawInfoText
23. *
24. * Function description
25. *   Drawes the info text directly on the display. This function is for
26. *   the moments when no callback is set.
27. */
28. static void _DrawInfoText(char * pStr) { //--------------（3）
29.   GUI_SetColor(GUI_WHITE);
30.   GUI_SetFont(&GUI_Font24_ASCII);
31.   GUI_DispStringHCenterAt("WindowManager - Sample", 160, 5);
32.   GUI_SetFont(&GUI_Font8x16);
33.   GUI_DispStringAtCEOL(pStr, 5, 40);
34. }
36. /*******************************************************************
37. *
38. *       _cbBkWindow
39. */
40. static void _cbBkWindow(WM_MESSAGE * pMsg) {
41.   switch (pMsg->MsgId) {
42.   case MSG_CHANGE_TEXT: //--------------（4）
43.     strcpy(_acInfoText, (char const *)pMsg->Data.p); //--------------（5）
44.   case WM_PAINT:        //--------------（6）
45.     GUI_SetBkColor(GUI_BLACK);
46.     GUI_Clear();
47.     GUI_SetColor(GUI_WHITE);
48.     GUI_SetFont(&GUI_Font24_ASCII);
49.     GUI_DispStringHCenterAt("WindowManager - Sample", 160, 5);
50.     GUI_SetFont(&GUI_Font8x16);
51.     GUI_DispStringAt(_acInfoText, 5, 40);
52.     break;
53.   default:
54.     WM_DefaultProc(pMsg);
55.   }
56. }

复制代码

这部分代码主要学习消息发送函数WM_SendMessage的使用，第37章的37.2小节学习了无参数的消息发送函数WM_SendMessageNoPara，而函数WM_SendMessage是带参数的。
1.     用户自定义的消息ID，使用的时候一定要以WM_USER作为起始值，防止跟系统其他的数值冲突。如果还要实现其它自定义消息，在这个数值的基础上面定义即可。

2.    通过用户自定义的消息实现给桌面窗口的回调函数发送数据。调用了函数WM_SendMessage(WM_HBKWIN, &Message)后会给桌面窗口的回调函数发送数据，再调用了函数WM_Invalidate(WM_HBKWIN)使得桌面窗口无效，然后调用函数GUI_Delay()就会通过窗口管理给桌面窗口回调函数发送WM_PAINT消息，从而执行重绘。

3.     文本显示函数。
4.     用户自定义消息ID。
5.     字符串复制，将Data.p中的数据复制到_acInfoText中。
6.     在WM_PAINT消息中显示文本acInfoText。

38.3.2   Redrawing部分演示

1. /*******************************************************************
2. *
3. *       _LiftUp
4. */
5. static void _LiftUp(int dy) {//--------------（1）
6.   int i;
7.   int tm;
9.   for (i = 0; i < (dy/4); i++) {
10.     tm = GUI_GetTime();
11.     WM_MoveWindow(_hWindow1, 0, -4);
12.     WM_MoveWindow(_hWindow2, 0, -4);
13.     while ((GUI_GetTime() - tm) < 20) {
14.       WM_Exec();
15.     }
16.   }
17. }
19. /*******************************************************************
20. *
21. *       _LiftDown
22. */
23. static void _LiftDown(int dy) { //--------------（2）
24.   int i;
25.   int tm;
27.   for (i = 0; i < (dy/4); i++) {
28.     tm = GUI_GetTime();
29.     WM_MoveWindow(_hWindow1, 0, 4);
30.     WM_MoveWindow(_hWindow2, 0, 4);
31.     while ((GUI_GetTime() - tm) < 20) {
32.       WM_Exec();
33.     }
34.   }
35. }
37. /*******************************************************************
38. *
39. *       _DemoRedrawing
40. *
41. * Function description
42. *   Demonstrates how useful can be a callback
43. */
44. static void _DemoRedrawing(void) {
45.   int i;
46.   int tm;
47.   int tDiff;
49.   _ChangeInfoText("Demonstrating redrawing");
50.   GUI_Delay(SPEED);
51.   _LiftUp(40);
52.   GUI_Delay(SPEED/3);
53.   _ChangeInfoText("Using a callback for redrawing");
54.   GUI_Delay(SPEED/3);
55.   for (i = 0; i < 55; i++) {
56.     tm = GUI_GetTime();
57.     WM_MoveWindow(_hWindow1,  1,  1);
58.     WM_MoveWindow(_hWindow2, -1, -1);
59.     tDiff = 15 - (GUI_GetTime() - tm);
60.     GUI_Delay(tDiff);
61.   }
62.   for (i = 0; i < 55; i++) {
63.     tm = GUI_GetTime();
64.     WM_MoveWindow(_hWindow1, -1, -1);
65.     WM_MoveWindow(_hWindow2,  1,  1);
66.     tDiff = 15 - (GUI_GetTime() - tm);
67.     GUI_Delay(tDiff);
68.   }
69.   GUI_Delay(SPEED/4);
70.   _LiftDown(30);
71.   GUI_Delay(SPEED/2);
72.   _ChangeInfoText("Without redrawing");
73.   GUI_Delay(SPEED);
74.   _LiftUp(30);
75.   GUI_Delay(SPEED/4);
76.   WM_SetCallback(WM_HBKWIN, _cbBkWindowOld);
77.   for (i = 0; i < 55; i++) {
78.     tm = GUI_GetTime();
79.     WM_MoveWindow(_hWindow1,  1,  1);
80.     WM_MoveWindow(_hWindow2, -1, -1);
81.     tDiff = 15 - (GUI_GetTime() - tm);
82.     GUI_Delay(tDiff);
83.   }
84.   for (i = 0; i < 55; i++) {
85.     tm = GUI_GetTime();
86.     WM_MoveWindow(_hWindow1, -1, -1);
87.     WM_MoveWindow(_hWindow2,  1,  1);
88.     tDiff = 15 - (GUI_GetTime() - tm);
89.     GUI_Delay(tDiff);
90.   }
91.   GUI_Delay(SPEED/3);
92.   WM_SetCallback(WM_HBKWIN, _cbBkWindow);
93.   _LiftDown(40);
94.   GUI_Delay(SPEED);
95. }

复制代码

这部分代码实现了两个窗口在具有重绘和不具有重绘功能时的演示，还有一个重点是学习窗口移动函数WM_MoveWindow的使用，这个函数是实现相对移动，相对于窗口当前所在的位置。另外还一个窗口移动函数WM_MoveTo是绝对位置移动，设置移动到那个坐标点就移动到那个坐标点。
1.     实现两个窗口向上移动。
2.     实现两个窗口向下移动。
显示效果如下：

38.3.3   Resize部分演示

1. /*******************************************************************
2. *
3. *       _DemoResizeWindow
4. *
5. * Function description
6. *   Demonstrates the use of WM_ResizeWindow
7. */
8. static void _DemoResizeWindow(void) {
9.   int i;
10.   int tm;
11.   int tDiff;
13.   _ChangeInfoText("WM_ResizeWindow()");
14.   GUI_Delay(SPEED);
15.   _LiftUp(30);
16.   for (i = 0; i < 20; i++) {
17.     tm = GUI_GetTime();
18.     WM_ResizeWindow(_hWindow1,  1,  1);
19.     WM_ResizeWindow(_hWindow2, -1, -1);
20.     tDiff = 15 - (GUI_GetTime() - tm);
21.     GUI_Delay(tDiff);
22.   }
23.   for (i = 0; i < 40; i++) {
24.     tm = GUI_GetTime();
25.     WM_ResizeWindow(_hWindow1, -1, -1);
26.     WM_ResizeWindow(_hWindow2,  1,  1);
27.     tDiff = 15 - (GUI_GetTime() - tm);
28.     GUI_Delay(tDiff);
29.   }
30.   for (i = 0; i < 20; i++) {
31.     tm = GUI_GetTime();
32.     WM_ResizeWindow(_hWindow1,  1,  1);
33.     WM_ResizeWindow(_hWindow2, -1, -1);
34.     tDiff = 15 - (GUI_GetTime() - tm);
35.     GUI_Delay(tDiff);
36.   }
37.   _LiftDown(30);
38.   GUI_Delay(SPEED);
39. }

复制代码

这部分演示主要看窗口加大和减小函数WM_ResizeWindow()的使用，注意这个函数是对窗口的显示大小进行加大和减小，并不是进行放缩，显示效果如下：

席萌0209

38.4官方WM_LateClipping.c实例讲解


        这个DEMO在模拟器中的位置：

主要功能介绍：
     这个例子依然主要演示回调函数的重绘机制，作为重绘机制方面的学习，比较有参考价值。
下面我们将这个代码分析一下：

1. #include "GUI.h"
2. #include "WM.h"
3. #include "FRAMEWIN.h"
4. #include "BUTTON.h"
6. /*********************************************************************
7. *
8. *       Defines
9. *
10. **********************************************************************
11. */
12. //
13. // Recommended memory to run the sample with adequate performance
14. //
15. #define RECOMMENDED_MEMORY (1024L * 5)
17. /*********************************************************************
18. *
19. *       Static data
20. *
21. **********************************************************************
22. */
23. static WM_HWIN _hWin1;
24. static WM_HWIN _hWin2;
25. static WM_HWIN _hBut1;
26. static WM_HWIN _hBut2;
27. static int     _PaintCount1;
28. static int     _PaintCount2;
30. static GUI_COLOR _aColors[] = {
31.   0x0000FF, 0x00FF00, 0xFF0000, 0x00FFFF, 0xA000A0, 0xFFFF00
32. };
34. /*********************************************************************
35. *
36. *       Static code
37. *
38. **********************************************************************
39. */
40. /*********************************************************************
41. *
42. *       _cbBkWin
43. */
44. static void _cbBkWin(WM_MESSAGE* pMsg) { //--------------（1）
45.   switch(pMsg->MsgId) {
46.   case WM_PAINT:     //--------------（2）
47.     GUI_SetBkColor(GUI_BLACK);
48.     GUI_Clear();
49.     GUI_SetColor(0x0060FF);
50.     GUI_DispStringAt("PaintCount (Early):", 0, 0);
51.     GUI_DispDecAt(_PaintCount1, 120, 0, 5);
52.     GUI_SetColor(0x00FFC0);
53.     GUI_DispStringAt("PaintCount (Late):", 0, 12);
54.     GUI_DispDecAt(_PaintCount2, 120, 12, 5);
55.     break;
56.   case WM_NOTIFY_PARENT:
57.     if (pMsg->Data.v == WM_NOTIFICATION_RELEASED) {
58.       if (pMsg->hWinSrc == _hBut1) { //--------------（3）
59.         WM_InvalidateWindow(_hWin1);
60.         WM_InvalidateWindow(_hWin2);
61.       } else if (pMsg->hWinSrc == _hBut2) { //--------------（4）
62.         _PaintCount1 = 0;
63.         _PaintCount2 = 0;
64.         WM_InvalidateWindow(pMsg->hWin);
65.       }
66.     }
67.     break;
68.   default:
69.     WM_DefaultProc(pMsg);
70.   }
71. }
73. /*********************************************************************
74. *
75. *       _cbTop
76. */
77. static void _cbTop(WM_MESSAGE* pMsg) { //--------------（5）
78.   switch(pMsg->MsgId) {
79.   case WM_PAINT:
80.     GUI_SetBkColor(GUI_MAGENTA);
81.     GUI_Clear();
82.     break;
83.   default:
84.     WM_DefaultProc(pMsg);
85.   }
86. }
88. /*********************************************************************
89. *
90. *       _cbFrameWin1
91. */
92. static void _cbFrameWin1(WM_MESSAGE* pMsg) { //--------------（6）
93.   switch(pMsg->MsgId) {
94.   case WM_PAINT:
95.     GUI_SetBkColor(_aColors[_PaintCount1 % 6]);
96.     GUI_Clear();
97.     GUI_SetColor(0x0060FF);
98.     GUI_FillCircle(25, 25, 15);
99.     GUI_SetColor(GUI_BLACK);
100.     GUI_DrawCircle(25, 25, 15);
101.     _PaintCount1++;
102.     WM_InvalidateWindow(WM_HBKWIN);
103.     break;
104.   default:
105.     WM_DefaultProc(pMsg);
106.   }
107. }
109. /*********************************************************************
110. *
111. *       _cbFrameWin2
112. */
113. static void _cbFrameWin2(WM_MESSAGE* pMsg) { //--------------（7）
114.   switch(pMsg->MsgId) {
115.   case WM_PAINT:
116.     GUI_SetBkColor(_aColors[_PaintCount2 % 6]);
117.     GUI_Clear();
118.     GUI_SetColor(0x00FFC0);
119.     GUI_FillCircle(25, 25, 15);
120.     GUI_SetColor(GUI_BLACK);
121.     GUI_DrawCircle(25, 25, 15);
122.     _PaintCount2++;
123.     WM_InvalidateWindow(WM_HBKWIN);
124.     break;
125.   default:
126.     WM_DefaultProc(pMsg);
127.   }
128. }
130. /*********************************************************************
131. *
132. *       _ShowDemo
133. */
134. static void _ShowDemo(void) {
135.   WM_HWIN hWin0;
136.   WM_HWIN hWin1;
137.   WM_HWIN hWin2;
138.   WM_HWIN hFrame1;
139.   WM_HWIN hFrame2;
140.   WM_HWIN hClient1;
141.   WM_HWIN hClient2;
143.   WM_SetCallback(WM_HBKWIN, _cbBkWin); //--------------（8）
144.   hFrame1  = FRAMEWIN_CreateEx( 10, 30, 140, 140, 0, WM_CF_SHOW, FRAMEWIN_CF_MOVEABLE, 0, "Early Clipping", _cbFrameWin1);
145.   hFrame2  = FRAMEWIN_CreateEx(170, 30, 140, 140, 0, WM_CF_SHOW, FRAMEWIN_CF_MOVEABLE, 0, "Late Clipping",
146. _cbFrameWin2);
147.   hClient1 = WM_GetClientWindow(hFrame1);
148.   hClient2 = WM_GetClientWindow(hFrame2);
149.   _hWin1  = WM_CreateWindowAsChild(0, 0, WM_GetWindowSizeX(hClient1), WM_GetWindowSizeY(hClient1), hClient1,
150. WM_CF_SHOW, _cbFrameWin1, 0);
151.   _hWin2  = WM_CreateWindowAsChild(0, 0, WM_GetWindowSizeX(hClient2), WM_GetWindowSizeY(hClient2), hClient2,
152. WM_CF_SHOW | WM_CF_LATE_CLIP, _cbFrameWin2, 0);
153.   _hBut1  = BUTTON_CreateEx(10, 210, 140, 20, 0, WM_CF_SHOW, 0, 1);
154.   _hBut2  = BUTTON_CreateEx(170, 210, 140, 20, 0, WM_CF_SHOW, 0, 2);
155.   hWin0 = FRAMEWIN_CreateEx(60,  80, 40, 40, 0, WM_CF_SHOW | WM_CF_STAYONTOP, FRAMEWIN_CF_MOVEABLE, 0, "Top 0",
156. _cbTop);
157.   hWin1 = FRAMEWIN_CreateEx(220, 80, 40, 40, 0, WM_CF_SHOW | WM_CF_STAYONTOP, FRAMEWIN_CF_MOVEABLE, 0, "Top 1",
158. _cbTop);
159.   hWin2 = FRAMEWIN_CreateEx(140,170, 40, 40, 0, WM_CF_SHOW | WM_CF_STAYONTOP, FRAMEWIN_CF_MOVEABLE, 0, "Top 2",
160. _cbTop);
161.   FRAMEWIN_SetResizeable(hWin0, 1);
162.   FRAMEWIN_SetResizeable(hWin1, 1);
163.   FRAMEWIN_SetResizeable(hWin2, 1);
164.   BUTTON_SetText(_hBut1, "Invalidate");
165.   BUTTON_SetText(_hBut2, "Reset counters");
166.   while(1) {
167.     GUI_Delay(50);
168.   }
169. }
171. /*********************************************************************
172. *
173. *       Public code
174. *
175. **********************************************************************
176. */
177. /*********************************************************************
178. *
179. *       MainTask
180. */
181. void MainTask(void) {
182.   GUI_Init();
183.   //
184.   // Check if recommended memory for the sample is available
185.   //
186.   if (GUI_ALLOC_GetNumFreeBytes() < RECOMMENDED_MEMORY) {
187.     GUI_ErrorOut("Not enough memory available.");
188.     return;
189.   }
190.   while(1) {
191.     _ShowDemo();
192.   }
193. }

复制代码

1.     桌面窗口回调函数。
2.     桌面窗口回调函数中重绘消息WM_PAINT。
3.     由于两个按钮是创建在桌面窗口上面的，所以按钮的WM_NOTIFICATION_RELEASED（通知代码消息类型）是在桌面窗口的回调函数中。这个按钮按下后将窗口_hWin1和窗口_hWin2无效，从而会执行这两个窗口的背景重绘功能。
4.     同上，只不过这里实现的功能是将两个计数值清零，并使桌面窗口无效，从而执行桌面窗口的重绘消息。
5.     此函数同时是hWin0，hWin1，hWin2三个框架窗口的回调函数。
6.     此函数是框架窗口hFrame1的回调函数，回调函数中主要实现了重绘消息，重绘消息中记录了重绘的次数，并根据重绘次数修改背景颜色。
7.     此函数是框架窗口hFrame2的回调函数，回调函数中主要实现了重绘消息，重绘消息中记录了重绘的次数，并根据重绘次数修改背景颜色。
8.     （1） 先创建两个框架窗口hFrame1和hFrame2。
        （2） 分别在这两个框架窗口中创建两个子窗口_hWin1和_hWin2。
        （3） 创建两个按钮_hBut1和_hBut2。
        （4） 创建三个框架窗口hWin0，hWin1和hWin2。
这个例子对于研究回调函数函数还是非常好的，大家可以在这个例子的基础上做一些修改，实现一些功能，显示效果如下：

席萌0209

38.5 官方WM_Video.c实例讲解


        这个DEMO在模拟器中的位置：

主要功能介绍：
         这个例子主要演示框架窗口的创建，删除，隐藏和显示，关于框架窗口暂时还没有讲到，后面章节会专门讲解，跟普通窗口差不多，只是多了一个标题栏，所以将其放在本章节进行讲解也是可以的，用来学习窗口相关的API函数操作。
下面我们将这个代码分析一下：

1. #include <stddef.h>
2. #include <stdio.h>
4. #include "WM.h"
5. #include "GUI.h"
6. #include "FRAMEWIN.h"
7. #include "BUTTON.h"
8. #include "TEXT.h"
10. static void _cbFrameWinTest(WM_MESSAGE * pMsg);
12. /*********************************************************************
13. *
14. *       Defines
15. *
16. **********************************************************************
17. */
18. #define MAX_WINDOWS   50
20. //
21. // Recommended memory to run the sample with adequate performance
22. //
23. #define RECOMMENDED_MEMORY (1024L * 5)
25. /*********************************************************************
26. *
27. *       Static data
28. *
29. **********************************************************************
30. */
32. static WM_HWIN _ahWin[MAX_WINDOWS];
33. static char    _IsCompletelyVis;
35. /*********************************************************************
36. *
37. *       Static code
38. *
39. **********************************************************************
40. */
41. /*********************************************************************
42. *
43. *       _CreateWindow
44. */
45. static void _CreateWindow(void) {  //--------------（1）
46.   unsigned i;
47.   WM_HWIN  hWin;
48.   char     ac[32];
49.   int      j;
51.   for (i = 0; i < MAX_WINDOWS; i++) {
52.     if (_ahWin[i] == 0) {
53.       j = i + 1;
54.       sprintf(ac, "Test window %d", j);
55.       hWin = FRAMEWIN_CreateEx(5 + 10 * i, 135 + 10 * i, 120, 60, 0, WM_CF_SHOW, FRAMEWIN_CF_MOVEABLE, 0, ac,
56. _cbFrameWinTest);
57.       FRAMEWIN_SetClientColor(hWin, GUI_INVALID_COLOR);
58.       _ahWin[i] = hWin;
59.       break;
60.     }
61.   }
62. }
64. /*********************************************************************
65. *
66. *       _DeleteWindow
67. */
68. static void _DeleteWindow(void) {  //--------------（2）
69.   unsigned i;
71.   for (i = 0; i < MAX_WINDOWS; i++) {
72.     if (WM_IsVisible(_ahWin[i])) {
73.       WM_DeleteWindow(_ahWin[i]);
74.       _ahWin[i] = 0;
75.       break;
76.     }
77.   }
78. }
80. /*********************************************************************
81. *
82. *       _ShowWindow
83. */
84. static void _ShowWindow(void) {  //--------------（3）
85.   unsigned i;
87.   for (i = 0; i < MAX_WINDOWS; i++) {
88.     if (_ahWin[i] != 0) {
89.       if (WM_IsVisible(_ahWin[i]) == 0) {
90.         WM_ShowWindow(_ahWin[i]);
91.         break;
92.       }
93.     }
94.   }
95. }
97. /*********************************************************************
98. *
99. *       _HideWindow
100. */
101. static void _HideWindow(void) {  //--------------（4）
102.   unsigned i;
104.   for (i = 0; i < MAX_WINDOWS; i++) {
105.     if (WM_IsVisible(_ahWin[i])) {
106.       WM_HideWindow(_ahWin[i]);
107.       break;
108.     }
109.   }
110. }
112. /*********************************************************************
113. *
114. *       Static code, callbacks
115. *
116. **********************************************************************
117. */
118. /*********************************************************************
119. *
120. *       _cbBkWin
121. */
122. static void _cbBkWin(WM_MESSAGE* pMsg) {  //--------------（5）
123.   int Id;
125.   switch (pMsg->MsgId) {
126.   case WM_PAINT:
127.     GUI_SetBkColor(GUI_BLACK);
128.     GUI_Clear();
129.     break;
130.   case WM_NOTIFY_PARENT:
131.     if (pMsg->Data.v == WM_NOTIFICATION_RELEASED) {
132.       Id = WM_GetId(pMsg->hWinSrc);
133.       switch (Id) {
134.       case GUI_ID_BUTTON0:
135.         _CreateWindow();
136.         break;
137.       case GUI_ID_BUTTON1:
138.         _DeleteWindow();
139.         break;
140.       case GUI_ID_BUTTON2:
141.         _ShowWindow();
142.         break;
143.       case GUI_ID_BUTTON3:
144.         _HideWindow();
145.         break;
146.       }
147.     }
148.     break;
149.   default:
150.     WM_DefaultProc(pMsg);
151.   }
152. }
154. /*********************************************************************
155. *
156. *       _cbFrameWinVideo
157. */
158. static void _cbFrameWinVideo(WM_MESSAGE* pMsg) {  //--------------（6）
159.   WM_HWIN hWin;
160.   WM_HWIN hText;
161.   int     IsCompletelyVis;
162.   int     IsCompletelyCovered;
164.   switch (pMsg->MsgId) {
165.   case WM_PAINT:
166.     if (_IsCompletelyVis) {
167.       GUI_SetBkColor(GUI_DARKGREEN);
168.       GUI_Clear();
169.       GUI_SetColor(GUI_WHITE);
170.       GUI_DispStringAt("Completely visible", 5, 5);
171.     } else {
172.       GUI_SetBkColor(GUI_GRAY);
173.       GUI_Clear();
174.       GUI_SetColor(GUI_WHITE);
175.       GUI_DispStringAt("Not completely visible", 5, 5);
176.     }
177.     break;
178.   case WM_NOTIFY_VIS_CHANGED:
179.     hText = WM_GetDialogItem(WM_HBKWIN, GUI_ID_TEXT1);
180.     hWin  = WM_GetClientWindow(pMsg->hWin);
181.     IsCompletelyVis     = WM_IsCompletelyVisible(hWin);
182.     IsCompletelyCovered = WM_IsCompletelyCovered(hWin);
183.     if (IsCompletelyCovered) {
184.       TEXT_SetText(hText, "completely\\ncovered");
185.     } else {
186.       TEXT_SetText(hText, "not completely\\ncovered");
187.     }
188.     if (_IsCompletelyVis != IsCompletelyVis) {
189.       _IsCompletelyVis = IsCompletelyVis;
190.       WM_InvalidateWindow(hWin);    /* Only required if content changes if partially hidden */
191.     }
192.     break;
193.   default:
194.     WM_DefaultProc(pMsg);
195.   }
196. }
198. /*********************************************************************
199. *
200. *       _cbFrameWinTest
201. */
202. static void _cbFrameWinTest(WM_MESSAGE* pMsg) {  //--------------（7）
203.   switch (pMsg->MsgId) {
204.   case WM_PAINT:
205.     GUI_SetBkColor(GUI_DARKRED);
206.     GUI_Clear();
207.     break;
208.   default:
209.     WM_DefaultProc(pMsg);
210.   }
211. }
213. /*********************************************************************
214. *
215. *       Public code
216. *
217. **********************************************************************
218. */
219. /*********************************************************************
220. *
221. *       MainTask
222. */
223. void MainTask(void) {
224.   FRAMEWIN_Handle hWinVideo;
225.   BUTTON_Handle   hBut;
226.   WM_HWIN         hText;
228.   GUI_Init();
229.   //
230.   // Check if recommended memory for the sample is available
231.   //
232.   if (GUI_ALLOC_GetNumFreeBytes() < RECOMMENDED_MEMORY) {
233.     GUI_ErrorOut("Not enough memory available.");
234.     return;
235.   }
236.   WM_SetCallback(WM_HBKWIN, _cbBkWin);
237.   //--------------（8）
238.   hText = TEXT_CreateEx(240,  85, 80, 26, WM_HBKWIN, WM_CF_SHOW, 0, GUI_ID_TEXT0, "The client\\nwindow is");
239.   TEXT_SetTextColor(hText, GUI_WHITE);
240.   hText = TEXT_CreateEx(240, 111, 80, 26, WM_HBKWIN, WM_CF_SHOW, 0, GUI_ID_TEXT1, NULL);
241.   TEXT_SetTextColor(hText, GUI_WHITE);
242.   //
243.   // Create buttons
244.   //
245.   hBut = BUTTON_CreateEx(240,  5, 75, 18, WM_HBKWIN, WM_CF_SHOW, 0, GUI_ID_BUTTON0);
246.   BUTTON_SetText(hBut, "Create win");
247.   hBut = BUTTON_CreateEx(240, 25, 75, 18, WM_HBKWIN, WM_CF_SHOW, 0, GUI_ID_BUTTON1);
248.   BUTTON_SetText(hBut, "Delete win");
249.   hBut = BUTTON_CreateEx(240, 45, 75, 18, WM_HBKWIN, WM_CF_SHOW, 0, GUI_ID_BUTTON2);
250.   BUTTON_SetText(hBut, "Show win");
251.   hBut = BUTTON_CreateEx(240, 65, 75, 18, WM_HBKWIN, WM_CF_SHOW, 0, GUI_ID_BUTTON3);
252.   BUTTON_SetText(hBut, "Hide win");
253.   //
254.   // Create framewin video
255.   //
256.   hWinVideo = FRAMEWIN_CreateEx(5, 5, 170, 120, 0, WM_CF_SHOW, FRAMEWIN_CF_MOVEABLE, 0, "Video window",
257. _cbFrameWinVideo);
258.   FRAMEWIN_SetClientColor(hWinVideo, GUI_INVALID_COLOR);
259.   //
260.   // Create test windows
261.   //
262.   _CreateWindow();
263.   _CreateWindow();
264.   _CreateWindow();
265.   while (1) {
266.     GUI_Delay(1000);
267.   }
268. }

复制代码

1.     创建FrameWin。
2.     删除FrameWin，主要是函数WM_DeleteWindow的使用。
3.     显示FrameWin，主要是函数WM_IsVisible和WM_ShowWindow的使用。
4.     隐藏FrameWin，主要是函数WM_HideWindow的使用。
5.     桌面窗口回调函数，主要看WM_NOTIFY_PARENT消息，进入后再分为4个button的消息，分别实现框架窗口的创建，删除，显示和隐藏。
6.     框架窗口FrameVideo的回调函数。
7.     函数_CreateWindow里面所创建框架窗口的回调函数。
8.     （1）创建两个文本控件。
        （2）创建四个按钮，分别实现创建，删除，显示和隐藏窗口。
        （3）创建框架窗口hWinVideo。
这个例子相对要简单很多，下面是这个例子的实际显示效果：

席萌0209

38.6  总结


本期教程就跟大家讲这么多，官方提供的这几个例子还是比较有参考价值的，希望初学者把这几个例子研究下，并在模拟器或者开发板上面多做这方面的练习。