【STemWin教程】第57章 WINDOW-窗口控件

席萌0209

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

第57章 WINDOW-窗口控件

    本期教程讲解STemWin支持的窗口控件，窗口控件和前面讲的窗口本质上面是一样的，只不过这里是以控件的形式存在，专门用于对话框中创建窗口。
    57. 1窗口控件介绍
    57. 2 官方WIDGET_Window实例
    57. 3 总结

57.1 窗口控件介绍
    WINDOW控件的作用是从资源表创建对话框窗口。如果对话框看起来不象框架窗口，则应当使用WINDOW控件。窗口控件充当的是背景以及子窗口的容器：它可包含子窗口，通常采用灰色来作为背景的填充色。它类似于没有框架和标题栏的框架窗口，供对话框所使用。

57.2 官方WIDGET_Window实例
    官方的这个实例很好的演示了window的使用，这个例子在模拟器中的位置：

源码如下（程序中进行了详细的注释）：

1. #include "GUI.h"
2. #include "DIALOG.h"
5. /*********************************************************************
6. *
7. * _aDialog
8. * 对话框创建资源
9. */
10. static const GUI_WIDGET_CREATE_INFO _aDialog[] = {
11. { WINDOW_CreateIndirect, "", 0, 0, 0, 260, 200, 0 },
12. { TEXT_CreateIndirect, "Dialog", 0, 80, 5, 100, 20, TEXT_CF_HCENTER },
13. { BUTTON_CreateIndirect, "Close", GUI_ID_BUTTON0, 80, 160, 100, 20, 0 }
14. };
16. /*********************************************************************
17. *
18. * _cbDialog
19. * 对话框回调函数
20. */
21. static void _cbDialog(WM_MESSAGE *pMsg) {
22. int NCode;
23. int Id;
25. switch (pMsg->MsgId) {
26. case WM_PAINT:
27. GUI_SetBkColor(GUI_GREEN);
28. GUI_Clear();
29. break;
30. case WM_NOTIFY_PARENT:
31. Id = WM_GetId(pMsg->hWinSrc); // Id of widget
32. NCode = pMsg->Data.v; // Notification code
33. switch (NCode) {
34. case WM_NOTIFICATION_RELEASED: // React only if released
35. switch (Id) {
36. case GUI_ID_BUTTON0:
37. GUI_EndDialog(pMsg->hWin, 0);
38. break;
39. }
40. break;
41. }
42. break;
43. default:
44. WM_DefaultProc(pMsg);
45. }
46. }
48. /*********************************************************************
49. *
50. * MainTask
51. */
52. void MainTask(void) {
53. GUI_Init();
54. while(1) {
55. GUI_DispStringHCenterAt("WIDGET_Window sample\nshows how to use a WINDOW widget", 160, 5);
56. /* 阻塞式对话框 */
57. GUI_ExecDialogBox(_aDialog, GUI_COUNTOF(_aDialog), _cbDialog, WM_HBKWIN, 30, 30);
58. GUI_Clear();
59. GUI_DispStringHCenterAt("Dialog has been closed", 160, 5);
60. GUI_Delay(1000);
61. GUI_Clear();
62. }
63. }

复制代码

实际显示效果如下：

57.3 总结
    本期教程主要是跟大家讲解了窗口控件的使用，窗口控件使用同上期讲的文本控件一样，都比较的容易些，只是现在的uCGUIBulder4.0和GUIBulder5.22都还不支持在对话框上面创建窗口控件。