【STemWin教程】第23章 游标

席萌0209

特别说明：完整STemWin的1-60期教程和配套实例下载地址：链接

第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 = {
2. 138,                  // XSize
3.   65,                  // YSize
4.   69,                  // BytesPerLine
5.    4,                  // BitsPerPixel
6. acSeggerLogoBlue16,   // Pointer to picture data (indices)
7. &PalSeggerLogoBlue16  // Pointer to palette
8. };
10. static const GUI_CURSOR* _apCursor[] = { （1）
11. &GUI_CursorArrowS,  &GUI_CursorArrowM,  &GUI_CursorArrowL,
12. &GUI_CursorArrowLI, &GUI_CursorArrowMI, &GUI_CursorArrowSI,
13. &GUI_CursorCrossS,  &GUI_CursorCrossM,  &GUI_CursorCrossL,
14. &GUI_CursorCrossLI, &GUI_CursorCrossMI, &GUI_CursorCrossSI
15. };
17. static char* _aacCursorName[] = {
18. "GUI_CursorArrowS",  "GUI_CursorArrowM",  "GUI_CursorArrowL",
19. "GUI_CursorArrowLI", "GUI_CursorArrowMI", "GUI_CursorArrowSI",
20. "GUI_CursorCrossS",  "GUI_CursorCrossM",  "GUI_CursorCrossL",
21. "GUI_CursorCrossLI", "GUI_CursorCrossMI", "GUI_CursorCrossSI"
22. };
24. /*********************************************************************
25. *
26. *       Static code
27. *
28. **********************************************************************
29. */
30. /*********************************************************************
31. *
32. *       _MoveCursor
33. */
34. static void _MoveCursor(void) {（2）
35.   int x;
36.   int y;
37.   int tm;
38.   int cnt;
39.   int yStep;
40.   int xPos;
41.   int yPos;
43.   cnt  = 0;
44.   yStep=-1;
45.   xPos = LCD_GetXSize() / 2 - bmSeggerLogoBlue.XSize/2;
46.   yPos = LCD_GetYSize() / 2 - bmSeggerLogoBlue.YSize/2+25;
47.   GUI_DispStringHCenterAt("Cursor shape can be changed\nand the cursor can be moved", 160,  75);
48.   GUI_CURSOR_Show();  （3）
49.   GUI_DrawBitmap(&bmSeggerLogoBlue, xPos, yPos );
50.   y = 150;
51.   for (x = 0; x < 320; x++) {
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）
60.     while ((GUI_GetTime() - tm) < 10);
61.   }
62.   for (x = 320; x > 0; x--) {  （6）
63.     tm = GUI_GetTime();
64.     if ((x % 54) == 0) {
65.       GUI_CURSOR_Select(_apCursor[cnt++]);
66.     }
67.     y += yStep;
68.     if(y<=80) yStep=1;
69.     if(y>=150) yStep=-1;
70.     GUI_CURSOR_SetPosition(x, y);
71.     while ((GUI_GetTime() - tm) < 10);
72.   }
73.   GUI_CURSOR_Hide();  （7）
74.   GUI_Delay(500);
75. }
77. /*********************************************************************
78. *
79. *       _DispCursor
80. */
81. static void _DispCursor(void) {  （8）
82.   int i;
83.   int x;
84.   int y;
86.   GUI_DispStringHCenterAt("Available cursors:", 160,  80);
87.   for (i = 0; i < 12; i++) {
88.     x = 160 - (_apCursor[i]->pBitmap->XSize / 2);
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);
93.     GUI_ClearRect(0, 100, 319, 165);
94.   }
95.   GUI_ClearRect(0, 80, 319, 100);
96.   GUI_Delay(500);
97. }
99. /*********************************************************************
100. *
101. *       _DemoCursor
102. */
103. static void _DemoCursor(void) {
104.   GUI_SetBkColor(GUI_BLUE);
105.   GUI_Clear();
106.   GUI_SetColor(GUI_WHITE);
107.   GUI_SetFont(&GUI_Font24_ASCII);
108.   GUI_DispStringHCenterAt("CURSOR_Sample - Sample", 160, 5);
109.   GUI_SetFont(&GUI_Font8x16);
110.   while (1) {
111.     _DispCursor();
112.     GUI_ClearRect(0, 60, 319, 200);
113.     _MoveCursor();
114.     GUI_ClearRect(0, 60, 319, 200);
115.   }
116. }
118. /*********************************************************************
119. *
120. *       Public code
121. *
122. **********************************************************************
123. */
124. /*********************************************************************
125. *
126. *       MainTask
127. */
128. void MainTask(void) {
129.   GUI_Init();
130.   _DemoCursor();
131. }

复制代码

1. 大家要学会这种定义方法，这样在选择不同的游标时就非常的方便了，用下面这种方式即可
    for (i = 0；i<1 0; x++)
    {
    GUI_CURSOR_Select(_apCursor[i]);
    }
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程序显示效果如下：

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

1. /*********************************************************************
2. *
3. *       _DispCursor
4. */
5. static void _DispCursor(void) {
6.   int i;
7.   int x;
8.   int y;
10.   /* 动态游标的演示 */
11.   GUI_CURSOR_SelectAnim(&GUI_CursorAnimHourglassM);（1）
12.   GUI_Delay(5000);
13.   GUI_DispStringHCenterAt("Available cursors:", 160,  80);
14.   for (i = 0; i < 12; i++) {
15.     x = 160 - (_apCursor[i]->pBitmap->XSize / 2);
16.     y = 120 - (_apCursor[i]->pBitmap->YSize / 2);
17.     GUI_DrawBitmap(_apCursor[i]->pBitmap, x, y);
18.     GUI_DispStringHCenterAt(_aacCursorName[i], 160,145);
19.     GUI_Delay(750);
20.     GUI_ClearRect(0, 100, 319, 165);
21.   }
22.   GUI_ClearRect(0, 80, 319, 100);
23.   GUI_Delay(500);
25. }

复制代码

1. 添加这两行代码即可，让其显示5秒的时间。
    实际显示效果如下（游标是动态的，这里只贴了一幅图）：

    这个动态的游标也支持自定义图形，有兴趣的可以尝试。
23.4 总结
    游标显示的知识就跟大家讲这么多，相对来说比前面几期都要简单很多。