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

第53章 RADIO-单选按钮控件

9 U6 I  c1 t  R+ K4 M5 L) Z0 A& C

    本期教程讲解STemWin支持的单选按钮控件。

    53. 1 单选按钮控件介绍

    53. 2 官方DIALOG_Radio实例

    53. 3 使用官方GUIBulder建立单选按钮控件

    53. 4 总结

53.1 进度条控件介绍

   如同复选框一样，单选按钮也可用来选择选项。打开或选择单选按钮时，将出现圆点。与复选框的差别是，用户一次只能选择一个单选按钮。选择一个按钮时，控件中的其他按钮将关闭 （如右图所示）。一个单选按钮控件可能包含任意数量的按钮, 这些按钮始终处于垂直排列状态。下表显示的是RADIO按钮的默认外观：

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

53.1.1 单选按钮支持的通知代码

    以下事件是单选按钮控件作为WM_NOTIFY_PARENT消息的一部分发送给其父窗口的：

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

53.1.2 单选按钮支持的键盘反应

    如果控件具有输入焦点，则它将对下列各键做出反

按键	反应
GUI_KEY_RIGHT	选定范围增加1。
GUI_KEY_DOWN	选定范围增加1。
GUI_KEY_LEFT	选定范围减小1。
GUI_KEY_UP	选定范围减小1。

53.2 官方DIALOG_Radio实例

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

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

1. #include <stddef.h>
   
2. #include "GUI.h"
   
3. #include "DIALOG.h"
   - A4 E% g" l* z* N$ |. V! R
4. 
   ( H# A/ p8 f0 f
5. /*********************************************************************
   
6. *
   
7. *       Dialog resource
   
8. *    对话框资源表
   & e7 D8 J9 z1 B/ Z% Q  N
9. */
   6 J+ O% L" _9 u" T
10. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
    7 D# s9 J, s) Q. w4 P
11.   { FRAMEWIN_CreateIndirect, "Radio button sample", 0,        30,  70, 260, 100, FRAMEWIN_CF_MOVEABLE },
    ; u% h$ B0 T. t; `% c
12.   { RADIO_CreateIndirect,     NULL,           GUI_ID_RADIO0,   5,  10,   0,   0,   0,  3 },
    ! i& E/ n/ ?1 |3 r# ]4 W
13.   { TEXT_CreateIndirect,     "Suspend",       GUI_ID_TEXT0,   25,  10,  70,  20, TEXT_CF_LEFT },
    
14.   { TEXT_CreateIndirect,     "Shut down",     GUI_ID_TEXT1,   25,  30,  70,  20, TEXT_CF_LEFT },
    
15.   { TEXT_CreateIndirect,     "Restart after", GUI_ID_TEXT2,   25,  50,  70,  20, TEXT_CF_LEFT },
    - i8 ~0 w0 U, o: j& G& `; m
16.   { TEXT_CreateIndirect,     "seconds",       GUI_ID_TEXT3,  130,  50,  70,  20, TEXT_CF_LEFT },
    
17.   { EDIT_CreateIndirect,     "200",           GUI_ID_EDIT0,   95,  47,  30,  19, 0, 3},
    
18.   { BUTTON_CreateIndirect,   "OK",            GUI_ID_OK,     180,  10,  60,  20 },
    ( l& }+ K4 z0 G0 `( i
19.   { BUTTON_CreateIndirect,   "Cancel",        GUI_ID_CANCEL, 180,  40,  60,  20 }
    
20. };
    
21. 
    
22. 
    0 A' O+ k7 G7 F: r
23. /*********************************************************************
    4 ^4 o, {% \  b: b, S( p, x  P1 F
24. *
    . C8 P; i7 f7 A
25. *       _cbBkWindow
    
26. *     桌面窗口的回调函数
    
27. */
    8 G/ q7 I9 |: z# _: b0 m
28. static void _cbBkWindow(WM_MESSAGE* pMsg) {
    $ {5 I8 q# ]9 K+ g) o* V4 ~9 ]
29.   switch (pMsg->MsgId) {
    $ ?; @+ K& s! B: `; M: t
30.   case WM_PAINT:
    
31.     GUI_SetBkColor(GUI_RED);
    # s  N, [) l" x/ A; \$ D
32.     GUI_Clear();
    
33.     GUI_SetColor(GUI_WHITE);
    
34.     GUI_SetFont(&GUI_Font24_ASCII);
    2 v- M2 S0 v8 J7 {" L
35.     GUI_DispStringHCenterAt("DIALOG_Radio - Sample", 160, 5);
    
36.     break;
    
37.   default:
    
38.     WM_DefaultProc(pMsg);
    
39.   }
    
40. }
    % O0 T* m9 P$ W% j
