你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

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

[复制链接]
baiyongbin2009 发布时间:2015-2-28 11:08
特别说明:完整STemWin的1-60期教程和配套实例下载地址:链接
" |2 [7 C4 U4 \, K: _/ A$ w7 M) n5 w! c  N
第41章 CHECKBOX-复选框控件
' d* c: Q4 |3 Q1 y) C. F( Z
    本期教程讲解STemWin支持的复选框。
    41. 1 复选框控件介绍
    41. 2 官方WIDGET_CheckBox实例
    41. 3 总结
41.1 复选框控件介绍
    复选框是选择各种不同选项的最常用控件之一。用户可选中或取消选中复选框,并且可一次选中任意个框。使用键盘界面时,被聚焦的复选框的状态可使用<SPACE>键切换。禁用的框显示为灰色,如下图所示,其中描述了每种可能的复选框的外观:
41.1.png
开启皮肤色后显示效果如下:
41.2.png
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实例
    官方的这个例子做的很好,充分的演示了复选框的各个状态。这个例子在模拟器中的位置:
41.3.png
源代码如下(主要看WIDGET_Checkbox中的代码):
  1. #include <stddef.h>/ |* C6 c7 O, p( t
  2. #include "GUI.h"7 l1 z! a2 f% N) n- t
  3. #include "DIALOG.h"
    6 Z4 S, P5 A: T% m4 W7 W  `5 y
  4. #include "Main.h", i" `/ o  Z3 a

  5. 3 m. F  x9 x+ w$ t8 R/ n9 B* m
  6. /*********************************************************************% i7 K' F' D/ o0 S3 x
  7. *
    7 i/ r* Q" L0 [/ R
  8. *       Static data
    3 J3 m, w7 V5 C# L$ K8 t
  9. *% E. z% j4 o7 T7 |
  10. **********************************************************************
    ! a2 B5 G2 u0 M+ y
  11. */! {0 D9 r& C0 k; P( H/ @' z8 c

  12. % A# Y' Y: t, p, v8 }
  13. //
    5 Z* E0 N( _. s5 o+ R5 b# t
  14. // Dialog resource
    & A; x) C2 O/ R7 X
  15. //
    6 f9 r: N; y  K+ s# {
  16. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {(1)
    / T! r/ j/ i+ ~* N! v2 r7 Z) Z$ q. q
  17.   { FRAMEWIN_CreateIndirect, "Check box sample",   0,   10,  10, 300, 220, FRAMEWIN_CF_MOVEABLE},9 h/ J) ~) X$ q6 A  m1 a; d
  18.   { TEXT_CreateIndirect,     "Enabled:",           0,    5,  10, 120,   0 },
    ' [$ r5 b* A& z0 ~( y& m$ }
  19.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK0,    5,  30, 120,   0 },& t" Z8 t4 x5 b; g8 V8 W1 P
  20.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK1,    5,  60, 120,   0 },
    # A+ @: b* o3 Z: Z
  21.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK2,    5,  90, 120,   20 },
    3 T4 o( o- m1 j8 T6 X+ B" [
  22.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK3,    5, 125, 120,   26 },
    ) S; v9 n+ ^. X0 v- J! ^( w" z" P
  23.   { TEXT_CreateIndirect,     "Disabled:",          0,  150,  10, 120,   0 },+ _7 \) g( Q. r9 }+ ?# F3 w
  24.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK4,  150,  30, 120,   0 },3 g( U% _3 W; ^( b
  25.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK5,  150,  60, 120,   0 },
    ' h# p) \# r5 ]2 @6 t
  26.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK6,  150,  90, 120,   26 },0 a+ \' W% r9 y* o5 p8 m# g  Z
  27.   { CHECKBOX_CreateIndirect, 0,        GUI_ID_CHECK7,  150, 125, 120,   26 },% s" L+ Y9 K- {) R
  28.   { BUTTON_CreateIndirect,   "OK",         GUI_ID_OK,   10, 170,  60,  20 },2 [' V( e/ ]6 ?2 O3 B
  29.   { BUTTON_CreateIndirect,   "Cancel", GUI_ID_CANCEL,  225, 170,  60,  20 },/ |! u* L" o5 L0 s( v5 O/ S
  30. };$ p3 P8 N+ C( T6 I" Z7 u
  31. + O; T2 [  a! s4 i
  32. //3 ^. q, B3 x  O
  33. // Check box text: @; g& \7 i7 l
  34. //
    7 P  ~5 \/ v8 B9 J$ Q
  35. static const char * _apLabel[] = {(2)" j9 D; b7 o* s* w" |6 F
  36. "Default",' B+ ^, d' ]8 U! A; c0 S7 S9 `
  37. "3 States",/ f( I8 T+ w; b# q) x
  38. "Box XL",
    3 A6 y9 r9 K% K7 w3 O+ r# w9 |
  39. "Box XXL"
    : h) I1 l: f7 N
  40. };
    8 R/ t. ]# ]: y) q

  41. & w" F/ w/ h, n7 B2 Y, ]/ @* d
  42. /*********************************************************************
    ! F: }* j. o6 w0 _) X6 L
  43. *' k* u4 [1 v0 l4 U
  44. *       Static code3 o/ c+ Q# ^) h2 o; B8 I, C
  45. *$ O9 c: Q% i+ [
  46. **********************************************************************7 \: [% q" U* y7 W6 r# d
  47. */
    ' u) D( S/ {+ g' H) H( T- C1 G6 L
  48. /*********************************************************************! o( L. u/ a) p& q
  49. *+ g& F) @& I! U, U) |3 G) Y
  50. *       _cbCallback
    / S. l6 u, m8 H9 R
  51. */% b8 p4 l6 q5 [) ]! J7 K
  52. static void _cbCallback(WM_MESSAGE * pMsg) {
    / ?& L9 t/ M, z2 P- K# Q
  53.   WM_HWIN hDlg;( K5 o( s! |/ t; ]1 Z
  54.   WM_HWIN hItem;
    ) l5 S& b4 D( Q8 W, `
  55.   int     i;
    ( ~( i6 \- G/ w  p
  56.   int     NCode;) q. G* i6 y5 n' p' y* f( w
  57.   int     Id;: }* [' v" ^8 @! O7 I/ }

  58. " E9 N$ x8 |+ `4 E  W
  59.   hDlg = pMsg->hWin;8 y- |3 T/ n1 [" i/ {0 k( G
  60.   switch (pMsg->MsgId) {
    1 p7 O; X; X- ]/ d! e
  61.     case WM_INIT_DIALOG:* G  V7 p3 b- n- c8 D" }5 u
  62.       WM_GetDialogItem(hDlg, GUI_ID_CHECK0);
    , _( K- w  T0 }& u
  63.       for (i = 0; i < 8; i++) {(3)
    - Q  P" O: M: z$ [5 _
  64.         int Index = i % 4;# O) m4 Y; K; X
  65.         hItem = WM_GetDialogItem(hDlg, GUI_ID_CHECK0 + i); // Get the handle of the desired checkbox
    . r& S$ b* Y: C* V5 p+ U5 ~4 G! u
  66.         CHECKBOX_SetText(hItem, _apLabel[Index]);          // Set the check box text(4)
    . n2 |' u! m, s1 ?. |9 I; p2 e
  67. ) T. R# _! f  J! D  |
  68.         switch (Index) {$ g4 J2 t1 i8 K) P  ]' K: \8 P
  69.         case 1:(5): k$ [' c3 K0 {- {, |
  70.           //
    $ S$ m# d6 E& S/ P
  71.           // Set the number of possible states to 3
    7 g1 q# G8 N3 f7 j$ z
  72.           //) o" K3 }. |8 {- |
  73.           CHECKBOX_SetNumStates(hItem, 3);(6)5 c' h  c5 z- p1 ~$ C
  74.           //$ B- Q- Z; Z6 H9 M) d
  75.           // Use user defined bitmaps for the third state
    3 e5 r, [" j$ h1 O0 v; U5 t
  76.           //(7)
    , g( T3 v  s) a5 E6 C
  77.           CHECKBOX_SetImage(hItem, &_abmBar[0], CHECKBOX_BI_INACTIV_3STATE);  // Used if widget is disabled
    1 X' t1 N- P) q
  78.           CHECKBOX_SetImage(hItem, &_abmBar[1], CHECKBOX_BI_ACTIV_3STATE);    // Used if widget is enabled
    5 \* i" Q: T3 d9 C' |. e' n
  79.           CHECKBOX_SetState(hItem, 2);(8)
    / p0 ?) Q) F% P8 ?+ \/ G
  80.           break;4 k. X/ t" z1 @% [! S2 \& m2 n
  81.         case 2:(9)4 [9 g( R. V! E2 [
  82.           CHECKBOX_SetState(hItem, 1);/ Z2 I6 E) M9 \) E6 s( D4 b- {
  83.           //
    & N- g9 n; `0 }
  84.           // Use user defined bitmaps for the 'checked' state1 S  P) R  G6 P+ o
  85.           //
    ! p+ ^( W2 P, [* Y4 r: k
  86.           CHECKBOX_SetImage(hItem, &_abmXL[0], CHECKBOX_BI_INACTIV_CHECKED);  // Used if widget is disabled, {) z6 x6 ]1 X) x  W6 ~. }
  87.           CHECKBOX_SetImage(hItem, &_abmXL[1], CHECKBOX_BI_ACTIV_CHECKED);    // Used if widget is enabled
    7 j- Q' n* C/ u; l6 D
  88.           CHECKBOX_SetFont(hItem, &GUI_FontComic18B_ASCII);2 v0 I+ J, w' }5 Q" b8 m- S
  89.           break;0 u6 Z$ H& W; Y2 v, u: O
  90.         case 3:(10)7 V, |  A) B& }
  91.           CHECKBOX_SetState(hItem, 1);
    8 v4 f/ q) l/ A0 {0 O
  92.           /// P- H$ m! W! d2 w+ v2 T' c# Q
  93.           // Use user defined bitmaps for the 'checked' state& j, S! S& `; i3 {# Q! g
  94.           //3 V, ~* W4 k# h1 ^
  95.           CHECKBOX_SetImage(hItem, &_abmXXL[0], CHECKBOX_BI_INACTIV_CHECKED); // Used if widget is disabled- V8 O8 R& u, Z; [/ m0 G/ J5 N
  96.           CHECKBOX_SetImage(hItem, &_abmXXL[1], CHECKBOX_BI_ACTIV_CHECKED);   // Used if widget is enabled
    7 @- |9 c% }1 f8 D7 v: N* @( a, j' R
  97.           CHECKBOX_SetFont(hItem, &GUI_FontComic24B_ASCII);& e; s/ F& _) z) _" ]0 V1 B
  98.           break;
    2 m9 u  X7 e8 G6 x* {
  99.         }
    * [/ J' m* n6 e; I( u7 k4 b; C; e
  100.         //0 V5 P9 w. v' v1 H9 \  f# y5 m# R, ^
  101.         // Disable all check boxes shown on the right side of the dialog
    . d4 d  |1 H& K' ^( `
  102.         //' m6 X. ?7 [% Y2 k3 e
  103.         if (i >= 4) {(11)) k. ~# {  \0 d0 L
  104.           WM_DisableWindow(hItem);/ e* ]2 W) i8 {7 F- K% ?7 b
  105.         }5 p( ^4 z2 v9 t3 }1 X
  106.       }& A1 v5 T& j) @
  107.       break;
    ! r8 R$ A8 {# z3 M7 F
  108.     case WM_NOTIFY_PARENT:
    4 j: S# z2 ], b7 ^; y" s& O
  109.       Id    = WM_GetId(pMsg->hWinSrc);      // Id of widget7 \: k$ h9 k& {) `
  110.       NCode = pMsg->Data.v;                 // Notification code# D& H2 F- j: W  A6 @
  111.       switch (NCode) {! w( F% w4 z+ A6 |$ X" c; M' f
  112.         case WM_NOTIFICATION_RELEASED:      // React only if released4 V8 Y' @( d) j; L
  113.           if (Id == GUI_ID_OK) {            // OK Button
    ; B/ b  {( h* a  |. J2 O9 x
  114.             GUI_EndDialog(hDlg, 0);  K! [5 i' y2 ^3 C" N
  115.           }5 h/ ?9 M' O% O, [! G
  116.           if (Id == GUI_ID_CANCEL) {        // Cancel Button
    , I6 l+ `7 }8 f+ c8 w  n- z9 L
  117.             GUI_EndDialog(hDlg, 1);
    4 `3 ~" F  i: L9 ]/ s1 s1 c( R
  118.           }& V& |9 \( e5 @5 T
  119.           break;8 X1 p9 |- I1 _7 A0 s! @
  120.       }& [6 T" e1 Y, j! K' {
  121.       break;, p. a4 s* d3 A. {# u+ f
  122.     default:. R. ]; N! H( Y0 V' W5 ?' Q0 A) B
  123.       WM_DefaultProc(pMsg);
    8 o/ X& U/ k# N  Y
  124.   }  q  C2 f( ^% f* o) d% x6 h' V
  125. }
    ' O! U  s, O8 g* B; i  J
  126. ; R: ~" e3 I# K' {: J
  127. /*********************************************************************) |; N# s/ v) X  w7 H" s  w
  128. *. A* h* c7 X- m7 }$ I/ U
  129. *       Public code! G/ K- o. B3 f  r' z
  130. *
    ) M# {# m$ d, U( ~/ p; s+ x5 ]
  131. **********************************************************************6 B# b) A3 T: @
  132. */% l% ^# g1 k: p1 h! R
  133. /*********************************************************************7 j3 }; \( Y, |% p- b
  134. *. A$ h* @1 ?: {0 s% m
  135. *       MainTask' g1 a6 G) V3 |5 n. J
  136. */
    7 Z- {# l5 x  L4 s, K
  137. void MainTask(void) {
    & ~! O" o' K1 ]/ {' J
  138.   #if GUI_SUPPORT_MEMDEV: H0 t! r9 m& h/ h
  139.     WM_SetCreateFlags(WM_CF_MEMDEV);' m7 A* Y. b6 d6 }) u1 L; \
  140.   #endif7 c5 C; M: {# Q  @' J
  141.   GUI_Init();
    3 I/ w# K9 R6 A2 Q( `
  142.   WM_SetDesktopColor(GUI_BLACK);$ t; L9 I2 M5 r+ G( R
  143.   while (1) {
    ! q- u( @& z$ |, V  N
  144.     GUI_ExecDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
    2 f5 k5 g4 Z3 g* Z
  145.     GUI_Delay(500);
    # n0 h5 v' K+ D) I& q/ I1 A
  146.   }
    6 A: i2 |# {- [0 M- T/ m+ ?  I
  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.4.png
41.3 总结
    本期教程主要是跟大家讲解了复选框控件的使用,希望大家可以把本期教程中讲的这个例子跑跑,然后自己设计一个相关的例子进行试验学习。教程中只是使用了部分的复选框API,其它的API大家都可以试试。
+ X+ ]. u; X: P1 j2 E
赞 收藏 评论7 发布时间:2015-2-28 11:08

举报

7个回答
feel-376797 回答时间:2015-2-28 11:33:29
谢谢分享
wamcncn 回答时间:2015-2-28 14:18:40
教程真多啊,学的比教的忙
MouseCat 回答时间:2015-2-28 14:36:03
收藏了,谢谢
wyxy163@126.com 回答时间:2015-2-28 16:21:18
提示: 作者被禁止或删除 内容自动屏蔽
wyxy163@126.com 回答时间:2015-2-28 16:21:37
提示: 作者被禁止或删除 内容自动屏蔽
lkl0305 回答时间:2015-2-28 20:40:35
多谢分享
埃斯提爱慕 回答时间:2015-3-1 16:03:57
提示: 作者被禁止或删除 内容自动屏蔽
关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版