YStudio Y++

YSS · 进度环(progressring)

Y++ / YStudio 开发文档 · 一点滴

选择器: progressring · 设计器组件: 进度环 · 补全: jdh

环形进度指示。数值按「小数位数」定点存储(同数值微调框)。

字段

属性 YSS 说明
当前值 value 小数(受 decimals 控制)
最小/最大 min / max 默认 0/100
小数位数 decimals / decimal-places 0–6,0=整数
线宽 / 圆边宽度 stroke / line-width / ring-width 环形描边宽度,默认 4(1–32);属性同义
轨道色 track-color backColor
进度色 progress-color backColor2
进度渐变色 progress-gradient pressedForeColor;非空则沿弧渐变到该色,空=纯进度色
显示文本 show-text 环心是否绘制文字
环心文本 center-text / label 非空则覆盖自动数值/%
圆角端帽 round-cap 真=弧线两端圆头(默认真)
起始角 start-angle 画环起始点(度):0=正上,90=正右,顺时针为正
逆时针 ccw 真=逆时针增长
百分比 percent 真=显示 %(可带小数位)
不确定 indeterminate 真=旋转扫弧
不确定扫弧 indet-sweep 扫弧角度,默认 90
不确定周期 indet-period 旋转一周毫秒,默认 1200

API

进度环1.置小数位数(2)
进度环1.置范围(0, 100)
进度环1.置值(66.5)
进度环1.置线宽(8)          // 同义:置圆边宽度(8) / 线宽=8 / 圆边宽度=8
进度环1.置起始角(90)       // 从正右起画;0=正上
进度环1.置逆时针(真)
进度环1.置环心文本("完成")
进度环1.置进度渐变色("#00D4AA")  // 空文本关闭渐变
进度环1.置不确定扫弧(120)
进度环1.置不确定周期(800)
进度环1.置不确定(真)

函数 进度环1.值改变 (小数 当前值, 整数 来源) {
    输出("环=", 到文本(当前值))
}

属性面板改值后设计器画布会实时预览(含线宽、起始角、逆时针、渐变、环心文字、不确定扫弧等)。