【STemWin教程】第58章 SPINBOX控件

席萌0209

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

第58章 SPINBOX控件

    本期教程讲解STemWin支持的SPINBOX控件。
    58. 1 SPINBOX控件介绍
    58. 2 官方WIDGET_Spinbox实例
    58. 3 使用官方GUIBulder建立SPINBOX控件
    58. 3 总结

58.1 SPINBOX控件介绍
    SPINBOX控件主要用于需要快速而准确的数据调整，SPINBOX控件是由一个编辑框和两个按钮组成。默认的显示效果如下：

设置了皮肤色后显示效果如下：

58.1.1 SPINBOX支持的通知代码
    以下事件是编辑框控件作为WM_NOTIFY_PARENT消息的一部分发送给其父窗口的：

消息	描述
WM_NOTIFICATION_CLICKED	已被点击。
WM_NOTIFICATION_RELEASED	已被释放。
WM_NOTIFICATION_MOVED_OUT	已被点击，且指针已移出控件，但没有释放。
WM_NOTIFICATION_VALUE_CHANGED	SPINBOX的值 （内容）已更改。

58.1.2 SPINBOX支持的键盘反应
    同第43章中的43.1.2小节一样。

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

  

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

1. #include "GUI.h"
2. #include "DIALOG.h"
4. /*********************************************************************
5. *
6. *       Static data
7. *
8. **********************************************************************
9. */
10. static const GUI_WIDGET_CREATE_INFO _aDialogSpinbox[] = {
11.   { FRAMEWIN_CreateIndirect, "Spinbox",           0,                 0,  0, 260, 160, 0, 0, 0 },
12.   { TEXT_CreateIndirect,     "Step value",        GUI_ID_TEXT0,     20, 15, 100,  21, 0, 0, 0 },
13.   { TEXT_CreateIndirect,     "Editmode \"Step\"", GUI_ID_TEXT1,     20, 42, 100,  21, 0, 0, 0 },
14.   { TEXT_CreateIndirect,     "Editmode \"Edit\"", GUI_ID_TEXT2,     20, 75, 100,  21, 0, 0, 0 },
15.   { SPINBOX_CreateIndirect,  NULL,                GUI_ID_SPINBOX0, 130, 15,  60,  21, 0, 0, 0 },
16.   { SPINBOX_CreateIndirect,  NULL,                GUI_ID_SPINBOX1, 130, 42,  60,  21, 0, 0, 0 },
17.   { SPINBOX_CreateIndirect,  NULL,                GUI_ID_SPINBOX2, 130, 75,  60,  21, 0, 0, 0 },
18. };
20. /*********************************************************************
21. *
22. *       _cbBk
23. *   桌面窗口的回调函数
24. */
25. static void _cbBk(WM_MESSAGE * pMsg) {
26.   int xSize;
27.   int ySize;
29.   switch (pMsg->MsgId) {
30.   case WM_PAINT:
31.     xSize = LCD_GetXSize();
32.     ySize = LCD_GetYSize();
33.     GUI_DrawGradientV(0, 0, xSize, ySize, GUI_BLUE, GUI_BLACK);
34.     GUI_SetColor(GUI_WHITE);
35.     GUI_SetFont(&GUI_Font24_ASCII);
36.     GUI_SetTextMode(GUI_TM_TRANS);
37.     GUI_DispStringHCenterAt("WIDGET_Spinbox - Sample", xSize / 2, 5);
38.     break;
39.   default:
40.     WM_DefaultProc(pMsg);
41.   }
42. }
44. /*********************************************************************
45. *
46. *       _cbClient
47. *   对话框的回调函数
48. */
49. static void _cbClient(WM_MESSAGE * pMsg) {
50.   EDIT_Handle hEdit;
51.   WM_HWIN     hItem;
52.   int         Value;
53.   int         NCode;
54.   int         Id;
56.   switch (pMsg->MsgId) {
57.   case WM_INIT_DIALOG:
59.     /* 设置框架窗口标题的字体和皮肤 */
60. FRAMEWIN_SetFont(pMsg->hWin, GUI_FONT_16B_ASCII);
61.     FRAMEWIN_SetSkin(pMsg->hWin, FRAMEWIN_SKIN_FLEX);
63.     /* 设置文本TEXT0的对齐方式 */
64. hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_TEXT0);
65.     TEXT_SetTextAlign(hItem, GUI_TA_VCENTER | GUI_TA_RIGHT);
66. /* 设置文本TEXT1的对齐方式 */
67.     hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_TEXT1);
68.     TEXT_SetTextAlign(hItem, GUI_TA_VCENTER | GUI_TA_RIGHT);
69. /* 设置文本TEXT2的对齐方式 */
70.     hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_TEXT2);
71.     TEXT_SetTextAlign(hItem, GUI_TA_VCENTER | GUI_TA_RIGHT);
73.     /* 设置spinbox的皮肤 */
74. hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_SPINBOX0);
75.     SPINBOX_SetSkin(hItem, SPINBOX_SKIN_FLEX);
76.     hEdit = SPINBOX_GetEditHandle(hItem);
77.     /* 启用编辑字段的十进制编辑模式 */
78. EDIT_SetDecMode(hEdit,
79.                 1,    /* 要修改的值 */
80. 1,    /* 最小值 */
81. 10,   /* 最大值 */
82. 0,    /* 如果>0，指定小数点的位置 */
83. 0);   /* 0（默认值）：在正常模式下编辑，符号仅在Value为负值时显示 */
85.      /* 设置spinbox的皮肤 */
86. hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_SPINBOX1);
87.     SPINBOX_SetSkin(hItem, SPINBOX_SKIN_FLEX);
88.     hEdit = SPINBOX_GetEditHandle(hItem);
89.     /* 启用编辑字段的十进制编辑模式 */
90. EDIT_SetDecMode(hEdit,
91.                 1,     /* 要修改的值 */
92. 0,     /* 最小值 */
93. 99999, /* 最大值 */
94. 0,     /* 如果>0，指定小数点的位置 */
95. 0);    /* 0（默认值）：在正常模式下编辑，符号仅在Value为负值时显示 */
96.      /* 设置spinbox的皮肤 */
97. hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_SPINBOX2);
98.     SPINBOX_SetSkin(hItem, SPINBOX_SKIN_FLEX);
100. /* 特别注意，这个函数是5.24版本才加入的，用于设置模式 */
101. SPINBOX_SetEditMode(hItem, SPINBOX_EM_EDIT);
102. /* 设置最大和最小值 */
103.     SPINBOX_SetRange(hItem, 0, 99999);
104.     break;
105.   case WM_NOTIFY_PARENT:
106.     NCode = pMsg->Data.v;
107.     switch (NCode) {
108. /* 接收到GUI_ID_SPINBOX0的WM_NOTIFICATION_VALUE_CHANGED消息后，根据SPINBOX0
109.    中的当前值修改SPINBOX1中单次的前进后退步数。
110. */
111.     case WM_NOTIFICATION_VALUE_CHANGED:
112.       Id = WM_GetId(pMsg->hWinSrc);
113.       if (Id == GUI_ID_SPINBOX0) {
114.         Value = SPINBOX_GetValue(pMsg->hWinSrc);
115.         hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_SPINBOX1);
116.         SPINBOX_SetStep(hItem, Value);
117.       }
118.       break;
119.     default:
120.       WM_DefaultProc(pMsg);
121.     }
122.     break;
123.   case WM_PAINT:
124.     GUI_SetBkColor(0xAE9E8D);
125.     GUI_Clear();
126.     break;
127.   default:
128.     WM_DefaultProc(pMsg);
129.   }
130. }
132. /*********************************************************************
133. *
134. *       MainTask
135. */
136. void MainTask(void) {
137.   GUI_Init();
138.   WM_SetCallback(WM_HBKWIN, _cbBk);
139.   TEXT_SetDefaultTextColor(GUI_WHITE);
140.   /* 创建对话框 */
141.   GUI_CreateDialogBox(_aDialogSpinbox, GUI_COUNTOF(_aDialogSpinbox), _cbClient,  WM_HBKWIN,  30,  60);
142.   while (1) {
143.     GUI_Delay(100);
144.   }
145. }

复制代码

实际显示效果如下：

58.3 使用官方GUIBulder建立SPINBOX控件
    这里用GUIBulder5.22建立一个如下的界面（分辨率480*272）：

    当前GUIBulder5.22版本对SPINBOX控件的支持还比较的弱，仅支持将其添加到对话框上面。将生成的代码直接复制到模拟器或者开发板上面运行，实际显示效果如下（生成的代码在本期教程配套的例子中）：

58.4 总结
    本期教程主要是跟大家讲解了SPINBOX控件的基础使用方法。希望大家可以把本期教程中讲的这两个例子跑跑，然后自己设计一个相关的例子进行试验学习。教程中只是使用了部分的SPINBOX控件API，其它的API大家都可以试试。