1.创建实例
insertChart('AF', 'border=single; bordercolor=#4499ff; borderWidth=2; borderRound=23; backcolor=#fff5ea')其中第二个参数即 “创建参数”,决定了如何在页面上展现 Supcan Chart,创建参数中可包含多个子串,子串间以 ";" 分隔。
分类 | 子串名 | 含义 | 可用值 | 默认值 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
主要 | chart | 统计图类型 |
| 0 | ||||||||||||
items | 统计图中最多能显示数据项数量 | 数值 注1:最多不得超过155; 注2:超出的部分、数值小的数据项将归并到“其它”数据项 | 28 | |||||||||||||
textContent | 显示的文字内容 | 0 - 不显示, 1 - 仅数据项名称, 2 - 名称、百分比, 3 - 名称、数值, 也可以是表达式串 - 表达式中可以使用 name、data、percent 变量, 分别表示名称、数值、百分比, 例如: insertChart("AF", "border=none; textContent=name+': ' +data + '吨, 占总数的' + percent + '%'") 注:请注意里面的双引号、单引号 | 2 | |||||||||||||
tip | tip内容 | none(或为空) - 禁止tip auto - 自动 表达式串 - 请参见 textContent 属性 | auto | |||||||||||||
textArrange | 文字位置 | 0 - 不显示, 1 - 外部且对齐, 2 - 外部, 3 - 内部 注:2、3仅用于圆饼图 | 2 | |||||||||||||
Caption | 标题 | 文字 | (无) | |||||||||||||
titlePosition | 标题和系列名的位置 | 0 - 不显示, 2 - 上方, 8 - 底部 | 2 | |||||||||||||
Colors | 统计图的颜色 | 以逗号分隔的颜色串, 用于自定义颜色 | (无) 自动产生 | |||||||||||||
边界 | Border | 边界线风格 | none - 无边界, single - 单线条边界, 3d - 3D凹陷边界 | single | ||||||||||||
BorderWidth | 边界线粗细 | 像素数 | 1 | |||||||||||||
BorderRound | 圆角边界的直径 | 像素数 | 0 | |||||||||||||
BorderColor | 边界线颜色 | 颜色串 | 0 | |||||||||||||
背景 | bgColor 或BackColor | 整个统计图的背景色 | 颜色串,或以逗号分隔的2个颜色串(垂直渐变) | 沿用页面上下文 | ||||||||||||
BackImage | 统计图的背景图片 | 如下名值对,分号(;)分隔: src或url - 图片URL; alpha - 透明度(0-255); rotate - 旋转角度(0-360); arrange - 布局, 有tile(平铺) / stretch(伸展)等, 默认tile, 可参见Treelist XML文档规范中的<Properties>下的<background>. 例如:backImage='src=res/flag.jpg;alpha=100' | (无) | |||||||||||||
圆饼图 | PieTextColor | 圆饼图的文字颜色 | 颜色串, "auto" 表示自动, 采用和圆饼相近的颜色 | auto | ||||||||||||
PieBorderPercent | 圆饼图3D凸起(纽扣效果)大小 | 0到100的数字,0或100表示无纽扣效果,其中100表示完全2D(单一色) | 10 | |||||||||||||
PieShadowPercent | 圆饼图阴影大小 | 0到100的数字,0表示无阴影 | 2 | |||||||||||||
PieShadowAlpha | 圆饼图阴影透明度 | 0到255的数字, 数字越小则越淡 | 230 | |||||||||||||
坐标类 | outlinePointDiameter | 数据点的小圆球的直径 | 像素数, 0表示不需要显示小圆球 备注:仅用于折线/曲线/区域图 | 10 | ||||||||||||
dblClickSwitchAble | 鼠标双击当前系列行为 | true/false, 表示在多系列显示时,双击当前系列是否切换到仅显示本系列 | true | |||||||||||||
coordinateBackColor | 坐标区域背景色 | ARGB颜色串,或以逗号分隔的2个ARGB颜色串(垂直渐变) 注1: 所谓 ARGB 颜色,例如: "#10C0D0E0", 其中前2位( "10" )是 alpha(即透明度), 后6位( "C0D0E0" ) 是 RGB, 透明度的值的范围也和颜色一样, 是从0到255(对应到16进制就是00到FF). 半透明的颜色块好比是一层薄纱,叠加在上方,其透明度决定了颜色的浓淡 注2: 仅用于bar、line、curve、area | (无) | |||||||||||||
valueMask | 数值显示掩码 | 串,如"#,###.00", 如果不设置 valueMask, 格式将和传入的数据的格式保持一致 | (无) | |||||||||||||
valueMaskY | Y轴数值显示掩码 | 串,如"#,###.00" 注1: 仅用于bar、line、curve、area、radar | #,##0 | |||||||||||||
valueStepY 或 stepValueY | Y轴坐标刻度步进值 | 数值,0表示由插件根据实际数据生成合适的值 注1: 仅用于bar、line、curve、area、radar 注2: 间距过密,该设置将失效 | 0 | |||||||||||||
valueMaxY 或 maxValueY | 强制设定Y轴坐标最大值 | 数值,0表示由实际数据决定 注1: 仅用于bar、line、curve、area、radar 注2: 实际数据若超过该值,该设置将失效 | 0 | |||||||||||||
valueMinY 或 minValueY | 强制设定Y轴坐标最小值 | 数值,0表示由实际数据决定 注1: 仅用于bar、line、curve、area、radar 注2: 实际数据若超过该值,该设置将失效 | 0 | |||||||||||||
Overflow | 宽度不够导致数据项文字重叠的处理选项 | 0 - 垂直错落显示; 1 - 文字倾斜45度显示 注:用于柱状图、曲线折线图 | 0 | |||||||||||||
ActiveSeries | 当前高亮的活动系列 | 系列名,或系列的顺序号(从0开始计数) | (无) | |||||||||||||
isDrawZero | 是否显示数值为0的线条 | 1 或 true, 全部显示; 0 或 false, 数值为零或为空的坐标处不绘制线条; 2 或 NotNull, 数值为空的坐标处不绘制线条; 注:仅用于折线/曲线/区域图 | true | |||||||||||||
LineThick | 折线/曲线的线条宽度 | 像素数, 0 到 12 | 1 | |||||||||||||
BarImage | 柱状图的背景图案 | 如下名值对,分号(;)分隔: src或url - 图片URL; alpha - 透明度(0-255); rotate - 旋转角度(0-360); arrange - 布局, 有tile(平铺) / stretch(伸展)等, 默认tile, 可参见Treelist XML文档规范中的<Properties>下的<background>. 例如:barImage='src=res/flag.jpg;alpha=100' | (无) | |||||||||||||
isFillRadar | 是否以颜色填充雷达图 | true/false | true | |||||||||||||
其它 | isAnimate | 是否以动画启动 | true/false | true | ||||||||||||
hasMenu | 是否需要鼠标右键弹出菜单 | true/false | true | |||||||||||||
isUseContextFont | 是否采用页面上下文字体 | true/false | false | |||||||||||||
EventLog | 事件日志 | 文件名,建议后缀是txt, 不必带路径,系统将自动在 BC 目录下创建. 该文件能自动记录本组件实例的所有事件, 用于程序调试. 建议写成 %autoName% 让插件自动命名. 注:正式运行时请不要使用,因为频繁读写磁盘会导致性能下降. | 无 | |||||||||||||
FuncLog | 函数调用日志 | 文件名,建议后缀是txt, 不必带路径,系统将自动在 BC 目录下创建. 该文件能自动记录本组件实例被调用的所有函数, 用于程序调试. 建议写成 %autoName% 让插件自动命名. 注:正式运行时请不要使用,因为频繁读写磁盘会导致性能下降. | 无 | |||||||||||||
FuncParaChars | 函数日志中参数最大字数 | 数字,当启用函数日志时,函数的参数最多保留字数. | 128 | |||||||||||||
FuncReturnChars | 函数日志中返回值最大字数 | 数字,当启用函数日志时,函数的返回值最多保留字数. | 0 |