YStudio Y++

自绘组件(工具箱没有的控件)

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

工具箱没有的界面(仪表、旋钮、时间轴、热力块等),可用 画布 + 绘制类 自己画。做法与主流 UI 里「自绘控件」相同:每帧按状态重画,在鼠标事件里算命中,再用普通函数模拟「值改变」等事件。

完整可运行工程:仓库 examples/仪表自绘演示(打开 仪表自绘演示.ysproj,F5)。

API 详见 绘制类、画布。


1. 思路(三步)

  1. 窗口放一个 画布(或任意控件当绘制目标)。
  2. 在 画布.绘制(或定时器 + 绘制类.开始绘制)里按变量画弧/线/文本。
  3. 在 鼠标按下/移动/抬起 里命中表盘,改数值并调用你自己的回调函数。

没有「仪表1.值改变」这种控件事件时,约定函数名即可,例如 仪表_值改变(...),在改值处主动调用。


2. 即时层 vs 场景图元

方式 事后怎么改 适合
即时层(绘制 里 画弧/画文本,或绘制类叠画) 改状态变量再 刷新(),下一帧重画 仪表指针、动画、帧率文字
场景图元(添加文本/添加椭圆 等) 记下图形 ID,再 置文本/置填充色/置位置 可点选、可导出场景的固定图元

仪表指针、进度弧一般走即时层;需要「画完还能当对象改」的用场景图元。


3. 模拟事件(推荐写法)

函数 仪表_值改变 (整数 表号, 小数 新值, 小数 旧值, 整数 来源) {
    // 写库、改标签、联动其它控件……
}

函数 设仪表值 (整数 表号, 小数 新值, 整数 来源) {
    // 夹范围 → 与旧值比较 → 赋值 → 调 仪表_值改变 → 画布.刷新()
}

工程里还演示了:

回调 何时调用
仪表_单击 按下命中表盘
仪表_拖动开始 / 仪表_拖动结束 开始拖针 / 松开
仪表_值改变 拖动、动画、随机、程序改值且数值真变了

改值请统一走 设仪表值,避免只改变量却忘记刷新或通知。

入口仍是画布真事件:

函数 画布1.鼠标按下 (整数 X, 整数 Y, 逻辑 按下) {
    // 命中 → 仪表_单击 / 仪表_拖动开始 → 按角度设值
}
函数 画布1.绘制 () {
    绘.绑画布(画布1)
    // 按 g_值、g_起角、g_扫角… 重画
}

4. 参数化皮肤(不要写死一种外观)

把 g_起角、g_扫角、g_弧值色、g_线宽、g_刻度数 等做成变量;下拉框只切换「预设」(给这些变量赋值)。统一绘制函数读参数,开发期改色、改角度、加霓虹开关都不必复制一整套画法。

示例皮肤包括:机台双表、半圆指针、色段、圆环、精密刻度、霓虹环、水平条、数字大屏、宽角扇区等。


5. 常见坑:指针不动、读数却在变

Y++ 中若 / 两边被推断成整数,会走整除(如 33/100 → 0)。进度扫角、指针角度会一直为 0,但 到文本(值) 仍显示正确。

比例请强制小数,例如:

小数 t = 到小数(值 - 最小) / 到小数(最大 - 最小)

示例工程里的 值比例() 已按此处理。


6. 还能画什么?

同一套路可画工具箱没有的界面,例如:旋钮、分段进度、简易甘特/时间轴、热力块、波形条、看板卡片。几何用线/弧/矩形/文本即可;复杂外观可再 画图像。

命中测试、焦点与无障碍需自行处理;体积上走现有绘制/画布路径,一般不必新增旁路库。


相关