【STemWin教程】第41章 CHECKBOX-复选框控件

席萌0209

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

第41章 CHECKBOX-复选框控件

    本期教程讲解STemWin支持的复选框。
    41. 1 复选框控件介绍
    41. 2 官方WIDGET_CheckBox实例
    41. 3 总结

41.1 复选框控件介绍
    复选框是选择各种不同选项的最常用控件之一。用户可选中或取消选中复选框，并且可一次选中任意个框。使用键盘界面时，被聚焦的复选框的状态可使用<SPACE>键切换。禁用的框显示为灰色，如下图所示，其中描述了每种可能的复选框的外观：

    开启皮肤色后显示效果如下：

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

消息	描述
WM_NOTIFICATION_CLICKED	复选框已被点击。
WM_NOTIFICATION_RELEASED	复选框已被释放。
WM_NOTIFICATION_MOVED_OUT	复选框已被点击，且指针已移出复选框并且没有释放。
WM_NOTIFICATION_VALUE_CHANGED	复选框的状态已改变。

41.1.2 按钮支持键盘反应
    如果控件具有输入焦点，则它将对下列各键做出反应：

按键	反应
GUI_KEY_SPACE	切换小工具的选中状态

41.2 官方WIDGET_CheckBox实例
    官方的这个例子做的很好，充分的演示了复选框的各个状态。这个例子在模拟器中的位置：

源代码如下（主要看WIDGET_Checkbox中的代码）：

