特别说明：完整STemWin的1-60期教程和配套实例下载地址：链接
; T. a) D% `+ q/ ^6 n$ s

第23章 游标

    本期教程比较简单，跟大家讲解一下游标的使用。在小型的嵌入式系统中，外接鼠标和键盘的情况比较少，所以游标的显示就显的不那么重要，不过在需要触摸校准的时候游标就比较重要了，可以帮助我们很方便的看出X,Y轴镜像和翻转问题。

    23. 1  STemWin支持的游标效果

    23. 2 模拟器上演示游标

    23. 3 模拟器上演示动态游标

    23. 4 总结

23.1 STemWin支持的游标效果

    当前emWin支持的游标效果就是上面几种，初始化emWin后是不显示游标的，需要调用函数GUI_CURSOR_Show()才会显示出来，显示出来的是GUI_CursorArrowM（中箭头）。要选择其它的箭头可以调用函数GUI_CURSOR_Select()进行选择其它的箭头。STemWin进入到5.22版本后加入了动态的游标，效果如下：

23.2 模拟器上演示游标

    官方有一个例子是专门的演示游标的，程序位置在：

    主要程序如下（数据部分没有贴出）：

1. static const GUI_BITMAP bmSeggerLogoBlue = {
   3 U9 r7 G8 i3 c0 W8 Y
2. 138,                  // XSize
   3 `2 g7 I2 J5 P% w
3.   65,                  // YSize
     c* Q8 Z) l2 z8 x  H$ ]* C, _
4.   69,                  // BytesPerLine
   8 [* C# Y; v" z5 I( y% S7 F
5.    4,                  // BitsPerPixel
   
6. acSeggerLogoBlue16,   // Pointer to picture data (indices)
   
7. &PalSeggerLogoBlue16  // Pointer to palette
   
8. };
   $ N* v6 a5 W  Q% h2 R; {
9. 
   ' C5 l) m9 u% E1 b/ e" a. I
10. static const GUI_CURSOR* _apCursor[] = { （1）
    9 u( ^4 B! j" i: t2 {" w
11. &GUI_CursorArrowS,  &GUI_CursorArrowM,  &GUI_CursorArrowL,
    + R. s, F& H4 c. ]* I
12. &GUI_CursorArrowLI, &GUI_CursorArrowMI, &GUI_CursorArrowSI,
    ! k) Y+ I3 c" I: H
13. &GUI_CursorCrossS,  &GUI_CursorCrossM,  &GUI_CursorCrossL,
    
14. &GUI_CursorCrossLI, &GUI_CursorCrossMI, &GUI_CursorCrossSI
    
15. };
    
16. 
    