41. 
    
42. /*********************************************************************
    
43. *
    
44. *       _cbCallback
    
45. *     对话框的回调函数
    
46. */
    
47. static void _cbCallback(WM_MESSAGE * pMsg) {
    8 Z9 _3 X3 ^* _1 m) h
48.   WM_HWIN hDlg;
    
49.   WM_HWIN hItem;
    
50.   int     Sel;
    ! P  F& @  q5 D. @
51.   int     NCode;
    
52.   int     Id;
    + Z$ D$ b( P' A
53. 
    - K! v+ D) [. }. q, ^4 Y# J# V
54.   GUI_PID_STATE * pState;
    ( ?- S$ A: P' ?+ y( _, h( n2 V& N
55.   hDlg = pMsg->hWin;
    0 k2 z( M, V& w, `+ Y2 d: F# M7 x. E
56.   switch (pMsg->MsgId) {
    
57.     case WM_INIT_DIALOG:
    
58.       hItem = WM_GetDialogItem(hDlg, GUI_ID_EDIT0);
    ) h% _; |6 i4 T; |4 D& d; v
59.       EDIT_SetDecMode(hItem, 30,   0, 999, 0, 0);    // 选项编辑框的10进制模式
    
60.       WM_DisableWindow(hItem);
    
61.       break;
    
62.     case WM_KEY:
    
63.       switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key) {
    
64.         case GUI_KEY_ESCAPE:
    * ~  q1 [: \6 r& R. i+ K
65.           GUI_EndDialog(hDlg, 1);
    4 |3 @: `" T; d7 I  R
66.           break;
    ; r, g. }. `! h# n$ d: j$ H( I
67.         case GUI_KEY_ENTER:
    1 g, M6 h$ }2 Z9 H6 F$ e$ H
68.           GUI_EndDialog(hDlg, 0);
    ' D' G2 K% {' M4 p2 g: M) m
69.           break;
    & g* j3 D8 b- d6 u' B& n- F& r1 R* C
70.       }
    
71.       break;
    1 ?& R. \+ h, Y/ @/ ~- y: f# r
72. /* 通过WM_TOUCH_CHILD消息的主要功能是：当点击单选按钮边上的文本控件时，
      `0 I  V5 c" `4 t
73.    也可以实现单选按钮控件的选择
    ' A3 J- m- M9 m$ H' ~: r
74.   */  
    3 X- n2 t/ |2 v5 d
75.     case WM_TOUCH_CHILD:
    
76.       Id = WM_GetId(pMsg->hWinSrc);      
    3 q- |6 ^  s0 \/ r/ N
77.       switch (Id) {
    : V7 G4 _" Z. F1 W9 Y* l
78.         case GUI_ID_TEXT0:
    
79.         case GUI_ID_TEXT1:
    8 R! N7 g7 r& |+ O: p8 M7 s$ j
80.         case GUI_ID_TEXT2:
    1 u7 N- P( d" A7 q
81.           pState = (GUI_PID_STATE *)((WM_MESSAGE *)pMsg->Data.p)->Data.p;
    
82.           if (pState) {
    
83.             if (pState->Pressed) {
    # Z, S, K/ @( p: E- H: n) V- j
84.               WM_HWIN hRadio = WM_GetDialogItem(hDlg, GUI_ID_RADIO0);
    
85.               RADIO_SetValue(hRadio, Id - GUI_ID_TEXT0);   
    & m0 @4 [, v& q$ F8 T
86.             }
    
87.           }
    ( F. h" s' H5 }- K
88.           break;
    
89.       }
    ' I# q0 U! J6 ^7 c- I
90.       break;
    
91.     case WM_NOTIFY_PARENT:
    8 a  H& X: B$ Z& r) k
92.       Id    = WM_GetId(pMsg->hWinSrc);      // Id of widget
    
93.       NCode = pMsg->Data.v;                 // Notification code
    ( u  Z) o! T6 M/ ?  I- i+ p
94.       switch (NCode) {
    : I; Q" L$ o: p( X) U
95.         case WM_NOTIFICATION_RELEASED:      // React only if released
    
96.           switch (Id) {
    
97.             case GUI_ID_OK:
    
98.               GUI_EndDialog(hDlg, 0);
    4 I0 F0 |) E$ S
99.               break;
    
100.             case GUI_ID_CANCEL:
     . o; J" z, M; @' y( t
101.               GUI_EndDialog(hDlg, 1);
     - S* n8 [" c1 M) U
102.               break;
     
103.           }
     
104.           break;
     * x2 _! O$ E* h# u3 z$ D2 |
105. /* 当选择第三个单选按钮时，将使能编辑框GUI_ID_EDIT0 */
     5 w; h: |7 s9 H) a9 }4 g+ G
106.         case WM_NOTIFICATION_VALUE_CHANGED:
     
107.           hItem = WM_GetDialogItem(hDlg, GUI_ID_RADIO0);
     
108.           Sel   = RADIO_GetValue(hItem);
     
109.           hItem = WM_GetDialogItem(hDlg, GUI_ID_EDIT0);
     
110.           WM_SetEnableState(hItem, Sel == 2);      
     $ A, X4 v* w8 @7 T9 X/ A, g  N
111.           break;
     - E0 ?1 a8 D5 \. k) A5 F
112.       }
     ' f$ l" t0 x- d3 B3 S