1. #include <stddef.h>
2. #include "GUI.h"
3. #include "DIALOG.h"
4. #include "Main.h"
6. /*********************************************************************
7. *
8. *       Static data
9. *
10. **********************************************************************
11. */
13. //
14. // Dialog resource
15. //
16. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {（1）
17.   { FRAMEWIN_CreateIndirect, "Check box sample",   0,   10,  10, 300, 220, FRAMEWIN_CF_MOVEABLE},
18.   { TEXT_CreateIndirect,     "Enabled:",           0,    5,  10, 120,   0 },
19.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK0,    5,  30, 120,   0 },
20.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK1,    5,  60, 120,   0 },
21.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK2,    5,  90, 120,   20 },
22.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK3,    5, 125, 120,   26 },
23.   { TEXT_CreateIndirect,     "Disabled:",          0,  150,  10, 120,   0 },
24.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK4,  150,  30, 120,   0 },
25.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK5,  150,  60, 120,   0 },
26.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK6,  150,  90, 120,   26 },
27.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK7,  150, 125, 120,   26 },
28.   { BUTTON_CreateIndirect,   "OK",         GUI_ID_OK,   10, 170,  60,  20 },
29.   { BUTTON_CreateIndirect,   "Cancel", GUI_ID_CANCEL,  225, 170,  60,  20 },
30. };
32. //
33. // Check box text
34. //
35. static const char * _apLabel[] = {（2）
36. "Default",
37. "3 States",
38. "Box XL",
39. "Box XXL"
40. };
42. /*********************************************************************
43. *
44. *       Static code
45. *
46. **********************************************************************
47. */
48. /*********************************************************************
49. *
50. *       _cbCallback
51. */
52. static void _cbCallback(WM_MESSAGE * pMsg) {
53.   WM_HWIN hDlg;
54.   WM_HWIN hItem;
55.   int     i;
56.   int     NCode;
57.   int     Id;
59.   hDlg = pMsg->hWin;
60.   switch (pMsg->MsgId) {
61.     case WM_INIT_DIALOG:
62.       WM_GetDialogItem(hDlg, GUI_ID_CHECK0);
63.       for (i = 0; i < 8; i++) {（3）
64.         int Index = i % 4;
65.         hItem = WM_GetDialogItem(hDlg, GUI_ID_CHECK0 + i); // Get the handle of the desired checkbox
66.         CHECKBOX_SetText(hItem, _apLabel[Index]);          // Set the check box text（4）
68.         switch (Index) {
69.         case 1:（5）
70.           //
71.           // Set the number of possible states to 3
72.           //
73.           CHECKBOX_SetNumStates(hItem, 3);（6）
74.           //
75.           // Use user defined bitmaps for the third state
76.           //（7）
77.           CHECKBOX_SetImage(hItem, &_abmBar[0], CHECKBOX_BI_INACTIV_3STATE);  // Used if widget is disabled
78.           CHECKBOX_SetImage(hItem, &_abmBar[1], CHECKBOX_BI_ACTIV_3STATE);    // Used if widget is enabled
79.           CHECKBOX_SetState(hItem, 2);（8）
80.           break;
81.         case 2:（9）
82.           CHECKBOX_SetState(hItem, 1);
83.           //
84.           // Use user defined bitmaps for the 'checked' state
85.           //
86.           CHECKBOX_SetImage(hItem, &_abmXL[0], CHECKBOX_BI_INACTIV_CHECKED);  // Used if widget is disabled
87.           CHECKBOX_SetImage(hItem, &_abmXL[1], CHECKBOX_BI_ACTIV_CHECKED);    // Used if widget is enabled
88.           CHECKBOX_SetFont(hItem, &GUI_FontComic18B_ASCII);
89.           break;
90.         case 3:（10）
91.           CHECKBOX_SetState(hItem, 1);
92.           //
93.           // Use user defined bitmaps for the 'checked' state
94.           //
95.           CHECKBOX_SetImage(hItem, &_abmXXL[0], CHECKBOX_BI_INACTIV_CHECKED); // Used if widget is disabled
96.           CHECKBOX_SetImage(hItem, &_abmXXL[1], CHECKBOX_BI_ACTIV_CHECKED);   // Used if widget is enabled
97.           CHECKBOX_SetFont(hItem, &GUI_FontComic24B_ASCII);
98.           break;
99.         }
100.         //
101.         // Disable all check boxes shown on the right side of the dialog
102.         //
103.         if (i >= 4) {（11）
104.           WM_DisableWindow(hItem);
105.         }
106.       }
107.       break;
108.     case WM_NOTIFY_PARENT:
109.       Id    = WM_GetId(pMsg->hWinSrc);      // Id of widget
110.       NCode = pMsg->Data.v;                 // Notification code
111.       switch (NCode) {
112.         case WM_NOTIFICATION_RELEASED:      // React only if released
113.           if (Id == GUI_ID_OK) {            // OK Button
114.             GUI_EndDialog(hDlg, 0);
115.           }
116.           if (Id == GUI_ID_CANCEL) {        // Cancel Button
117.             GUI_EndDialog(hDlg, 1);
118.           }
119.           break;
120.       }
121.       break;
122.     default:
123.       WM_DefaultProc(pMsg);
124.   }
125. }
127. /*********************************************************************
128. *
129. *       Public code
130. *
131. **********************************************************************
132. */
133. /*********************************************************************
134. *
135. *       MainTask
136. */
137. void MainTask(void) {
138.   #if GUI_SUPPORT_MEMDEV
139.     WM_SetCreateFlags(WM_CF_MEMDEV);
140.   #endif
141.   GUI_Init();
142.   WM_SetDesktopColor(GUI_BLACK);
143.   while (1) {
144.     GUI_ExecDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
145.     GUI_Delay(500);
146.   }
147. }

复制代码

1. 对话框中控件的资源表，具体每个控件的参数，看前面38.6.1的介绍。
2. 复选框要显示的文本。
3. 循环8次，为8个复选框进行设置。
4. 函数CHECKBOX_SetText用于设置复选框旁边的可选文本。
5. 确切的说这里的case 1应该算是显示的第二种情况，为了方便起见，我们讲起称之为第一种情况，因为前面已经显示了一种情况。也就是i%4 = 0的情况。
6. 函数CHECKBOX_SetNumStates用于设置复选框可能的状态个数，默认情况下，复选框支持2种状态：选中(1)和未选中(0)。如果复选框要支持第三种状态，可将可能状态增加到3种。
7. 函数CHECKBOX_SetImage用于设置复选框被选中后显示的图像。图像必须填充复选框的整个内部区域。使用此函数时，要确保用于创建小工具的复选框的尺寸足以显示位图和 （可选的）文本。
8. 函数CHECKBOX_SetState用于设置复选框的状态，支持三种状态的显示，可以是选中，取消选中和第三种状态。
9. 情况二，显示一种稍大点的复选框。
10. 情况三，显示一种再大点的复选框。
11. 通过这个函数来禁止右侧复选框的状态。
    实际的显示效果如下：

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