17. static char* _aacCursorName[] = {
    * D# D' q$ Z! h$ h! w$ @* a2 ~
18. "GUI_CursorArrowS",  "GUI_CursorArrowM",  "GUI_CursorArrowL",
    
19. "GUI_CursorArrowLI", "GUI_CursorArrowMI", "GUI_CursorArrowSI",
    5 q/ f1 j* t0 U1 {3 ^
20. "GUI_CursorCrossS",  "GUI_CursorCrossM",  "GUI_CursorCrossL",
    : U% B  {0 Y% P! x3 c
21. "GUI_CursorCrossLI", "GUI_CursorCrossMI", "GUI_CursorCrossSI"
    
22. };
    8 |& a3 N; m) k: Y3 Q* n# \
23. 
    & h' {" @$ c) P8 m+ Z4 Z
24. /*********************************************************************
    
25. *
    9 H+ G! M  g8 `# j! t( t/ u
26. *       Static code
    
27. *
    
28. **********************************************************************
    
29. */
    
30. /*********************************************************************
    8 v! d- }% Y- R$ S. ?' N$ s
31. *
    
32. *       _MoveCursor
    
33. */
    
34. static void _MoveCursor(void) {（2）
    + |! q6 O& o9 E8 T
35.   int x;
    ! Y/ v6 j2 m3 K; i
36.   int y;
    , h* z9 p  Y; g3 q9 [
37.   int tm;
    ; b- X: M: |: n8 `% D/ q9 b
38.   int cnt;
    
39.   int yStep;
    : ]; P9 m# u2 A
40.   int xPos;
    4 n, r( I) F9 S4 t1 M" l
41.   int yPos;
    
42. 
    + n/ g8 u4 O& ?) k* N
43.   cnt  = 0;
    7 D+ G1 @6 n2 {! I7 E
44.   yStep=-1;
    - U$ C3 g7 J4 f  q
45.   xPos = LCD_GetXSize() / 2 - bmSeggerLogoBlue.XSize/2;
    - T1 G  L* X. w8 l
46.   yPos = LCD_GetYSize() / 2 - bmSeggerLogoBlue.YSize/2+25;
    : {9 d; Q4 \/ {* T
47.   GUI_DispStringHCenterAt("Cursor shape can be changed\nand the cursor can be moved", 160,  75);
    + _1 d; b2 \7 {; m
48.   GUI_CURSOR_Show();  （3）
    
49.   GUI_DrawBitmap(&bmSeggerLogoBlue, xPos, yPos );
    
50.   y = 150;
    7 e" H: `; U$ o) i5 n% m7 Q# y
51.   for (x = 0; x < 320; x++) {
    7 g( ]' [# r& ?. g( R% I7 M3 Z. K
52.     if ((x % 54) == 0) {
    
53.       GUI_CURSOR_Select(_apCursor[cnt++]); （4）
    
54.     }
    
55.     tm = GUI_GetTime();
    
56.     y += yStep;
    
57.     if(y<=80) yStep=1;
    
58.     if(y>=150) yStep=-1;
    
59.     GUI_CURSOR_SetPosition(x, y);（5）
    2 C( B! G" O8 _4 }
60.     while ((GUI_GetTime() - tm) < 10);
    
61.   }
    & c* N5 L2 Q  ^7 t8 s% k
62.   for (x = 320; x > 0; x--) {  （6）
    + V0 i* R0 y4 u, x! |3 x
63.     tm = GUI_GetTime();
    , S! A8 k8 A+ M  t+ F
64.     if ((x % 54) == 0) {
    1 C- W" O  j, L: B  ^
65.       GUI_CURSOR_Select(_apCursor[cnt++]);
    
66.     }
    8 @$ r) B8 ?* D6 s
67.     y += yStep;
    
68.     if(y<=80) yStep=1;
    : D7 f. i: h" O2 i& J
69.     if(y>=150) yStep=-1;
    9 O5 Y! P2 p; t) H
70.     GUI_CURSOR_SetPosition(x, y);
    
71.     while ((GUI_GetTime() - tm) < 10);
    
72.   }
    
73.   GUI_CURSOR_Hide();  （7）
    
74.   GUI_Delay(500);
    
75. }
    
76. 
    3 F% p: D3 a" z9 h
77. /*********************************************************************
    ( F1 M$ y. {, u, |
78. *
    / O: v* F: z5 V5 W+ H) ~* }1 K7 |
79. *       _DispCursor
    . ~) Y0 }* ?9 [' V
80. */
    + I3 O" }! ^# F6 P
