特别说明:完整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.1 复选框支持的通知代码 以下事件是复选框控件作为WM_NOTIFY_PARENT消息的一部分发送给其父窗口的: | | | | | | WM_NOTIFICATION_MOVED_OUT | | WM_NOTIFICATION_VALUE_CHANGED | | 41.1.2 按钮支持键盘反应 如果控件具有输入焦点,则它将对下列各键做出反应: 41.2 官方WIDGET_CheckBox实例 官方的这个例子做的很好,充分的演示了复选框的各个状态。这个例子在模拟器中的位置: 源代码如下(主要看WIDGET_Checkbox中的代码): - #include <stddef.h>/ |* C6 c7 O, p( t
- #include "GUI.h"7 l1 z! a2 f% N) n- t
- #include "DIALOG.h"
6 Z4 S, P5 A: T% m4 W7 W `5 y - #include "Main.h", i" `/ o Z3 a
-
3 m. F x9 x+ w$ t8 R/ n9 B* m - /*********************************************************************% i7 K' F' D/ o0 S3 x
- *
7 i/ r* Q" L0 [/ R - * Static data
3 J3 m, w7 V5 C# L$ K8 t - *% E. z% j4 o7 T7 |
- **********************************************************************
! a2 B5 G2 u0 M+ y - */! {0 D9 r& C0 k; P( H/ @' z8 c
-
% A# Y' Y: t, p, v8 } - //
5 Z* E0 N( _. s5 o+ R5 b# t - // Dialog resource
& A; x) C2 O/ R7 X - //
6 f9 r: N; y K+ s# { - static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {(1)
/ T! r/ j/ i+ ~* N! v2 r7 Z) Z$ q. q - { FRAMEWIN_CreateIndirect, "Check box sample", 0, 10, 10, 300, 220, FRAMEWIN_CF_MOVEABLE},9 h/ J) ~) X$ q6 A m1 a; d
- { TEXT_CreateIndirect, "Enabled:", 0, 5, 10, 120, 0 },
' [$ r5 b* A& z0 ~( y& m$ } - { CHECKBOX_CreateIndirect, 0, GUI_ID_CHECK0, 5, 30, 120, 0 },& t" Z8 t4 x5 b; g8 V8 W1 P
- { CHECKBOX_CreateIndirect, 0, GUI_ID_CHECK1, 5, 60, 120, 0 },
# A+ @: b* o3 Z: Z - { CHECKBOX_CreateIndirect, 0, GUI_ID_CHECK2, 5, 90, 120, 20 },
3 T4 o( o- m1 j8 T6 X+ B" [ - { CHECKBOX_CreateIndirect, 0, GUI_ID_CHECK3, 5, 125, 120, 26 },
) S; v9 n+ ^. X0 v- J! ^( w" z" P - { TEXT_CreateIndirect, "Disabled:", 0, 150, 10, 120, 0 },+ _7 \) g( Q. r9 }+ ?# F3 w
- { CHECKBOX_CreateIndirect, 0, GUI_ID_CHECK4, 150, 30, 120, 0 },3 g( U% _3 W; ^( b
- { CHECKBOX_CreateIndirect, 0, GUI_ID_CHECK5, 150, 60, 120, 0 },
' h# p) \# r5 ]2 @6 t - { CHECKBOX_CreateIndirect, 0, GUI_ID_CHECK6, 150, 90, 120, 26 },0 a+ \' W% r9 y* o5 p8 m# g Z
- { CHECKBOX_CreateIndirect, 0, GUI_ID_CHECK7, 150, 125, 120, 26 },% s" L+ Y9 K- {) R
- { BUTTON_CreateIndirect, "OK", GUI_ID_OK, 10, 170, 60, 20 },2 [' V( e/ ]6 ?2 O3 B
- { BUTTON_CreateIndirect, "Cancel", GUI_ID_CANCEL, 225, 170, 60, 20 },/ |! u* L" o5 L0 s( v5 O/ S
- };$ p3 P8 N+ C( T6 I" Z7 u
- + O; T2 [ a! s4 i
- //3 ^. q, B3 x O
- // Check box text: @; g& \7 i7 l
- //
7 P ~5 \/ v8 B9 J$ Q - static const char * _apLabel[] = {(2)" j9 D; b7 o* s* w" |6 F
- "Default",' B+ ^, d' ]8 U! A; c0 S7 S9 `
- "3 States",/ f( I8 T+ w; b# q) x
- "Box XL",
3 A6 y9 r9 K% K7 w3 O+ r# w9 | - "Box XXL"
: h) I1 l: f7 N - };
8 R/ t. ]# ]: y) q -
& w" F/ w/ h, n7 B2 Y, ]/ @* d - /*********************************************************************
! F: }* j. o6 w0 _) X6 L - *' k* u4 [1 v0 l4 U
- * Static code3 o/ c+ Q# ^) h2 o; B8 I, C
- *$ O9 c: Q% i+ [
- **********************************************************************7 \: [% q" U* y7 W6 r# d
- */
' u) D( S/ {+ g' H) H( T- C1 G6 L - /*********************************************************************! o( L. u/ a) p& q
- *+ g& F) @& I! U, U) |3 G) Y
- * _cbCallback
/ S. l6 u, m8 H9 R - */% b8 p4 l6 q5 [) ]! J7 K
- static void _cbCallback(WM_MESSAGE * pMsg) {
/ ?& L9 t/ M, z2 P- K# Q - WM_HWIN hDlg;( K5 o( s! |/ t; ]1 Z
- WM_HWIN hItem;
) l5 S& b4 D( Q8 W, ` - int i;
( ~( i6 \- G/ w p - int NCode;) q. G* i6 y5 n' p' y* f( w
- int Id;: }* [' v" ^8 @! O7 I/ }
-
" E9 N$ x8 |+ `4 E W - hDlg = pMsg->hWin;8 y- |3 T/ n1 [" i/ {0 k( G
- switch (pMsg->MsgId) {
1 p7 O; X; X- ]/ d! e - case WM_INIT_DIALOG:* G V7 p3 b- n- c8 D" }5 u
- WM_GetDialogItem(hDlg, GUI_ID_CHECK0);
, _( K- w T0 }& u - for (i = 0; i < 8; i++) {(3)
- Q P" O: M: z$ [5 _ - int Index = i % 4;# O) m4 Y; K; X
- 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 - CHECKBOX_SetText(hItem, _apLabel[Index]); // Set the check box text(4)
. n2 |' u! m, s1 ?. |9 I; p2 e - ) T. R# _! f J! D |
- switch (Index) {$ g4 J2 t1 i8 K) P ]' K: \8 P
- case 1:(5): k$ [' c3 K0 {- {, |
- //
$ S$ m# d6 E& S/ P - // Set the number of possible states to 3
7 g1 q# G8 N3 f7 j$ z - //) o" K3 }. |8 {- |
- CHECKBOX_SetNumStates(hItem, 3);(6)5 c' h c5 z- p1 ~$ C
- //$ B- Q- Z; Z6 H9 M) d
- // Use user defined bitmaps for the third state
3 e5 r, [" j$ h1 O0 v; U5 t - //(7)
, g( T3 v s) a5 E6 C - CHECKBOX_SetImage(hItem, &_abmBar[0], CHECKBOX_BI_INACTIV_3STATE); // Used if widget is disabled
1 X' t1 N- P) q - CHECKBOX_SetImage(hItem, &_abmBar[1], CHECKBOX_BI_ACTIV_3STATE); // Used if widget is enabled
5 \* i" Q: T3 d9 C' |. e' n - CHECKBOX_SetState(hItem, 2);(8)
/ p0 ?) Q) F% P8 ?+ \/ G - break;4 k. X/ t" z1 @% [! S2 \& m2 n
- case 2:(9)4 [9 g( R. V! E2 [
- CHECKBOX_SetState(hItem, 1);/ Z2 I6 E) M9 \) E6 s( D4 b- {
- //
& N- g9 n; `0 } - // Use user defined bitmaps for the 'checked' state1 S P) R G6 P+ o
- //
! p+ ^( W2 P, [* Y4 r: k - CHECKBOX_SetImage(hItem, &_abmXL[0], CHECKBOX_BI_INACTIV_CHECKED); // Used if widget is disabled, {) z6 x6 ]1 X) x W6 ~. }
- CHECKBOX_SetImage(hItem, &_abmXL[1], CHECKBOX_BI_ACTIV_CHECKED); // Used if widget is enabled
7 j- Q' n* C/ u; l6 D - CHECKBOX_SetFont(hItem, &GUI_FontComic18B_ASCII);2 v0 I+ J, w' }5 Q" b8 m- S
- break;0 u6 Z$ H& W; Y2 v, u: O
- case 3:(10)7 V, | A) B& }
- CHECKBOX_SetState(hItem, 1);
8 v4 f/ q) l/ A0 {0 O - /// P- H$ m! W! d2 w+ v2 T' c# Q
- // Use user defined bitmaps for the 'checked' state& j, S! S& `; i3 {# Q! g
- //3 V, ~* W4 k# h1 ^
- CHECKBOX_SetImage(hItem, &_abmXXL[0], CHECKBOX_BI_INACTIV_CHECKED); // Used if widget is disabled- V8 O8 R& u, Z; [/ m0 G/ J5 N
- 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 - CHECKBOX_SetFont(hItem, &GUI_FontComic24B_ASCII);& e; s/ F& _) z) _" ]0 V1 B
- break;
2 m9 u X7 e8 G6 x* { - }
* [/ J' m* n6 e; I( u7 k4 b; C; e - //0 V5 P9 w. v' v1 H9 \ f# y5 m# R, ^
- // Disable all check boxes shown on the right side of the dialog
. d4 d |1 H& K' ^( ` - //' m6 X. ?7 [% Y2 k3 e
- if (i >= 4) {(11)) k. ~# { \0 d0 L
- WM_DisableWindow(hItem);/ e* ]2 W) i8 {7 F- K% ?7 b
- }5 p( ^4 z2 v9 t3 }1 X
- }& A1 v5 T& j) @
- break;
! r8 R$ A8 {# z3 M7 F - case WM_NOTIFY_PARENT:
4 j: S# z2 ], b7 ^; y" s& O - Id = WM_GetId(pMsg->hWinSrc); // Id of widget7 \: k$ h9 k& {) `
- NCode = pMsg->Data.v; // Notification code# D& H2 F- j: W A6 @
- switch (NCode) {! w( F% w4 z+ A6 |$ X" c; M' f
- case WM_NOTIFICATION_RELEASED: // React only if released4 V8 Y' @( d) j; L
- if (Id == GUI_ID_OK) { // OK Button
; B/ b {( h* a |. J2 O9 x - GUI_EndDialog(hDlg, 0); K! [5 i' y2 ^3 C" N
- }5 h/ ?9 M' O% O, [! G
- if (Id == GUI_ID_CANCEL) { // Cancel Button
, I6 l+ `7 }8 f+ c8 w n- z9 L - GUI_EndDialog(hDlg, 1);
4 `3 ~" F i: L9 ]/ s1 s1 c( R - }& V& |9 \( e5 @5 T
- break;8 X1 p9 |- I1 _7 A0 s! @
- }& [6 T" e1 Y, j! K' {
- break;, p. a4 s* d3 A. {# u+ f
- default:. R. ]; N! H( Y0 V' W5 ?' Q0 A) B
- WM_DefaultProc(pMsg);
8 o/ X& U/ k# N Y - } q C2 f( ^% f* o) d% x6 h' V
- }
' O! U s, O8 g* B; i J - ; R: ~" e3 I# K' {: J
- /*********************************************************************) |; N# s/ v) X w7 H" s w
- *. A* h* c7 X- m7 }$ I/ U
- * Public code! G/ K- o. B3 f r' z
- *
) M# {# m$ d, U( ~/ p; s+ x5 ] - **********************************************************************6 B# b) A3 T: @
- */% l% ^# g1 k: p1 h! R
- /*********************************************************************7 j3 }; \( Y, |% p- b
- *. A$ h* @1 ?: {0 s% m
- * MainTask' g1 a6 G) V3 |5 n. J
- */
7 Z- {# l5 x L4 s, K - void MainTask(void) {
& ~! O" o' K1 ]/ {' J - #if GUI_SUPPORT_MEMDEV: H0 t! r9 m& h/ h
- WM_SetCreateFlags(WM_CF_MEMDEV);' m7 A* Y. b6 d6 }) u1 L; \
- #endif7 c5 C; M: {# Q @' J
- GUI_Init();
3 I/ w# K9 R6 A2 Q( ` - WM_SetDesktopColor(GUI_BLACK);$ t; L9 I2 M5 r+ G( R
- while (1) {
! q- u( @& z$ |, V N - GUI_ExecDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
2 f5 k5 g4 Z3 g* Z - GUI_Delay(500);
# n0 h5 v' K+ D) I& q/ I1 A - }
6 A: i2 |# {- [0 M- T/ m+ ? I - }
复制代码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大家都可以试试。 + X+ ]. u; X: P1 j2 E
|