SCROLLBAR_INIT -- 滚动条初始化

类型

显示指令

描述

指定ID初始化一个滚动条。具体使用可参见滚动条使用例程。

可用滚动条ID(0~31)

语法

SCROLLBAR_INIT(id,x1,y1,width,height,maxlines,showlines[ forecor,backcor,presscor] )

id = SCORLLBAR_INIT (x1, y1, width, height, maxlines, showlines, [forecor,backcor,presscor] )

id:滚动条唯一编号,不传id参数会自动获取可用ID并返回

作为返回值,返回-1表示无空闲的ID,自动初始化失败

x1,y1:滚动条左上角位置(以自定义元件框的左上角为原点)

width,height:滚动条宽高

maxlines:最大显示长度

showlines:一页显示长度

当maxlines=20,showlines=10时,滚动条可滚动(20-10=10)个单位,滚动值(SCROLLBAR_POS)范围为0~10

forecor:滚动条颜色,可缺省

backcor:滚动条背景颜色,可缺省

presscor:滚动条按压颜色,可缺省

 

特别说明:

若width>height,则为水平滚动条,反之为垂直滚动条。

适用控制器

支持RTHmi(仅支持4系列及以上控制器)

例子

SCROLLBAR_INIT(0, 0, 0, 21, 330, 50, 10, RGB(255,0,0), RGB(0,255,0), RGB(0,0,255))

滚动条显示效果:

按住滚动条时显示效果:

相关指令

SCROLLBAR_POS,SCROLLBAR_REFLASH,SCROLLBAR_DRAW