YStudio Y++

图表(chart)

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

选择器: chart · 设计器组件: 图表 · 按名称: chart#名称 或 #名称
支持库: 组件类库 → 图表类 · 补全: tb / chart / 图表
能力: 收费位 component.chart(须票内显式开通;* 不能覆盖)

硬约束与叠画

  1. 控件名来自窗口 XML「名称」;属性赋值无括号,方法调用必须带括号。
  2. 事件写 函数 控件名.事件名(参数…);图表当前仅通用指针事件。
  3. 任意控件客户区叠画用支持库 绘制类:绘制类 g → g.绑组件(本控件名)。
  4. 不要虚构未列出的方法;YSS 键见下文与 YSS.md。

属性

属性 类型 读写 说明
标题 文本 读写 图表标题;空则不画标题行
图表类型 整数 读写 0=折线 1=柱状 2=饼图
显示图例 逻辑 读写 真=底部显示系列图例
显示网格 逻辑 读写 真=折线/柱状显示网格(饼图忽略)
堆叠 逻辑 读写 真=柱状图按分类堆叠
文字色 文本 读写 轴/标签文字色
背景色 文本 读写 底板色
透明背景 逻辑 读写 真=不填充底板
圆角 / 显示边框 / 边框大小 / 边框颜色 — 读写 外壳

另含通用布局/行为属性(左边、顶边、宽度、高度、可见、启用、提示等)。

方法

方法 说明
置图表类型(整数) / 取图表类型() 0 折线 / 1 柱状 / 2 饼图
置显示图例(逻辑) / 取显示图例() 图例开关
置显示网格(逻辑) / 取显示网格() 网格开关
清空数据() 清空分类与全部系列
置分类(文本数组) 横轴分类(如月份)
加入系列(文本 名称, 文本数组 数值, [文本 颜色]) 追加系列;数值以文本传入
取系列数() 当前系列个数
绑定表格(文本 控件名) 从表格或数据表格读入:第 0 列为分类,其余列为系列;数据表格首行可作系列名
取分类数() 当前分类个数
取系列名(整数) 按序号取系列名,从 0 起
取数值(整数, 整数) / 置数值(整数, 整数, 文本) 读改某系列某点;返回文本
删除系列(整数) 按序号删除系列
置堆叠(逻辑) / 取堆叠() 柱状图是否堆叠
取命中(整数, 整数) 客户区坐标命中的「系列,点」;未命中 -1,-1

示例

图表1.置图表类型(0)
图表1.清空数据()
图表1.置分类(["一月", "二月", "三月", "四月"])
图表1.加入系列("销量", ["12", "19", "8", "15"], "#4C8DFF")
图表1.加入系列("成本", ["8", "11", "14", "9"], "#3DDC97")

绑定已有表格:

图表1.绑定表格("表格1")

YSS

选择器:chart / 图表。常用键与其它显示控件相同:background-color、color、border-*、border-radius 等。