类: ChartCollection

Sheets.Charts.ChartCollection

Table of contents

构造方法

• constructor

方法

• add
• all
• clear
• get
• preserveUnsupportedChart
• remove
• zIndex

构造方法

constructor

• new ChartCollection()

一个图表管理器，用于管理表单中的所有图表

方法

add

▸ add(name, chartType, x, y, width, height, dataRange?, dataOrientation?): Chart

将图表添加到表单中

代码示例

//本示例说明如何添加图表
var dataRange = "A1:D4";
var chart = activeSheet.charts.add('Chart1', GC.Spread.Sheets.Charts.ChartType.columnClustered, 250, 20, 600, 400, dataRange);

参数

返回值

Chart

已添加到表单中的图表

all

▸ all(): Chart[]

获取表单中的所有图表

代码示例

var dataRange = "A1:D4";
activeSheet.charts.add('Chart1', GC.Spread.Sheets.Charts.ChartType.columnClustered, 250, 20, 600, 180, dataRange);
var dataRange2 = "A20:D24";
activeSheet.charts.add('Chart2', GC.Spread.Sheets.Charts.ChartType.columnClustered, 250, 220, 600, 180, dataRange2);
var charts = activeSheet.charts.all();
for (var i = 0; i < charts.length; i++) {
    alert("Name of chart " + i + " is:  " + charts[i].name())
}

返回值

Chart[]

表单中所有图表的集合

clear

▸ clear(): void

删除表单中的所有图表

返回值

void

get

▸ get(name): Chart

从表中通过指示名称获取图表

代码示例

var dataRange = "A1:D4";
activeSheet.charts.add('Chart1', GC.Spread.Sheets.Charts.ChartType.columnClustered, 250, 20, 600, 400, dataRange);
//button
$("#button1").click(function () {
 var chart = activeSheet.charts.get("f2");
});

参数

返回值

Chart

表单中带有指示名称的图表

preserveUnsupportedChart

▸ preserveUnsupportedChart(flag?, paintCallBack?): undefined | boolean

获取或设置是否在导入时保留不支持的图表

代码示例

sheet.charts.preserveUnsupportedChart(true, function(chart, ctx, width, height){
    ctx.textBaseline = 'middle';
    ctx.textAlign = 'center';
    ctx.fillStyle = '#000000';
    ctx.fillText("to be continue", width / 2, height / 2, width);
})

参数

返回值

undefined | boolean

如果未设置任何值，则返回标志值，否则返回undefined;否则，返回undefined

remove

▸ remove(name): void

从表中删除带有指示名称的图表

代码示例

var dataRange = "A1:D4";
activeSheet.charts.add('Chart1', GC.Spread.Sheets.Charts.ChartType.columnClustered, 250, 20, 600, 400, dataRange);
//button
$("#button1").click(function () {
     activeSheet.resumePaint();
     activeSheet.charts.remove("f2");
     activeSheet.repaint();
});

参数

返回值

void

zIndex

▸ zIndex(name, zIndex?): any

获取或设置图表的z-index

代码示例

var dataRange = "A1:D4";
activeSheet.charts.add('Chart1', GC.Spread.Sheets.Charts.ChartType.columnClustered, 250, 20, 600, 180, dataRange);
var dataRange2 = "A20:D24";
activeSheet.charts.add('Chart2', GC.Spread.Sheets.Charts.ChartType.columnClustered, 250, 180, 600, 180, dataRange2);
activeSheet.charts.zIndex('Chart1', 897);
activeSheet.charts.zIndex('Chart2', 890);

参数

返回值

any

如果参数'zIndex'为null或未定义，它将返回带有指示名称的图表的z-index