STTLine.h 使用手册
STTLine 用点数组绘制直线或折线;同一头文件还提供 STTLineArray,用于在一个父控件内管理多条线。
1. STTLine 创建
cpp 复制代码#include "widgets/STTLine.h"
using namespace stt;
STTLine* line = new STTLine(getRuntime(), parent, "lineTrend");
line->setColor(0x1687d9)
->setWidth(3)
->setOpa(255)
->setRounded(true);
头文件没有 setMainArg。线的尺寸和位置主要由点坐标与父控件决定,也可使用继承自 STTWidget 的通用位置接口。
2. 设置点
分离坐标数组:
cpp 复制代码int xs[] = {0, 40, 90, 150};
int ys[] = {20, 5, 60, 30};
line->setPoints(xs, ys, 4);
交错数组:
cpp 复制代码int xy[] = {0, 20, 40, 5, 90, 60, 150, 30};
line->setPoints(xy, 4);
字符串:
cpp 复制代码line->setPoints("0,20,40,5,90,60,150,30");
STTLine 会复制点到内部 new[] 数组,因此输入数组在调用返回后可以离开作用域。再次 setPoints 会删除旧数组。
字符串实现注意:
- 少于 4 个逗号分段时直接返回,不修改当前线。
- 使用 atoi,非法数字会变成 0。
- 奇数个坐标时最后一个值被忽略。
- 未检查空段、溢出和负 point_num。
3. 绘制便利方法
cpp 复制代码line->drawLine(0, 0, 100, 50);
line->drawHori(0, 200, 30);
line->drawVert(50, 0, 120);
闭合折线:
cpp 复制代码int x[] = {0, 100, 50};
int y[] = {100, 100, 0};
line->drawLine(x, y, 3, true);
point_num>2 且 close=true 时,会把第一个点追加到末尾。实现使用变长栈数组,这是 GCC 扩展,不是标准 C++;极大点数可能造成栈溢出。
4. 线样式
cpp 复制代码line->setColor(0xff5500);
line->setOpa(180);
line->setWidth(4);
line->setRounded(true);
line->setYInvert(false);
setYInvert 相当于围绕控件水平中线镜像 Y。
虚线:
cpp 复制代码line->setDash(10, 6);
LVGL 限制虚线主要用于水平或垂直线,斜线虚线效果不可依赖。opacity 应由调用方限制在 0..255,宽度和 dash 长度应为正值。
5. 变量绑定
onDataChanged 当前为空实现。即使调用 bindData,变量变化也不会改变点或样式。动态曲线需要业务回调中重新构建坐标并调用 setPoints。
6. STTLineArray
6.1 创建与默认样式
cpp 复制代码STTLineArray lines(parent);
lines.width = 2;
lines.color = 0x999999;
lines.opa = 255;
lines.round = false;
lines.yInvert = false;
公共字段会应用到之后 add 的线,不会自动更新已有线。
6.2 添加和访问
cpp 复制代码int xy[] = {0, 0, 100, 50, 180, 20};
STTLine* custom = lines.add(xy, 3);
STTLine* horizontal = lines.addHori(40);
STTLine* vertical = lines.addVert(80);
STTLine* first = lines.get(0);
addHori 使用 owner->mSettedwidth,addVert 使用 owner->mSettedheight,因此父控件应先设置尺寸。get 对越界返回 nullptr。
6.3 删除
cpp 复制代码lines.remove(0);
lines.removeAll();
remove 不检查索引范围,错误索引会越界。应先确认 0 <= i < lines.size()。
remove/removeAll 调用 STTWidget::del 后从 vector 移除。STTLineArray 析构函数本身为空,不会自动 removeAll;若线没有由父 LVGL 对象统一销毁,应在数组结束使用前显式 removeAll。
7. 完整示例
cpp 复制代码STTLine* border = new STTLine(getRuntime(), panel, "border");
border->setColor(0x333333)->setWidth(2)->setRounded(false);
int x[] = {0, 200, 200, 0};
int y[] = {0, 0, 100, 100};
border->drawLine(x, y, 4, true);
8. 注意事项
- point_num 必须与输入数组真实长度一致且大于 0。
- 字符串坐标只适合可信、已校验输入。
- STTLineArray::remove 前必须自行做边界检查。
- STTLineArray 析构不清理 lines。
- 公共 m_points 是内部拥有内存,调用方不得释放或替换。
- onDataChanged 当前无效。
- 所有绘制操作在 LVGL 线程执行。