特别说明:完整STemWin的1-60期教程和配套实例下载地址:链接7 E1 |4 w- B, |& b" @' o% _( u
第47章 LISTBOX-列表框控件
' m: M& K9 M8 ?. e 本期教程讲解STemWin支持的列表框控件。 47. 1 列表框控件介绍 47. 2 官方WIDGET_ListBox实例 47. 3 对话框上使用列表控件 47. 4 总结 47.1 列表框控件介绍 列表框用于选择列表的一个元素。创建的列表框可以没有环绕的框架窗口,如下所示,或者作为FRAMEWIN控件的子窗口建立。列表框中的项目被选定后,会突出显示。注意,所选项目的背景色取决于列表框窗口是否有输入焦点。 47.1.1 列表框支持的通知代码 以下事件是列表框控件作为WM_NOTIFY_PARENT消息的一部分发送给其父窗口的: | | | | | | WM_NOTIFICATION_MOVED_OUT | 列表框已被点击,且指针已从列表框处移开,没有释放。 | WM_NOTIFICATION_SCROLL_CHANGED | | WM_NOTIFICATION_SEL_CHANGED | | 47.2 官方WIDGET_ListBox实例 官方的这个实例很好的演示了LISTBOX的使用,这个例子在模拟器中的位置: 源码如下(程序中进行了详细的注释): - ----------------------------------------------------------------------- H$ D9 n0 \9 F, U# h H$ u F
- File : WIDGET_ListBox.c
8 o E2 D" \. ~" E7 X ? - Purpose : Example demonstrating the LISTBOX widget& [! i+ J. _1 @# q7 H) y9 T
- ----------------------------------------------------------------------/ d7 ?/ C- V; N- O% @7 A8 V
- */# E* I1 P4 _! I6 k( N- G& V7 ?
-
7 U1 z9 y+ }& n - #include "GUI.h"' y; @$ k& e* Y. a* I
- #include "FRAMEWIN.h"
! k6 Y+ e2 b2 P8 u) Q - #include "LISTBOX.h"# R' p+ [, f5 {0 @# W/ X5 q9 R+ I" x7 s
- #include <stddef.h>; [* v5 N3 x1 M" i
-
# b9 v E o& Y4 ?0 W - #define SPEED 1000
, o& K% X; P, E# S2 j/ L - * m% G! z) i# |5 E1 D7 h5 w
- /*******************************************************************6 r9 U7 d% z0 b
- *# K* ], G8 z1 N. V }: n
- * static variables) J; m# H$ v, {$ m6 N' I* h! N: ^
- *4 {' @" R' N4 g1 [7 X
- ********************************************************************
' v6 q( B5 Q2 U0 M - */
( _: e" j' n6 _' N2 A8 A/ }( ` -
% i- k6 Y# T8 C# m: g/ L - static const GUI_ConstString _ListBox[] = {
$ u3 l8 @' A, ~5 `' M4 c - "English", "Deutsch", NULL
* [3 u) ], \( x. N" D - };
. O8 l5 C x. K5 Y! b+ c -
" Q+ `1 e4 o1 i6 g7 H. ] G - /*******************************************************************# h- W# }: d! t! r
- *
* {9 Z8 J$ K7 A - * _ShowSeveralFunctions
7 G2 f- X) x: P - */7 b8 S9 b. {- X
- static void _ShowSeveralFunctions(LISTBOX_Handle hListBox) {
3 U. @8 o: \# h4 E2 |1 n - int NumEntries, i;* _) G9 _8 V0 \$ k0 r n7 s$ V) B" R
-
2 N" U2 u8 I1 I - /* 增加垂直滚动条 */
! Z$ C& Y/ J* Z2 Y% I! I' R - GUI_DispStringAtCEOL("SCROLLBAR_CreateAttached", 5, 55);
3 W# G7 y/ M1 |8 S( D4 ^. m - GUI_Delay(SPEED);
' a7 M( R% C O - SCROLLBAR_CreateAttached(hListBox, SCROLLBAR_CF_VERTICAL);
1 x$ U3 Q8 X) R, {0 J - GUI_Delay(SPEED * 0.75);* ]9 y% x8 C5 W% S2 D N% R3 l& x
- ! U8 z2 L, \& |: ^1 \/ e" q% w
- /* 增加字符串 */- J+ `4 B3 @, v. P- S& `& a; a
- GUI_DispStringAtCEOL("LISTBOX_AddString", 5, 55);
: c6 p0 H6 o2 n- C/ l. {+ D1 r4 Y; u - GUI_Delay(SPEED);
! b& i; o& ]+ l- V( j6 w - LISTBOX_AddString(hListBox, "Fran鏰is");
/ V2 s0 o* P/ n/ s! @7 F2 L - GUI_Delay(SPEED / 6);
: W' _9 C& {5 {& D* y) A - LISTBOX_AddString(hListBox, "Japanese");4 V; V1 [1 J9 V$ [& k: S5 E. y
- GUI_Delay(SPEED / 6);, ?/ d6 a' F# s; E+ u3 ~% c
- LISTBOX_AddString(hListBox, "Italiano");
' _& K( g4 R4 {' R - GUI_Delay(SPEED / 6);0 y7 Y9 K; W6 F1 s% e0 G7 }+ j
- LISTBOX_AddString(hListBox, "Espa駉l");- [5 }" z( t& j
- GUI_Delay(SPEED / 6);, x3 b4 D' U6 n3 s
- LISTBOX_AddString(hListBox, "Other language ...");
6 h" t* E1 F) S9 ~. I3 [7 O - GUI_Delay(SPEED * 0.6);
# g) |5 R6 p; W* B$ E3 M - % b) @) C9 U0 P( {
- /* 设置输入焦点 */! O3 r$ l/ A4 j
- GUI_DispStringAtCEOL("WM_SetFocus", 5, 55);3 z0 O: k; L- k* L! P
- GUI_Delay(SPEED * 0.9);1 z! {2 f; { U, G0 q
- WM_SetFocus(hListBox);% c: |3 b7 }" ]" b2 M
- GUI_Delay(SPEED * 0.7);: j( @+ E% h' s! s5 u! G1 |) i
- ' A6 l1 Z+ A( O( k
- /* 设置字体 */
' x+ l/ M4 C: u( {8 \0 l - GUI_DispStringAtCEOL("LISTBOX_SetFont", 5, 55);0 R4 k; i$ ~ y- S; D
- GUI_Delay(SPEED * 0.9);1 ]4 g3 X' M7 `/ d+ a) S# [) }
- LISTBOX_SetFont(hListBox, &GUI_Font13B_1);* w2 C. r; m0 ?, F
- GUI_Delay(SPEED * 0.7);
) X3 C/ f, w: H: j6 X -
0 u, T+ o: v7 x! W: ]. T; A- R - /* 增加选项 */
5 d L- z b6 u8 e - GUI_DispStringAtCEOL("LISTBOX_IncSel", 5, 55); k3 k. M% B) y9 W' X
- GUI_Delay(SPEED);
5 g6 h4 z2 B' m( Y - NumEntries = LISTBOX_GetNumItems(hListBox);2 m$ Y* L4 G( h
- for (i = 0; i < NumEntries - 1; i++) {
2 K, J# C4 n2 m% ~5 y - LISTBOX_IncSel(hListBox);
& }6 {* H* K- a7 R - GUI_Delay(SPEED / 6);
1 a4 [' E, ]$ Y( j5 ]0 E M5 Y - }
4 n6 [" Y+ c+ ^5 @' Y - GUI_Delay(SPEED / 4);
. a! E' f" b6 x. d4 c& r5 h - / _4 i) m8 y9 t: D p' H
- 0 X- v+ L8 Y" V1 s/ P7 i
- /* 自动增加滚动条 */5 J6 k( g0 ]5 P7 @$ |& n6 F" F
- GUI_DispStringAtCEOL("Optional automatic scrollbar", 5, 55);9 C, J6 C5 M2 `3 w/ p/ A+ p
- GUI_Delay(SPEED);
9 {3 b+ P& X# U/ f - LISTBOX_SetAutoScrollH(hListBox, 1);
% K* A8 |9 A0 T* b' o - LISTBOX_SetAutoScrollV(hListBox, 1);
" S$ |. v) m# i2 v2 i - GUI_Delay(SPEED * 0.75);# e T' Q/ m7 B8 Q* A' ]6 v% j7 C) X
-
v |) S8 F$ v1 h* A7 O6 \; L( q( ], _ - . o, t' q4 e2 O
- /* Set font */% c: B, c- m* z) q! a
- /* 设置字体 */
1 y0 V% D% {5 a7 O$ `. x - GUI_DispStringAtCEOL("LISTBOX_SetFont", 5, 55);( A/ e% u$ {. s0 e2 |3 L, I
- GUI_Delay(SPEED);
3 X$ A/ v% J A - LISTBOX_SetFont(hListBox, &GUI_Font16B_1);& B; G& o: K4 F! K) m1 L$ {& N8 m. ?9 Q( y
- GUI_Delay(SPEED * 0.75);$ H: I% H1 l' V6 l; _" P
-
6 O6 j) u% |9 E( o - /* 递增选择 */
" K! J: p. h' w& C! H; G - GUI_DispStringAtCEOL("LISTBOX_DecSel", 5, 55);, E6 E# x3 T) v8 C. r
- GUI_Delay(SPEED);
% |, \2 Y% v1 S - for (i = 0; i < NumEntries - 1; i++) {: ^ {( O9 d% U% e1 o
- LISTBOX_DecSel(hListBox);
; r4 Q9 ?1 o) n) R0 ?% @1 j - GUI_Delay(SPEED / 6);0 v$ r& S( ?- h* m
- }
5 b% \$ o0 X1 y- b$ _ - GUI_Delay(SPEED / 4);
0 M1 h( c6 J T- O6 A8 V -
6 o9 @# N8 w2 z' M - /* 更改滚动条的属性 */6 s% v' r) R9 g$ c2 n5 N- g& P4 k
- GUI_DispStringAtCEOL("Change scrollbar width", 5, 55);
; S9 q7 ]; P& e8 c4 n4 ~ e' h - GUI_Delay(SPEED * 0.7); [* V( z# _$ x& \$ j
- { @- W; {8 Q0 D+ O
- /* 得到滚动条的句柄 从而去修改滚动条的属性 */5 }0 p9 }( _$ j$ z) U1 ^
- SCROLLBAR_Handle hScrollH = WM_GetDialogItem(hListBox, GUI_ID_HSCROLL);
' v4 U, l* [5 X* Y/ }. J4 T+ ~: D - SCROLLBAR_Handle hScrollV = WM_GetDialogItem(hListBox, GUI_ID_VSCROLL);1 ?0 A9 ^ S* V% x% ?
- SCROLLBAR_SetWidth(hScrollV, 14);7 S8 U: Z0 M- a
- GUI_Delay(SPEED / 4);
7 _5 P( L6 e* N& Q - SCROLLBAR_SetWidth(hScrollH, 14);0 a3 ^* v7 x; P
- GUI_Delay(SPEED * 0.6);; ?1 J" U( q- o/ E+ P1 Y. h
- }
# U) L N' {2 k; h - $ P/ ^5 _! Q: L0 K2 h2 C
-
) c4 Y5 B' E6 A e - /* 设置列表框的大小 */3 _; Q: C& E) ^6 U/ V
- GUI_DispStringAtCEOL("Change size of listbox", 5, 55);
: m6 `/ i3 [0 i, j - GUI_Delay(SPEED * 0.75);
3 H; x- u9 N5 I& _ - WM_ResizeWindow(hListBox, -15, 0);
% h' C& ]2 _3 s8 t$ P3 o - GUI_Delay(SPEED / 4);
1 q/ u: I/ y7 X$ e0 z - WM_ResizeWindow(hListBox, 0, -15);( f5 w* I$ ]6 ~9 c# a) D
- GUI_Delay(SPEED / 4);
! [5 a0 g9 y7 k, D4 S. W, a) @. B - WM_ResizeWindow(hListBox, 15, 0);
" J" w- k5 A1 ^ - GUI_Delay(SPEED / 4);* b, l0 o3 e6 g0 Z5 {- V# d
- WM_ResizeWindow(hListBox, 0, 15);
1 \2 N! }' W# K3 U7 K: y# ~ - GUI_Delay(SPEED / 2);
8 Z) c' D: p9 d6 F$ R7 P) J. E -
; e; \ G' H# t. e6 h8 j& ^ j -
% r5 N7 N+ P+ L- s* _ h) ~ - /* 设置相应的项目禁能 注意0是第一个项目 */% T( ?; v6 e; b5 d, v5 Z
- GUI_DispStringAtCEOL("LISTBOX_SetItemDisabled", 5, 55);9 |$ u1 N( `3 ?" W3 L
- GUI_Delay(SPEED);3 a" Z6 U( A- L: N0 _* f& Y
- LISTBOX_SetItemDisabled(hListBox, 4, 1);
( m% m% [& i0 _+ Q5 B - GUI_Delay(SPEED * 0.75);7 E9 Y6 ~ }6 z) n3 D
- % ?, U' z7 n8 d1 `
- % L9 o q. G$ l! r* ^ o5 O/ j
- /* 设置使能多个项目的选择 */. }% C" O i4 i! S6 B
- GUI_DispStringAtCEOL("LISTBOX_SetMulti", 5, 55);, J! O4 r3 @* Z+ G0 D
- GUI_Delay(SPEED);
2 p6 h$ y: C! F" E - LISTBOX_SetMulti(hListBox, 1);6 @' Z" Z" B, `, z* n" y
- GUI_Delay(SPEED * 0.75);
8 L9 b6 ^8 x/ i, K - n0 T- U" @5 R5 b
- /* 选择项目 */( K. g# D7 ^; V$ E! y) O" f8 I8 y
- GUI_DispStringAtCEOL("LISTBOX_SetItemSel", 5, 55);
2 K8 y. c/ X. Q5 [, |. _1 p* c - GUI_Delay(SPEED);, }) C" K7 M h& I7 ]+ q( O5 U6 o4 k
- LISTBOX_SetItemSel(hListBox, 0, 1);
) Q6 c5 h& [% b9 `+ x0 f# t% B - GUI_Delay(SPEED / 4);/ C/ B2 w' [+ X9 {
- LISTBOX_SetItemSel(hListBox, 1, 1);
4 r6 L1 J& M4 e! y2 o8 } - GUI_Delay(SPEED / 4);
- C: W1 j' |5 X, Z9 C - LISTBOX_SetItemSel(hListBox, 2, 1);2 H5 o/ d ?0 Q/ L" P. S. U
- GUI_Delay(SPEED * 0.8);
; D) _+ h4 g& q8 v$ W4 g1 l# N, i - 1 j' x& A/ Q& I5 O
- /* 删除列表框 */
8 }$ x# u3 e2 O( ]+ V ]$ {- { - GUI_DispStringAtCEOL("LISTBOX_Delete", 5, 55);) W9 {7 l9 F4 m* @
- GUI_Delay(SPEED * 1.1);
) s* n# O/ c8 \& B8 d' z' { - LISTBOX_Delete(hListBox); b. ]% T7 x2 ]6 s8 @! e
- GUI_Delay(SPEED * 0.75);
- x3 @" x2 r* h3 j8 l l6 c+ w* | - }9 k4 p7 b f! F- x. W5 f
-
, @- M+ w7 P, @4 E - /*******************************************************************" a( @; k! R2 ]
- *
: O" A' j4 P9 I/ t8 K1 U- j6 J - * _DemoListBox5 F' v g( W8 d* J" ?/ N9 w1 J5 ?
- */
! P& x( o/ ?6 X7 I1 R0 K - static void _DemoListBox(void) {, ]$ J9 R5 ~4 w8 t1 i- |5 ^' M
- LISTBOX_Handle hListBox;/ M: ]* t3 U+ k/ Y, p
- 8 P- d& B% B: T9 [: }
- /* 显示标题 */
' t4 Q* ?/ D# D5 n9 ~& F3 @4 @3 w - GUI_SetBkColor(0xB00000);
) W1 C0 Y5 q- x8 b! ^' t& J: Y - GUI_SetColor(0xFFFFFF);0 |2 n/ L# ], t* B+ p6 {
- GUI_SetFont(&GUI_Font24_ASCII);. B) ?* G# z& z, ]# B
- GUI_DispStringHCenterAt("Listbox - Sample", 160, 5);
) P* N- X3 w; g" d3 w3 O - GUI_Delay(SPEED / 2);+ b. w, u) C4 p$ o0 i0 }
-
0 L# c) Q! U0 w3 a! o' ? - /* 创建列表框 */
- Y7 A+ q4 U( b/ k9 K5 y5 ? - GUI_SetFont(&GUI_Font8x16);
) ^2 G1 f1 a. L% d. i - GUI_SetTextAlign(GUI_TA_LEFT);
1 U8 x, I$ H9 m9 z' j) s/ \7 | - GUI_DispStringAtCEOL("using", 5, 40);
8 h) m3 [: o0 h1 w7 l) o# n - GUI_DispStringAtCEOL("LISTBOX_Create", 5, 55);
# x3 g# G' R( V - GUI_Delay(SPEED * 0.9);" _' i K1 X: S3 O2 O! C$ s* i+ @
- hListBox = LISTBOX_Create(_ListBox, 100, 80, 120, 115, WM_CF_SHOW);% _ Q, G( ]1 {. P: G4 t9 w1 r
- GUI_Delay(SPEED * 0.75);( T! F7 o4 Y: r7 \) F+ I. g4 m
-
' w! b5 @% X# Z/ r$ F3 ? - /* 功能演示 */
- A: h6 `6 Z2 c9 c - _ShowSeveralFunctions(hListBox);
+ n1 }/ `' \4 D; Y+ `& f( T - /* Clear display */' I6 Q5 U+ D j! n/ k; Z& D6 S
- GUI_Clear();* [8 g$ b% ~3 p! n# s2 Z
- GUI_Delay(SPEED * 1.5);
% q9 k7 i4 e$ p- g. g: m - }
7 ]) |8 {# X- _) }: m6 y - ) _" Z8 m: Z' Z1 s0 H+ a. U! J
- /*******************************************************************
6 h8 | a0 O6 j4 u; j% K. X: @5 z - *
i2 E8 Q1 [1 x6 F5 Y& X- y - * _DemoListBoxAsChild2 ^! |: H3 c+ N, @+ {0 Z
- */" r" v9 o2 ]% O# c5 Z
- static void _DemoListBoxAsChild(void) {( y+ S8 P, k* m a1 L: Q$ A
- FRAMEWIN_Handle hFrame;( W* Z* b9 w1 `! n5 r" z1 a K
- LISTBOX_Handle hListBox;
9 T3 B. S4 ~$ _, j - : N, ?+ G9 ^& Y X4 u' [
- /* 显示标题 */; w! H; L2 Z# y; B1 M8 K" Z
- GUI_SetBkColor(0xB00000);" B$ T% w& i t; u* t
- GUI_SetColor(0xFFFFFF);
% z0 x7 z6 p$ I( b: L; O* o( i6 K/ Y, n2 S - GUI_SetFont(&GUI_Font24_ASCII);' d1 H2 F$ K+ P7 |* z2 O
- GUI_DispStringHCenterAt("Listbox as child - Sample", 160, 5);+ L; l+ t" Z. ^0 C
- GUI_Delay(SPEED / 2);7 x- v- T+ l7 z9 H4 o
-
, H7 e. v& a. `5 q$ Y: L( l - /* 创建窗口框架 */$ E7 \2 k/ z; N1 l
- GUI_SetFont(&GUI_Font8x16);% d. {! { c+ ]' m* P9 s- ?
- GUI_SetTextAlign(GUI_TA_LEFT);
5 T/ m, Q. P5 e - GUI_DispStringAtCEOL("using", 5, 40);
* p/ J1 N+ q6 I* e$ K. d/ L - GUI_DispStringAtCEOL("FRAMEWIN_Create", 5, 55);3 z$ ~7 ^/ I% q- M
- GUI_Delay(SPEED);
" ]7 i1 F: F/ w6 Q1 c - hFrame = FRAMEWIN_Create("List box", NULL, WM_CF_SHOW, 100, 80, 120, 140);/ R8 C. h; }3 A1 V5 { L! A
- FRAMEWIN_SetFont(hFrame, &GUI_Font16B_ASCII);
1 q3 I- C; s; L+ ?, S& F - FRAMEWIN_SetActive(hFrame, 1);+ Z. D* i$ M( l; I
- GUI_Delay(SPEED * 0.75);
. ]; w; G/ t1 v6 Z! c -
8 ~3 l" K$ k& d3 U1 P5 N" `2 b - ) X" S6 O: Y1 x& R7 k; @
- /* 创建列表框 */* f0 `) k' C' L8 S3 o1 k8 `
- GUI_DispStringAtCEOL("LISTBOX_CreateAsChild", 5, 55);
+ o3 Z5 [, a* z7 O - GUI_Delay(SPEED);
- D0 v% H$ H6 a2 }% ]! P - /* 其实坐标0,0,水平和垂直的大小如果设置为0的话,那么将默认为父窗口的用户区大小 */
; D+ ^- J. u, t7 @! J6 u( _7 [ - hListBox = LISTBOX_CreateAsChild(_ListBox, WM_GetClientWindow(hFrame), 0, 0, 0, 0, WM_CF_SHOW);+ M% F" L! w7 |3 x! J4 h
- GUI_Delay(SPEED * 0.75);
: N, |( D( |6 a& e6 L& M8 A - ) g! h! t7 S( F% E9 \; q; {
- _ShowSeveralFunctions(hListBox);# M, s' a7 U/ G
-
% g8 ]7 a) z5 s, W5 c/ L5 M - /* 删除框架窗口*/8 e: x6 S/ I7 W1 h6 K7 r9 O
- GUI_DispStringAtCEOL("FRAMEWIN_Delete", 5, 55);
% D& R8 F- M3 G) P" B2 [3 H1 d - GUI_Delay(SPEED);
2 y# \/ p% Q4 ^, o1 {/ z" o - FRAMEWIN_Delete(hFrame);, m' _& G8 _: ], m& c3 R
- GUI_Delay(SPEED * 0.75);% G. k" R9 f' m* Z+ S% }5 n
- . O) g; q9 J- E1 ~/ b7 B# R
- /* 清除显示 */
5 G3 r7 O% x% E: e8 ? - GUI_Clear();: o" `2 p6 V5 X8 ?( ]3 d. ~
- GUI_Delay(SPEED * 1.5);, i7 F! }% H" |1 r9 c
- }2 s+ [5 N [. h
- ) q9 V- M3 T( h+ s R
- /*******************************************************************
6 O C' A5 @, c0 s. u! v5 s - *9 N+ S/ z$ \0 @2 X h) u* T
- * MainTask
; I! Y/ a+ @+ Y6 o5 f5 `3 M - *
R* ` m! y% g8 Q( \# S( ~2 c - * Demonstrates LISTBOX widget
8 L$ j* C+ w" h9 X3 a" | - *
- ?9 c: K" T# x& p - ********************************************************************
! \$ [+ D! ~. n# j1 h, e3 g% S - */
6 \9 q4 A# v4 H/ ~! M3 R. o2 U1 f a - $ Y' A" e! Y. {0 y* W) x$ G. i: R# [
- void MainTask(void) {
- e0 J t9 @ L0 v5 l6 _ - GUI_Init();/ ]6 J" ]5 `( H/ o+ r6 W6 A
- WM_SetDesktopColor(0xB00000);
6 z, V0 M, G/ ]4 _; z) i - GUI_Exec();
1 q& D& Z3 \+ G4 S: q7 D2 v. N - while(1) {
0 D$ ~7 h# l+ m$ x1 d - _DemoListBox();0 o- u, k# T( t! q
- _DemoListBoxAsChild();( v( R+ D0 a- Q3 [
- }
$ n. ^& |8 |) Q# U- i - }
复制代码这个例子的实际现象效果如下: 47.3 对话框上使用列表框控件 用uCGUIBulder4.0建立如下界面(分辨率480*272): 为列表框添加成员的方法如下: 将生成的代码直接复制到模拟器或者开发板上面运行,实际显示效果如下(生成的代码在本期教程配套的例子中): 47.4 总结 本期教程主要是跟大家讲解了列表框控件的使用,希望大家可以把本期教程中讲的这两个例子跑跑,然后自己设计一个相关的例子进行试验学习。教程中只是使用了部分的列表框控件API,其它的API大家都可以试试。
& {' |4 {; J; t# p& p C |