113.       break;
     
114.     default:
     
115.       WM_DefaultProc(pMsg);
     
116.   }
     " l  T. v6 R) {8 i. B% N, p9 i4 y
117. }
     
118. 
     
119. /*********************************************************************
     
120. *
     . o" _+ I7 \. F: {$ W% V& b/ D% ~
121. *       MainTask
     . ^9 s5 s4 B5 x
122. */
     * M  `+ w% C  _* z
123. void MainTask(void) {
     3 C$ E. ^) o) m  ~$ ]
124.   GUI_Init();
     
125.   WM_SetCallback(WM_HBKWIN, &_cbBkWindow);
     2 j4 i. }6 z" Z
126.   WM_SetCreateFlags(WM_CF_MEMDEV);  // Use memory devices on all windows to avoid flicker
     
127.   while (1) {
     
128. /* 创建阻塞式对话框 */
     
129.     GUI_ExecDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
     5 F/ t3 l" q! o# H' }; y1 J
130.     GUI_Delay(1000);
     
131.   }
     
132. }

复制代码

实际现象效果如下：

53.3 使用官方GUIBulder建立单选按钮控件

    这里用GUIBulder5.22建立一个如下的界面（分辨率480*272）：

鼠标放在单选按钮控件上面右击可以设置单选按钮：

具体每个选项的名字在右下角进行设置：

将生成的代码直接复制到模拟器或者开发板上面运行，实际显示效果如下（生成的代码在本期教程配套的例子中）：

53.4 总结

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

都是好东西…

支持一下

大力支持!