81. static void _DispCursor(void) {  （8）
    $ M6 v* \7 H$ S/ ?; j, A6 N
82.   int i;
    
83.   int x;
    
84.   int y;
    : \! {, o  s, G! Y: J( A* H
85. 
    
86.   GUI_DispStringHCenterAt("Available cursors:", 160,  80);
    # o; O, [5 j- P) {" ]2 k
87.   for (i = 0; i < 12; i++) {
    ( B' M5 C3 p( Z0 I8 z
88.     x = 160 - (_apCursor[i]->pBitmap->XSize / 2);
    4 M! |- T* I% J( U% Q( c$ L
89.     y = 120 - (_apCursor[i]->pBitmap->YSize / 2);
    
90.     GUI_DrawBitmap(_apCursor[i]->pBitmap, x, y);
    
91.     GUI_DispStringHCenterAt(_aacCursorName[i], 160,145);
    
92.     GUI_Delay(750);
    9 N+ Z5 e: B1 H  @7 A
93.     GUI_ClearRect(0, 100, 319, 165);
    9 l5 e. y2 j' c  E8 `: k, s
94.   }
    
95.   GUI_ClearRect(0, 80, 319, 100);
    
96.   GUI_Delay(500);
    . f2 G  F1 `* U" g9 l
97. }
    
98. 
    
99. /*********************************************************************
    ; d* V4 C+ L6 G' R. t% E' T! v
100. *
     
101. *       _DemoCursor
     
102. */
     & \; Z* c7 H& o7 a9 ]
103. static void _DemoCursor(void) {
     
104.   GUI_SetBkColor(GUI_BLUE);
     ( P& `, l) |( t
105.   GUI_Clear();
     
106.   GUI_SetColor(GUI_WHITE);
     
107.   GUI_SetFont(&GUI_Font24_ASCII);
     
108.   GUI_DispStringHCenterAt("CURSOR_Sample - Sample", 160, 5);
     2 b9 X8 K4 J+ F5 P7 m
109.   GUI_SetFont(&GUI_Font8x16);
     
110.   while (1) {
     4 z5 n! O5 z4 u) `
111.     _DispCursor();
     
112.     GUI_ClearRect(0, 60, 319, 200);
     7 ^2 K3 M" ~* F% f5 i
113.     _MoveCursor();
     5 K6 F& B  N" R: U  p
114.     GUI_ClearRect(0, 60, 319, 200);
     
115.   }
     3 t0 x8 z2 S  Z# _% }0 D
116. }
     
117. 
     
118. /*********************************************************************
     
119. *
     - [' _. K1 X3 B2 N& b  [
120. *       Public code
     
121. *
     
122. **********************************************************************
     
123. */
     / c. H1 j  u/ b+ g0 }9 p- W! A+ @
124. /*********************************************************************
     + D0 V8 r9 z4 x3 B% D
125. *
     
126. *       MainTask
     % J% n/ ?; ?" x
127. */
     
128. void MainTask(void) {
     $ M+ q6 I/ N8 V0 P
129.   GUI_Init();
     
130.   _DemoCursor();
     
131. }

复制代码

1. 大家要学会这种定义方法，这样在选择不同的游标时就非常的方便了，用下面这种方式即可

    for (i = 0；i<1 0; x++)

    {

        GUI_CURSOR_Select(_apCursor);

}

2. 这个函数主要实现游标的移动效果。

3. GUI_CURSOR_Show()  显示游标。

4. GUI_CURSOR_Select() 设置指定的游标。

5. GUI_CURSOR_SetPosition() 设置游标位置。

6. 大家要学会这种延迟方法，这样可以实现准确的时间间隔

    for (x = 320; x > 0; x--)

    {

    tm = GUI_GetTime();

    //用户程序

    while ((GUI_GetTime() - tm) < 10);

    }

7. GUI_CURSOR_Hide() 隐藏游标。

8. 这个函数实现游标的轮番展示。其中GUI_CURSOR的定义如下：

    typedef struct {

        const GUI_BITMAP  * pBitmap;

        int                 xHot;

        int                 yHot;

    } GUI_CURSOR;

此DEMO程序显示效果如下：

+ _. p# u! q1 c' Q* Z/ F: X23.3 模拟器上演示动态游标

    只要对上面的例子稍作修改就可以显示动态游标，修改的地方如下：

1. /*********************************************************************
   8 S5 T, L3 ]* G% E+ k
2. *
   & a2 @( D. D$ A) s9 o2 ?/ ~
3. *       _DispCursor
   
4. */
   + o0 ]& D) Y9 R; e
5. static void _DispCursor(void) {
   , R, \9 b1 A  Q  ^, s. |" k
6.   int i;
   
7.   int x;
   
8.   int y;
   0 v- S7 |) U" \
9. 
   3 l$ L& U# R' ^+ L/ C
10.   /* 动态游标的演示 */
    ' u0 U% H  A$ x( [7 F
11.   GUI_CURSOR_SelectAnim(&GUI_CursorAnimHourglassM);（1）
    
12.   GUI_Delay(5000);
    
13.   GUI_DispStringHCenterAt("Available cursors:", 160,  80);
    , e& B* N, {- _- Q# r7 t0 `2 K
14.   for (i = 0; i < 12; i++) {
    / n' P4 U: p$ P! u7 ]
15.     x = 160 - (_apCursor[i]->pBitmap->XSize / 2);
    % P5 j- D# `7 K
16.     y = 120 - (_apCursor[i]->pBitmap->YSize / 2);
    1 h! Y8 C* J3 I1 H8 r
17.     GUI_DrawBitmap(_apCursor[i]->pBitmap, x, y);
    
18.     GUI_DispStringHCenterAt(_aacCursorName[i], 160,145);
    
19.     GUI_Delay(750);
      V+ J( J6 U' H, [) }
20.     GUI_ClearRect(0, 100, 319, 165);
    
21.   }
    
22.   GUI_ClearRect(0, 80, 319, 100);
    . l8 {0 D/ ]* ?- x% d* W- `( G; K" b8 c
23.   GUI_Delay(500);
    
24. 
    
25. }

复制代码

1. 添加这两行代码即可，让其显示5秒的时间。

    实际显示效果如下（游标是动态的，这里只贴了一幅图）：

    这个动态的游标也支持自定义图形，有兴趣的可以尝试。

23.4 总结

    游标显示的知识就跟大家讲这么多，相对来说比前面几期都要简单很多。

( _6 O/ P5 ?% h+ k0 e