【STemWin教程】第54章 SCROLLBAR-滚动条控件

席萌0209

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

第54章 SCROLLBAR-滚动条控件

    本期教程讲解STemWin支持的滚动条控件。
    54. 1滚动条控件介绍
    54. 2 官方DIALOG_Scrollbar实例
    54. 3 使用官方GUIBulder建立单选按钮控件
    54. 4 总结

54.1 滚动条控件介绍
    滚动条用于滚动列表框或任何其他类型的窗口。它们可以水平 （如下所示）或垂直创建。

通常，滚动条将附加到现有窗口，例如下图所示的列表框：

设置皮肤后显示效果如下：

54.1.1 滚动条支持的通知代码
    以下事件是滚动条作为WM_NOTIFY_PARENT消息的一部分发送给其父窗口的：

消息	描述
WM_NOTIFICATION_CLICKED	已单击滚动条。。
WM_NOTIFICATION_RELEASED	已释放滚动条。
WM_NOTIFICATION_SCROLLBAR_ADDED	滚动条刚刚被添加 （附加）至现有窗口。需要通知窗口，以便使其能初始化滚动条。
WM_NOTIFICATION_VALUE_CHANGED	滚动条的值可以通过移动缩略图或按下箭头按钮进行更改

54.1.2 滚动条支持的键盘反应
    如果控件具有输入焦点，则它将对下列各键做出反应：

按键	反应
GUI_KEY_RIGHT	将滚动条的当前值增加1。
GUI_KEY_DOWN	将滚动条的当前值增加1。
GUI_KEY_PGDOWN	将滚动条的当前值增加1页。
GUI_KEY_LEFT	将滚动条的当前值减小1。
GUI_KEY_UP	将滚动条的当前值减小1。
GUI_KEY_PGUP	将滚动条的当前值减小1页。

54.2 官方WIDGET_Scrollbar实例
    官方的这个实例很好的演示了scrollbar的使用，这个例子在模拟器中的位置：

源码如下（程序中进行了详细的注释）：

