进度指示(progress)

功能

用一个带颜色的进度条指示任意一个表达式的值(V1.6开始支持)

参数

  • KUI支持的表达式,此参数类型为字符串,写作 " #500 "
  • 控件所在位置及所占空间大小,此参数类型为元组,写作 (a, b, c, d) 其中a/b/c/d都应该是正整形值分别表示控件的 起始行/起始列/所占行数/所占列数,其中c/d可以省略,省略时值均为1。
  • 颜色字典:如{0:绿色,50:黄色,100:红色} 字典的键必须在0-100之间,表达式的值与某个键相等时显示键对应的值的颜色,在相邻两个键(此处是值的相邻,而不是位置的相邻)之间时按权重显示过渡颜色。表达式的值对应进度条填充的百分比。颜色字典的键可以不充满0-100,但必须包含0。表达式的值小于0时控件的状态和表达式为0时相同,表达式的值大于颜色字典最大的键时控件的颜色与最大键对应颜色相同,表达式的值大于100时进度条的填充比为100%。建议将颜色字典的键充满0-100(即:键同时包含0和100)。
  • 进度条方向:取值可以为 横向/纵向,此参数可以省略,默认为横向,此参数非字符串类型,写作 纵向(V1.7开始支持)
  • 进度条宽度:单位为像素,不设为默认值15。此参数写法为width=29。注意:当设置宽度大于第二个参数指定的此控件的宽度时控件将不能显示。(此参数只在进度条方向为"纵向"时才能设置)(V1.7开始支持)
  • 进度条高度:单位为像素,不设为默认值15。此参数写法为height=29。注意:当设置高度大于第二个参数指定的此控件的高度时控件将不能显示。(此参数只在进度条方向为"横向"时才能设置)
  • 是否反向:横向进度条从左到右为正向,纵向进度条从上到下为正向,默认为正向。此参数的写法为reversed=boolType(boolType为布尔变量的值,可以为TrueFalse),省略此参数时为正向,指定reverse参数为True时为反向(V1.7开始支持)

示例

此控件用于在页面中以带颜色的进度条来指示一个表达式的值,下图为表达的值为30时控件的状态,可见控件中带颜色的区域填充了30%,颜色为黄绿之间的过渡色。

progress

with page(10, 5, id="Progress", text=(绿色, f32x16, 居中)):
    progress("D3", (5, 2), {0: 绿色, 50: 黄色, 100: 红色}, 横向, height=30) #progress控件,在第5行第2列,占1行1列,表达式为D3,高度为30像素,默认为横向,正向
    progress("D3", (4, 4, 3, 1), {0: 绿色, 50: 黄色, 100: 红色}, 纵向, reversed=True, width=30) #progress控件,在第4行第4列,占3行1列,表达式为D3,宽度为30像素,纵向,反向
    #上图中D3的值为40