特别说明:完整STemWin的1-60期教程和配套实例下载地址:链接; V. Z; C. B) g3 j% k3 m1 x
第44章 FrameWin-框架窗口控件 % @( C. U5 a5 Z( v; A
本期教程讲解STemWin支持的框架窗口控件。 44. 1 框架窗口控件介绍 44 2 官方WIDGET_FrameWin实例 44. 3 总结 44.1 框架窗口控件介绍 框架窗口为您的应用提供一个PC应用程序的窗口外观。这些窗口由周围框架、标题栏和用户区组成。标题栏的颜色改变以显示窗口是否激活,如下图所示: 如下图所示,可将预定义的按钮附加到标题栏,也可将自己的按钮附加到标题栏: 设置皮肤后显示效果如下: 44.1.1 框架窗口的结构 下图显示了框架窗口的详细结构和外观: 框架窗口实际上由2种窗口组成;主窗口和子窗口。子窗口称为客户端窗口。处理回调函数时意识到此点非常重要:存在具有2种不同回调函数的2种窗口。创建子窗口时,这些子窗口通常作为客户端窗口的子窗口而创建;它们的父窗口因此是客户端窗口。 | | | | | | | | | | | 客户端窗口是一个单独的窗口,作为框架窗口的子窗口创建。 | 44.2 官方WIDGET_FrameWin实例 官方的这个实例简单的演示了FrameWin的部分功能,这个例子在模拟器中的位置: 源代码如下: - #include <stddef.h>* i) g" S' N" j/ Q i
- #include <string.h># y- O/ K" ]4 m+ Y
- #include "GUI.h"
1 o$ a' ~7 @5 m* D! E& ^9 A) G* a - #include "FRAMEWIN.h"
O7 v& n8 G$ S Z0 Z0 I. e( v5 p, c - - H7 g. q4 V5 s9 }& c
- /*********************************************************************1 G T- H1 b( b$ T( P
- *
5 _4 s2 P8 K3 p$ T6 n, s: q$ B - * Defines
& Z4 A& ?; f* A; s. W3 D. T - *) h# Z% z: |2 M- b3 v
- **********************************************************************
7 X& l$ S; s: [: H$ l, ]* V5 m - */; p3 G( @, ?" t$ D X3 J* J
- #define SPEED 1200* R+ S2 Y; q: O; r. O7 ~
-
6 n- w- R, v" x! G - #define MSG_CHANGE_MAIN_TEXT (WM_USER + 0) (1)
/ L: v" ]4 Y/ T6 i - # s: m1 b/ c- r( \- ?
- /*********************************************************************: I( i8 p' j; w1 k g
- *( ], h+ A/ }9 u1 y0 }+ W
- * Static data& ?$ c* u* v( R0 c) e6 g4 Q
- *
* w% I' [8 ^" g - **********************************************************************
a; l- N6 H. M% K$ c. A - */: V) v1 ?$ w: M2 q: X- Z. ]4 m+ y
- static FRAMEWIN_Handle _hFrame;5 D7 S+ Z! P# _8 ~
- static WM_CALLBACK* _pcbOldFrame;/ M5 `$ S/ d9 i6 I0 ?, X
- static char _acMainText[100];
$ H5 m/ \8 L* @' Z - static int _LockClose = 1;& y1 y" x/ R8 V$ d Z7 `8 x) e
-
8 z3 z. \" V) l0 O- W - /*******************************************************************
, x8 y1 L2 `6 c+ b. [" c+ g - *
: m: q. {0 t: X - * Static code$ K# r# a6 ]5 G R4 R1 O3 r8 u, A
- *. `. d* |( z. g) H$ g# R
- ********************************************************************% k8 g5 _2 d% S; j
- */ Y# R( p( _+ k8 Y
- /*******************************************************************
9 ?5 [' O3 V0 s+ }; P - *
# r* ]- Q, l" B' i- w% ^ - * _ChangeMainText: F2 I, h5 }5 t9 P2 O; n
- *% c, Y' y/ W; F: g# ^ B
- * Sends a message to the background window and invalidate it, so/ [! ]2 ]; [- `, {
- * the callback of the background window display the new text.
. Z3 G# i' _& c# h# H, R3 Z/ H' { - */& v+ E8 C! f* `5 B5 j0 v$ z6 T
- static void _ChangeMainText(char* pStr, int Delay) {(2)9 u* o" F$ g) I; _
- WM_MESSAGE Message;
8 f- Z" x! |0 k: ^& F - Message.MsgId = MSG_CHANGE_MAIN_TEXT;$ { q8 K% g( w! u7 P
- Message.Data.p = pStr;
- w t4 n1 A6 M9 v' J+ i - GUI_Delay(Delay);* h! w$ @: a/ e# }: ?) T$ P- k
- WM_SendMessage(WM_HBKWIN, &Message);( T) D$ u) J- Y% x: M
- WM_InvalidateWindow(WM_HBKWIN);. }- ?6 I2 h! G: R
- GUI_Delay(Delay/3);5 q# e8 |! a9 q2 p3 S) T
- }/ n) }' @# z' j7 ^/ p2 T$ e9 N) t! N# `
- % I* o' x; ]- I& H7 A2 ~' h
- /*******************************************************************
) w O% u/ l7 h- P - *
9 D X L7 e, O- n - * _cbChild
! `7 ^7 t# U6 D9 I" w( s( |: o8 s - */
; S* `: a/ \- [2 g - static void _cbChild(WM_MESSAGE * pMsg) {(3)9 ^9 l& p5 Q( ?9 P
- WM_HWIN hWin = (FRAMEWIN_Handle)(pMsg->hWin);7 D& a+ v3 b2 F7 Z; u# a) i- I
- switch (pMsg->MsgId) {& B! H, ?# ~5 {# ]) t: g. l
- case WM_PAINT:
# L. w1 G" s4 [$ }2 o - //
% [9 V+ V3 d' E) u% L) }" j. S: |3 P - // Handle the paint message9 |3 W- r; h6 g( W9 O
- //
g$ C/ n5 k& ~+ E- G - GUI_SetBkColor(GUI_WHITE);
% ?, {) q g' [8 j+ C - GUI_SetColor(GUI_BLACK);. v; A! j# H( {& @* W: R& Y7 A% t
- GUI_SetFont(&GUI_FontComic24B_ASCII);
4 ]' R# O; i" S - GUI_SetTextAlign(GUI_TA_HCENTER | GUI_TA_VCENTER);
" S/ x+ k$ Q) q# K1 n' X3 b$ [ \; _ - GUI_Clear();+ V# i- n5 C" I+ w! a3 p
- GUI_DispStringHCenterAt("Client window", - ?' R1 A& C% s' ^
- WM_GetWindowSizeX(hWin) / 2, . O- x2 c7 f- [: v# @9 u
- WM_GetWindowSizeY(hWin) / 2);0 N* g. a, P" b3 h
- break;
7 Q& |% K% [& F* O& T/ `- M% l - default:0 G; ?+ X% `: x$ z2 G0 s: }
- WM_DefaultProc(pMsg);
9 N3 g; z2 l5 Z' i0 H: q) H1 M - }
2 j8 O( @' p! z$ z# Y4 |+ {7 \- Z - }
7 _7 G5 L0 r: \" u - 6 U# |* i: \* a& J& w) [
- /*******************************************************************
1 [0 W$ w2 f; ^& p V6 N - *
3 |5 V& v$ R. k3 c1 V" [- O - * _cbFrame
; _9 e. s- ?4 o2 S/ E) v - */% y! r- L i) c; X; a
- static void _cbFrame(WM_MESSAGE * pMsg) { (4)
& c o- i7 o- j+ `7 i6 M" g - switch (pMsg->MsgId) {
; x9 l( i1 b G0 _1 h - case WM_NOTIFY_PARENT:
) i, i5 I1 `- K) O3 X u% H% t - if (pMsg->Data.v == WM_NOTIFICATION_RELEASED) {
3 y4 K8 L2 e- @; I3 L2 Z - int Id = WM_GetId(pMsg->hWinSrc); // Id of widget
0 F/ c. j2 Q6 z5 d8 F* |# M6 _ - if (Id == GUI_ID_CLOSE) {
2 M. N8 G7 p7 n* ~+ d: V - if (_LockClose) {8 `5 m* E% |! C% r% T
- return;6 |$ a7 A' a9 J! `" b
- }
' Q! t1 p, ?- l, d0 s - _hFrame = 0;
$ j# ]: ?! p( [5 ?) l - }4 K+ d m. f2 i8 B( }+ m
- }
* S6 \; e% ?! j* y - break;
+ |2 \1 M* R5 H& S! f - }
4 u; ^, {/ y" c$ R3 c( O0 A* D - if (_pcbOldFrame) {
( r8 G- l( e; K- s - (*_pcbOldFrame)(pMsg);& Y9 F- Q6 B/ j" _. u2 i) t. ]1 a
- }
/ @- a1 d' J1 y ?0 X- x& b - }, k1 U( E0 m; h3 m4 _5 l& `+ R1 x
- 9 m- K# i0 d' F
- /*******************************************************************
4 n6 G1 N& W1 c: [+ l - *
% R% {' c: [! N$ h8 s/ X# W+ o" a - * _cbBkWindow" j' [( G, q0 Y' j
- * s. j, Q9 E: M$ F
- * Function description
+ d- C7 q4 h! N* ?9 v) X - * This callback is necessary to redraw the background when: d+ _9 v! U* }0 E4 G3 u5 B2 e
- * frame window is moved: w2 V; Z3 e1 A* [; r+ q! x0 V: p
- */
, u( m3 ^. I$ p8 k - static void _cbBkWindow(WM_MESSAGE * pMsg) {(5)
& l- e$ i" d' ] - switch (pMsg->MsgId) {8 ?! A) W$ s7 I7 d s
- case MSG_CHANGE_MAIN_TEXT:! ^, `7 s- K' P: B, {5 U% o
- strcpy(_acMainText, (char const *)pMsg->Data.p);
N- T( }+ X0 _* n1 y! y - WM_InvalidateWindow(pMsg->hWin);% b8 s% S8 q+ r- g3 M* ~
- break;0 g v: `9 t& L
- case WM_PAINT:
9 s2 M: P' F* F( j - GUI_SetBkColor(GUI_BLACK);
9 E$ K2 L- A+ V0 n. j - GUI_Clear();' H! e" q& [+ n0 o; T4 P
- GUI_SetColor(GUI_WHITE);0 _( q' F, @# U: z9 Q
- GUI_SetFont(&GUI_Font24_ASCII);
5 |; `" d- \: g, j2 Z - GUI_DispStringHCenterAt("WIDGET_FrameWin - Sample", 160, 5); X' y% W( @! w5 c! m6 ?5 a8 v* ? N
- GUI_SetFont(&GUI_Font8x16); z! M. j* K3 j! k& \
- GUI_DispStringHCenterAt(_acMainText, 160, 40);
5 u* d0 N Q# N - GUI_SetFont(&GUI_Font6x8);7 U0 ~4 X! ^3 P5 P0 U. E3 T
- GUI_DispStringHCenterAt("The function FRAMEWIN_Create creates both the\n"
/ T$ r1 c3 ] {8 ] - "frame window and the client window.", 160, 190);
7 _2 k4 \# p$ x% B7 Z6 J/ U6 q; r - break;
9 e# `0 E j$ v& w# { - default:
$ m- S& g- f3 v+ e6 M; [ - WM_DefaultProc(pMsg);
! X) M2 X0 g& J8 K/ A* \* \ - }! ]6 {! b. v7 ~" f1 ~- t
- }
& t# H, h9 T" @0 m - # B, }& b% [3 m( s2 \2 j) F
- /*******************************************************************
4 c- q b/ x+ t5 o6 Z - *
! E+ I( [ `2 |9 C - * _DemoFramewin; x8 B# q3 O7 O- Z' g2 h
- *
0 v7 B& I, m% t - * Function description! e! R! {* t: q+ }
- * Creates the frame window and sets the callback for frame, child
6 I2 R- a, v* x; O/ P - * and background window8 h! m2 [$ Z- R8 A( e+ K% V! _
- */! G0 g, m5 W' I: W) h
- static void _DemoFramewin(void) {(6)' z+ E! x1 s: J. H. a9 u/ B
- int i;
+ a8 l# q; g: e) i; l5 _ - char acInfoText[] = "-- sec to play with window";
+ Y& ^3 ~1 Y( L3 K/ H - WM_HWIN hChild;
5 W$ {( K9 R2 b - & O) D& w9 M/ `; r9 d7 Q# T
-
3 v, S; P+ N) r! e& }, K! ? - WM_SetCallback(WM_HBKWIN, _cbBkWindow);
! N7 w: O/ G6 I; k P5 a. w - // r8 M; W3 S" x4 `+ ~7 a/ w, r
- // Create and configure frame window
( r. ~4 w: ~8 g s* A - //
! c% p1 e0 ]4 ~4 x - _ChangeMainText("FRAMEWIN_Create", SPEED);
/ e9 M ]% ^$ ]8 M) j5 F& u - _hFrame = FRAMEWIN_Create("Frame window", 0, WM_CF_SHOW, 50, 75, 220, 100);(7)
9 [: {- C+ o9 R x2 F2 |8 W% M - _pcbOldFrame = WM_SetCallback(_hFrame, _cbFrame);(8)
! U- X: s7 r+ b" T9 F: l3 w/ Z+ w - hChild = WM_GetClientWindow(_hFrame);(9)
8 U0 t" H- Q3 H. L - WM_SetCallback(hChild, _cbChild);(10). H1 m q" w0 h- R
- FRAMEWIN_SetMoveable(_hFrame, 1);(11)' B0 V- } E( X3 Z7 P2 B# I5 d
- //
( [( ]% v- m; q% o2 {# G# ]+ S6 S - // Create buttons3 B* f, i9 E" ?0 v" \
- //5 }* {: B% W: N$ X
- FRAMEWIN_AddCloseButton(_hFrame, FRAMEWIN_BUTTON_LEFT, 0);(12)
: W* b& O# a) g* j4 \( |% z - FRAMEWIN_AddMaxButton(_hFrame, FRAMEWIN_BUTTON_RIGHT, 0);
0 [1 H2 M D) o3 j: V: J# P# E0 R - FRAMEWIN_AddMinButton(_hFrame, FRAMEWIN_BUTTON_RIGHT, 2);- b; E8 ?: D! u# Q$ X
- //( i$ z9 [# e3 P; F* k, J
- // Modify frame window attributes
) C: G2 A" m& }+ P - //& ?5 Y b8 ^0 ^! M. g
- _ChangeMainText("FRAMEWIN_SetActive", SPEED); _8 e7 {0 c, e6 z
- FRAMEWIN_SetActive(_hFrame, 1);(13)
, `. T! m; m) A: @' t2 A9 e$ g - _ChangeMainText("FRAMEWIN_SetFont", SPEED);
. S( c" p- I2 A7 _ - FRAMEWIN_SetFont(_hFrame, &GUI_Font16B_ASCII); (14)+ p" h- `1 ]6 U3 s( e
- FRAMEWIN_SetTitleHeight(_hFrame, 20);" _: |7 A j8 M% ]
- _ChangeMainText("FRAMEWIN_SetTextColor", SPEED);2 z L! t8 [& T0 l- f
- FRAMEWIN_SetTextColor(_hFrame, GUI_YELLOW); (15)
3 C3 b6 w# f: f4 @& W2 D - _ChangeMainText("FRAMEWIN_SetTextAlign", SPEED);
7 h' Z5 \8 A; k2 j9 G+ i. q - FRAMEWIN_SetTextAlign(_hFrame, GUI_TA_HCENTER);(16)$ E0 w/ U* J+ K: m+ b
- _ChangeMainText("FRAMEWIN_Minimize", SPEED);2 `7 U, J' ?) y; r+ e
- FRAMEWIN_Minimize(_hFrame);(17)5 l0 y; S) [' z' n$ m
- _ChangeMainText("FRAMEWIN_Maximize", SPEED);
) n' Z7 V7 q1 z - FRAMEWIN_Maximize(_hFrame); (18)7 H# [ P! R5 h, q4 J: {' {4 x
- _ChangeMainText("FRAMEWIN_Restore", SPEED);
* z% N, r( y% g6 t# Q4 E - FRAMEWIN_Restore(_hFrame);(19)$ r5 N+ S$ `4 w2 _/ q0 V
- _ChangeMainText("FRAMEWIN_SetTitleVis", SPEED);
6 F: Z; _" v" v; y: ]' s5 X+ u6 l - for (i = 0; i < 5; i++) {
1 j9 d, K7 f) F0 V' d, Z/ {$ g - FRAMEWIN_SetTitleVis(_hFrame, 0); (20)
" h3 ~) V& X: P/ B5 t - GUI_Delay(200);& V0 ?2 @6 G% b- G$ ?
- FRAMEWIN_SetTitleVis(_hFrame, 1);( Y" n7 @% V, Z: L! X
- GUI_Delay(200);
4 b3 p6 b0 N$ Z2 j - }
3 k6 f: m' B1 y* u# t - //
% H2 w4 x& i8 R2 ~+ N$ y - // Time to play with frame window X/ ^5 j; E/ b
- //% \$ z) {% E2 N$ G: T0 h
- _LockClose = 0;8 d) X. h5 X! B% b5 q8 k4 p @2 H
- for (i = 250; (i > 0) && _hFrame; i--) {: j7 z: h( l9 M# d& }9 z. o
- acInfoText[0] = '0' + ((i + 9) / 100);
2 A+ ?. ?( N) s7 C - acInfoText[1] = '0' + (((i + 9) / 10) % 10);
/ O2 g) n3 E& L% A: k C) H - _ChangeMainText(acInfoText, 0);8 B' M+ M- T6 ]2 c! C
- GUI_Delay(100);
8 Z/ @* D* ^+ ~+ N! w - }
2 _ r. d$ @% m* z5 q- ~ - if (_hFrame) {
: t* \1 J% I: V- V4 p- u$ L - _ChangeMainText("FRAMEWIN_Delete", SPEED);
$ W/ g" m0 x+ z2 m7 y/ d) E - FRAMEWIN_Delete(_hFrame);(21)1 i4 ?0 I8 Q' T# ?$ \# ~$ J
- } else {1 _ l0 R1 R$ [( e. a( d! C
- _ChangeMainText("", 50);' y- G' w1 z' B1 |; h1 q
- }
; g8 n" i: E# a* J% B$ b - }) u% q; V4 m7 _) b& R {6 l
-
# f. o O, [$ m3 C C6 Q7 Z) O - /*********************************************************************
$ b" z2 L1 b) [/ d$ q x - */ k# K5 g. d7 `$ s5 _% S7 P
- * Public code. f- g5 z" m" t. j6 B
- *7 b, Z5 z9 i" A$ ^5 j6 e1 _# D
- **********************************************************************
0 `1 Q" y7 ?2 h2 d5 |0 T9 \ - */
& E9 u7 e: Y/ K# x/ w - /*********************************************************************
1 f- R. A" b) t" C% ]3 q7 O - *0 h$ O! g8 x# U/ d) ~* ]% j
- * MainTask6 c( T& K5 ~3 e5 e5 j
- */* Z; h# T! f% b9 j* N
- void MainTask(void) {! {9 u4 D7 W5 t( W$ p& k% X3 a
- GUI_Init();1 V8 x$ Y) G9 T' `4 |) @9 D
- WM_EnableMemdev(WM_HBKWIN); (22)' W, Q( Z' ^7 x6 S; I8 D* E
- while(1) {7 O( s c( \2 f1 p- I* W
- _DemoFramewin();; G: x- O6 ]9 _
- }8 Y* W5 N2 _6 q# p; h# d, t5 [
- }
复制代码1. 自定义的一个回调消息类型。 2. 用于给桌面窗口发送自定义的回调函数消息类型。发送后将桌面窗口变得无效,然后系统就会去执行桌面窗口回调函数中的WM_PAINT消息。 3. 框架窗口中客户窗口的回调函数。 4. 框架窗口的回调函数。 5. 桌面窗口的回调函数。 6. 框架窗口中部分API函数的演示函数。 7. 创建框架窗口。 8. 设置框架窗口的回调函数。 9. 得到框架窗口中客户端窗口句柄。 10. 设置客户端窗口的回调函数。 11. 设置框架窗口可移动。 12. 为框架窗口添加最小化,最大化和关闭按钮。 13. 激活框架窗口。 14. 设置框架窗口中标题的字体。 15. 设置框架窗口中标题的颜色。 16. 设置框架窗口中标题文本的对齐。 17. 最小化框架窗口。 18. 最大化框架窗口。 19. 恢复最小化或最大化的框架窗口。 20. 设置框架窗口的标题可见。 21. 删除框架窗口。 22. 使能桌面窗口的内存设备。 这个例子中变量_LockClose的作用也很重要,它的主要作用就是在演示框架窗口时锁住关闭按钮,防止在演示的时候,用户点击了关闭按钮。大家也特别注意框架窗口回调函数_cbFrame的处理。 实际显示效果如下: 44.3 总结 本期教程主要是跟大家讲解了框架窗口的使用,希望大家可以把本期教程中讲的这个例子跑跑,然后自己设计一个相关的例子进行试验学习。教程中只是使用了部分的框架窗口API,其它的API大家都可以试试。 ( e1 D3 o: P9 S5 I1 X
|