1. #include "GUI.h"
2. #include "SCROLLBAR.h"
3. #include "EDIT.h"
4. #include <stddef.h>
6. /*******************************************************************
7. *
8. *       defines
9. *
10. ********************************************************************
11. */
13. /* 制作行3列的方框*/
14. #define EDIT_MAX_X 10
15. #define EDIT_MAX_Y 3
17. /*******************************************************************
18. *
19. *       static variables
20. *
21. ********************************************************************
22. */
23. static EDIT_Handle _aahEdit[EDIT_MAX_Y][EDIT_MAX_X];
24. static int _x,_y;  /* 注意默认是初始化为的要不就不对了*/
26. /*******************************************************************
27. *
28. *       _cbWindow
29. *  桌面窗口的回调函数，当接受到滚动条的WM_NOTIFICATION_VALUE_CHANGED消息时，移动所有的编辑框
30. *  
31. */
32. static void _cbWindow(WM_MESSAGE *pMsg) {
33.   /*结构体WM_SCROLL_STATE的定义如下：
34. typedef struct {
35. int NumItems;
36. int v;
37. int PageSize;
38. } WM_SCROLL_STATE;
39.   */
40.   WM_SCROLL_STATE ScrollState;
42.   switch (pMsg->MsgId) {
43.   case WM_NOTIFY_PARENT:
44.       /* 接受到的是WM_NOTIFICATION_VALUE_CHANGED消息*/
45.   if (pMsg->Data.v == WM_NOTIFICATION_VALUE_CHANGED) {
46.   /* 消息时来自水平的滚动条*/
47.       if (WM_GetId(pMsg->hWinSrc) == GUI_ID_HSCROLL) {
48.         WM_GetScrollState(pMsg->hWinSrc, &ScrollState);
49.         /* 根据当前滚动条的位置，移动编辑框*/
50. if (_x != ScrollState.v) {
51.           int x, y;
52.           for (y = 0; y < EDIT_MAX_Y; y++) {
53.             for (x = 0; x < EDIT_MAX_X; x++) {
54.               WM_MoveWindow(_aahEdit[y][x], _x - ScrollState.v, 0);
55.             }
56.           }
57.           _x = ScrollState.v;
58.         }
59.       }
60.     }
61.     break;
62.   case WM_PAINT:
63.     GUI_SetBkColor(GUI_RED);
64.     GUI_Clear();
65.     break;
66.   default:
67.     WM_DefaultProc(pMsg);
68.   }
69. }
71. /*******************************************************************
72. *
73. *       _DemoScrollbarMove
74. */
75. static void _DemoScrollbarMove(void) {
76.   int x, y;
77.   WM_HWIN hWindow;
78.   SCROLLBAR_Handle hScroll;
79.   /*基本设置*/
80.   GUI_SetBkColor(GUI_BLUE);
81.   GUI_Clear();
82.   GUI_SetColor(GUI_WHITE);
83.   GUI_SetFont(&GUI_Font24_ASCII);
84.   GUI_SetTextAlign(GUI_TA_HCENTER);
85.   GUI_DispStringAt("SCROLLBAR_Move - Sample", 160, 5);
86.   GUI_SetTextAlign(GUI_TA_LEFT);
87.   GUI_SetColor(0xFFFFFF);
88.   GUI_SetFont(&GUI_Font8x16);
90.   /* 创建窗口*/
91.   hWindow = WM_CreateWindow(50, 90, 220, 79, WM_CF_SHOW, &_cbWindow, 0);
93.   /* 创建窗口的子控件*/
94.   hScroll = SCROLLBAR_CreateAttached(hWindow, 0);
96.   /* 设置滚动条条目的数量*/
97.   SCROLLBAR_SetNumItems(hScroll, 48 * EDIT_MAX_X);
99.   /* 设置页尺寸
100. 页面大小被指定为一页的项目数。如果用户使用键盘或通过在滚动条区域点击鼠
101. 标向上或向下翻页，则窗口按照为一页指定的项目数向上或向下滚动。
102.   */
103.   SCROLLBAR_SetPageSize(hScroll, 220);
105.   /* 创建编辑区域*/
106.   for (y = 0; y < EDIT_MAX_Y; y++) {
107.     for (x = 0; x < EDIT_MAX_X; x++) {
108. /* 创建编辑框*/
109.       _aahEdit[y][x] = EDIT_CreateAsChild(x * 48, y * 22, 48, 22,
110.                                         hWindow, 13, WM_CF_SHOW, 5);
111.       /* 设置对齐方式和字体*/
112.       EDIT_SetTextAlign(_aahEdit[y][x], GUI_TA_RIGHT | GUI_TA_VCENTER);
113.       EDIT_SetFont(_aahEdit[y][x], &GUI_Font8x16);
115.   /* 启用编辑区的十进制编辑模式给出的数值可以在给定的范围内显示*/
116.       EDIT_SetDecMode(_aahEdit[y][x], ((y * EDIT_MAX_X) + x) * 100, -99999, +99999, 2, 0);
117.   }
118.   }
120.   while (1) {
121.     GUI_Exec();
122.     GUI_Delay(20);
123.   }
125.   /* delete window and clear display */
126.   WM_DeleteWindow(hWindow);
127.   GUI_Clear();
128. }
130. /*******************************************************************
131. *
132. *       MainTask
133. *
134. *       Demonstates the use of a scrollbar as child of a window
135. *
136. ********************************************************************
137. */
139. void MainTask(void) {
140.   GUI_Init();
141.   while(1) {
142.     _DemoScrollbarMove();
143.   }
144. }

复制代码

实际显示效果如下：


54.3 使用官方GUIBulder建立单选按钮控件
    这里用GUIBulder5.22建立一个如下的界面（分辨率480*272）：

框架窗口最右侧和最下面依附的两个滚动条是通过在框架窗口上面右击鼠标进行添加：

其它的两个水平和垂直滚动条直接添加即可，添加的时候默认是水平的滚动条，垂直的滚动条需要通过将水平滚动条按照如下方法进行设置（鼠标左键点击滚动条选中后，右击鼠标进行选择）：

将生成的代码直接复制到模拟器或者开发板上面运行，实际显示效果如下（生成的代码在本期教程配套的例子中）：

54.4 总结
    本期教程主要是跟大家讲解了滚动条控件的基础知识。希望大家可以把本期教程中讲的这两个例子跑跑，然后自己设计一个相关的例子进行试验学习。教程中只是使用了部分的滚动条控件API，其它的API大家都可以试试。