add メソッド

系列コレクションに新しい系列を追加します。

シンタックス

Javascript (Usage)
Javascript (Specification)

var instance = new GC.Spread.Sheets.Charts.SeriesCollection();
var value; // Type: any
value = instance.add(seriesItem,
                     seriesItem.symbol,
                     seriesItem.symbol.fill,
                     seriesItem.symbol.fillColorTransparency,
                     seriesItem.symbol.size,
                     seriesItem.symbol.shape,
                     seriesItem.symbol.border,
                     seriesItem.symbol.border.color,
                     seriesItem.symbol.border.colorTransparency,
                     seriesItem.symbol.border.width,
                     seriesItem.symbol.border.lineType,
                     seriesItem.errorbars,
                     seriesItem.errorbars.vertical,
                     seriesItem.errorbars.vertical.type,
                     seriesItem.errorbars.vertical.valuetype,
                     seriesItem.errorbars.vertical.noEndCap,
                     seriesItem.errorbars.vertical.value,
                     seriesItem.errorbars.vertical.custom,
                     seriesItem.errorbars.vertical.custom.positive,
                     seriesItem.errorbars.vertical.custom.negative,
                     seriesItem.errorbars.vertical.style,
                     seriesItem.errorbars.vertical.style.color,
                     seriesItem.errorbars.vertical.style.transparency,
                     seriesItem.errorbars.vertical.style.width,
                     seriesItem.errorbars.horizontal,
                     seriesItem.errorbars.horizontal.type,
                     seriesItem.errorbars.horizontal.valuetype,
                     seriesItem.errorbars.horizontal.noEndCap,
                     seriesItem.errorbars.horizontal.value,
                     seriesItem.errorbars.horizontal.custom,
                     seriesItem.errorbars.horizontal.custom.positive,
                     seriesItem.errorbars.horizontal.custom.negative,
                     seriesItem.errorbars.horizontal.style,
                     seriesItem.errorbars.horizontal.style.color,
                     seriesItem.errorbars.horizontal.style.transparency,
                     seriesItem.errorbars.horizontal.style.width,
                     seriesItem.errorbars.horizontal.style.dashStyle,
                     seriesItem.trendlines,
                     seriesItem.trendlines2,
                     seriesItem.trendlines3,
                     seriesItem.trendlines4,
                     seriesItem.trendlines5,
                     seriesItem.trendlines6,
                     seriesItem.trendlines7,
                     seriesItem.trendlines8,
                     seriesItem.trendlines9,
                     seriesItem.trendlines10,
                     seriesItem.trendlines11,
                     seriesItem.trendlines12,
                     seriesItem.trendlines13,
                     seriesItem.trendlines14,
                     seriesItem.trendlines15,
                     seriesItem.trendlines16,
                     seriesItem.trendlines17,
                     seriesItem.trendlines18,
                     seriesItem.chartType,
                     seriesItem.axisGroup,
                     seriesItem.backColor,
                     seriesItem.backColor.type,
                     seriesItem.backColor.foregroundColor,
                     seriesItem.backColor.backgroundColor,
                     seriesItem.backColorTransparency,
                     seriesItem.border,
                     seriesItem.border.color,
                     seriesItem.border.lineType,
                     seriesItem.border.transparency,
                     seriesItem.border.width,
                     seriesItem.startAngle,
                     seriesItem.name,
                     seriesItem.xValues,
                     seriesItem.yValues,
                     seriesItem.bubbleSizes,
                     seriesItem.doughnutHoleSize,
                     seriesItem.gapWidth,
                     seriesItem.overlap,
                     seriesItem.trendlines19,
                     seriesItem.dataPoints,
                     seriesItem.dataLabels,
                     seriesItem.dataLabels.showValue,
                     seriesItem.dataLabels.showSeriesName,
                     seriesItem.dataLabels.showCategoryName,
                     seriesItem.dataLabels.showPercentage,
                     seriesItem.dataLabels.separator,
                     seriesItem.dataLabels.position,
                     seriesItem.dataLabels.format,
                     seriesItem.dataLabels.color,
                     seriesItem.dataLabels.transparency,
                     seriesItem.dataLabels.backColor,
                     seriesItem.dataLabels.backColor.type,
                     seriesItem.dataLabels.backColor.foregroundColor,
                     seriesItem.dataLabels.backColor.backgroundColor,
                     seriesItem.dataLabels.backColorTransparency,
                     seriesItem.dataLabels.borderColor,
                     seriesItem.dataLabels.borderWidth,
                     seriesItem.dataLabels.borderColorTransparency);

function add( 
   seriesItem : Object,
   seriesItem.symbol : Object,
   seriesItem.symbol.fill : string,
   seriesItem.symbol.fillColorTransparency : number,
   seriesItem.symbol.size : number,
   seriesItem.symbol.shape : SymbolShape,
   seriesItem.symbol.border : Object,
   seriesItem.symbol.border.color : string,
   seriesItem.symbol.border.colorTransparency : number,
   seriesItem.symbol.border.width : number,
   seriesItem.symbol.border.lineType : LineType,
   seriesItem.errorbars : Object,
   seriesItem.errorbars.vertical : Object,
   seriesItem.errorbars.vertical.type : ErrorBarType,
   seriesItem.errorbars.vertical.valuetype : ErrorBarValueType,
   seriesItem.errorbars.vertical.noEndCap : boolean,
   seriesItem.errorbars.vertical.value : number,
   seriesItem.errorbars.vertical.custom : Object,
   seriesItem.errorbars.vertical.custom.positive : string,
   seriesItem.errorbars.vertical.custom.negative : string,
   seriesItem.errorbars.vertical.style : Object,
   seriesItem.errorbars.vertical.style.color : string,
   seriesItem.errorbars.vertical.style.transparency : number,
   seriesItem.errorbars.vertical.style.width : number,
   seriesItem.errorbars.horizontal : Object,
   seriesItem.errorbars.horizontal.type : ErrorBarType,
   seriesItem.errorbars.horizontal.valuetype : ErrorBarValueType,
   seriesItem.errorbars.horizontal.noEndCap : boolean,
   seriesItem.errorbars.horizontal.value : number,
   seriesItem.errorbars.horizontal.custom : Object,
   seriesItem.errorbars.horizontal.custom.positive : string,
   seriesItem.errorbars.horizontal.custom.negative : string,
   seriesItem.errorbars.horizontal.style : Object,
   seriesItem.errorbars.horizontal.style.color : string,
   seriesItem.errorbars.horizontal.style.transparency : number,
   seriesItem.errorbars.horizontal.style.width : number,
   seriesItem.errorbars.horizontal.style.dashStyle : LineType,
   seriesItem.trendlines : undefined,
   seriesItem.trendlines2 : TrendlineType,
   seriesItem.trendlines3 : number,
   seriesItem.trendlines4 : number,
   seriesItem.trendlines5 : number,
   seriesItem.trendlines6 : number,
   seriesItem.trendlines7 : number,
   seriesItem.trendlines8 : boolean,
   seriesItem.trendlines9 : boolean,
   seriesItem.trendlines10 : string,
   seriesItem.trendlines11 : number,
   seriesItem.trendlines12 : string,
   seriesItem.trendlines13 : string,
   seriesItem.trendlines14 : Object,
   seriesItem.trendlines15 : string,
   seriesItem.trendlines16 : number,
   seriesItem.trendlines17 : number,
   seriesItem.trendlines18 : LineType,
   seriesItem.chartType : ChartType,
   seriesItem.axisGroup : AxisGroup,
   seriesItem.backColor : undefined,
   seriesItem.backColor.type : PatternType,
   seriesItem.backColor.foregroundColor : string,
   seriesItem.backColor.backgroundColor : string,
   seriesItem.backColorTransparency : number,
   seriesItem.border : Object,
   seriesItem.border.color : string,
   seriesItem.border.lineType : LineType,
   seriesItem.border.transparency : number,
   seriesItem.border.width : number,
   seriesItem.startAngle : number,
   seriesItem.name : string,
   seriesItem.xValues : string,
   seriesItem.yValues : string,
   seriesItem.bubbleSizes : string,
   seriesItem.doughnutHoleSize : number,
   seriesItem.gapWidth : number,
   seriesItem.overlap : number,
   seriesItem.trendlines19 : Array,
   seriesItem.dataPoints : undefined,
   seriesItem.dataLabels : Object,
   seriesItem.dataLabels.showValue : boolean,
   seriesItem.dataLabels.showSeriesName : boolean,
   seriesItem.dataLabels.showCategoryName : boolean,
   seriesItem.dataLabels.showPercentage : boolean,
   seriesItem.dataLabels.separator : string,
   seriesItem.dataLabels.position : DataLabelPosition,
   seriesItem.dataLabels.format : string,
   seriesItem.dataLabels.color : string,
   seriesItem.dataLabels.transparency : number,
   seriesItem.dataLabels.backColor : undefined,
   seriesItem.dataLabels.backColor.type : PatternType,
   seriesItem.dataLabels.backColor.foregroundColor : string,
   seriesItem.dataLabels.backColor.backgroundColor : string,
   seriesItem.dataLabels.backColorTransparency : number,
   seriesItem.dataLabels.borderColor : string,
   seriesItem.dataLabels.borderWidth : number,
   seriesItem.dataLabels.borderColorTransparency : number
) : any;

パラメータ

seriesItem: チャートの系列。
seriesItem.symbol: , seriesItem 系列のシンボル。
seriesItem.symbol.fill: 系列のシンボル内の塗りつぶし色。
seriesItem.symbol.fillColorTransparency: シンボルの塗りつぶし色の透明度。
seriesItem.symbol.size: 系列のシンボルサイズ。
seriesItem.symbol.shape: 系列内のシンボルの図形。
seriesItem.symbol.border: 系列内のシンボルの図形。
seriesItem.symbol.border.color: 系列のシンボルの境界線の色。
seriesItem.symbol.border.colorTransparency: 系列内のシンボルの境界線色の透明度。
seriesItem.symbol.border.width: 系列のシンボルの境界線の太さ。
seriesItem.symbol.border.lineType: 系列のシンボルの境界線の種類。
seriesItem.errorbars: 系列の誤差範囲。
seriesItem.errorbars.vertical: 系列の垂直方向の誤差範囲。各系列には、チャートタイプに基づいて異なる方向の誤差範囲が含まれる場合があります。
seriesItem.errorbars.vertical.type: 誤差範囲の種類。
seriesItem.errorbars.vertical.valuetype: 誤差値の種類。
seriesItem.errorbars.vertical.noEndCap: 誤差範囲に終点キャップがあるかどうか。
seriesItem.errorbars.vertical.value: 誤差範囲の値です。FixedValue(1) / Percentage(2)/ StandardDeviation(3)の値タイプで有効になります。
seriesItem.errorbars.vertical.custom: 誤差範囲のカスタム数式。正の式と負の式が含まれており、Custom(0)値型で有効になります。
seriesItem.errorbars.vertical.custom.positive: 誤差範囲のカスタムの正数式。
seriesItem.errorbars.vertical.custom.negative: 誤差範囲のカスタムの負数式。
seriesItem.errorbars.vertical.style: 誤差範囲のスタイル。
seriesItem.errorbars.vertical.style.color: 誤差範囲の色。
seriesItem.errorbars.vertical.style.transparency: 誤差範囲の透明度。
seriesItem.errorbars.vertical.style.width: 誤差範囲の太さ。
seriesItem.errorbars.horizontal: 系列の水平方向の誤差範囲。各系列には、チャートタイプに基づいて異なる方向の誤差範囲が含まれる場合があります。
seriesItem.errorbars.horizontal.type: 誤差範囲の種類。
seriesItem.errorbars.horizontal.valuetype: 誤差値の種類。
seriesItem.errorbars.horizontal.noEndCap: 誤差範囲に終点キャップがあるかどうか。
seriesItem.errorbars.horizontal.value: 誤差範囲の値です。FixedValue(1) / Percentage(2)/ StandardDeviation(3)の値タイプで有効になります。
seriesItem.errorbars.horizontal.custom: 誤差範囲のカスタム数式。正の式と負の式が含まれており、Custom(0)値型で有効になります。
seriesItem.errorbars.horizontal.custom.positive: 誤差範囲のカスタムの正数式。
seriesItem.errorbars.horizontal.custom.negative: 誤差範囲のカスタムの負数式。
seriesItem.errorbars.horizontal.style: 誤差範囲のスタイル。
seriesItem.errorbars.horizontal.style.color: 誤差範囲の色。
seriesItem.errorbars.horizontal.style.transparency: 誤差範囲の透明度。
seriesItem.errorbars.horizontal.style.width: 誤差範囲の太さ。
seriesItem.errorbars.horizontal.style.dashStyle: 誤差範囲のダッシュスタイル。
seriesItem.trendlines: 系列の近似曲線。[0].type 近似曲線の種類。[0].order 多項式近似曲線の順序。[0].period 移動平均の近似曲線の期間。[0].intercept 近似曲線の切片。[0].forward 近似曲線のforward。[0].backward近似曲線のbackward。[0].displayEquation 近似曲線の方程式を表示するかどうか。[0].displayRSquared 近似曲線のR-2 乗値を表示するかどうか。[0].fontFamily 近似曲線のfontFamily。[0].fontSize 近似曲線のfontSize。[0].fontColor 近似曲線のfontColor。[0].name 近似曲線の名前。[0].style 近似曲線の線のスタイル。[0].style.color 近似曲線の色。[0].style.transparency 近似曲線の透明度。[0].style.width 近似曲線の太さ。[0].style.dashStyle 近似曲線のダッシュスタイル。系列の近似曲線。
seriesItem.trendlines2
seriesItem.trendlines3
seriesItem.trendlines4
seriesItem.trendlines5
seriesItem.trendlines6
seriesItem.trendlines7
seriesItem.trendlines8
seriesItem.trendlines9
seriesItem.trendlines10
seriesItem.trendlines11
seriesItem.trendlines12
seriesItem.trendlines13
seriesItem.trendlines14
seriesItem.trendlines15
seriesItem.trendlines16
seriesItem.trendlines17
seriesItem.trendlines18
seriesItem.chartType: 系列のチャート種類。
seriesItem.axisGroup: 系列の軸グループ。
seriesItem.backColor: 系列の背景色。
seriesItem.backColor.type: チャート系列のパターン塗りつぶし背景色タイプ。
seriesItem.backColor.foregroundColor: チャート系列の前景色のパターン塗りつぶし。
seriesItem.backColor.backgroundColor: チャート系列の背景色のパターン塗りつぶし。
seriesItem.backColorTransparency: 系列の背景色の透明度。
seriesItem.border: 系列の境界線。
seriesItem.border.color: 系列の境界線の色。
seriesItem.border.lineType: 系列の境界線の種類。
seriesItem.border.transparency: 系列の境界線の色の透明度。
seriesItem.border.width: 系列の境界線の太さ。
seriesItem.startAngle: チャートの種類が円グラフであるグラフの最初のセグメントの角度。デフォルト値は0で、12時を表します。
seriesItem.name: 系列のname数式。
seriesItem.xValues: 系列のx値数式。
seriesItem.yValues: 系列のx値数式。
seriesItem.bubbleSizes: 系列のバブルサイズ数式。これはバブルチャートに使用されます。
seriesItem.doughnutHoleSize: ドーナツチャートの穴のサイズ。ドーナツチャートに使用されます。最大値は0.9、最小値は0です。
seriesItem.gapWidth: 棒グラフと縦棒グラフのグループのギャップ幅。最大値は5、最小値は0です。
seriesItem.overlap: 棒グラフと縦棒グラフのグループの重なり。最大値は1、最小値は-1です。
seriesItem.trendlines19
seriesItem.dataPoints: 系列のデータポイント。
seriesItem.dataLabels: 系列のデータラベル。
seriesItem.dataLabels.showValue: 系列内のデータラベルに値を表示するかどうか。
seriesItem.dataLabels.showSeriesName: 系列内のデータラベルに系列名を表示するかどうか。
seriesItem.dataLabels.showCategoryName: 系列内のデータラベルにカテゴリ名を表示するかどうか。
seriesItem.dataLabels.showPercentage: 系列内のデータラベルにパーセント値を表示するかどうか。
seriesItem.dataLabels.separator: 系列内のデータラベルのセパレーター。
seriesItem.dataLabels.position: 系列内のデータラベルの位置。
seriesItem.dataLabels.format: 系列内のデータラベルの書式設定。
seriesItem.dataLabels.color: 系列内のデータラベルのテキスト色。
seriesItem.dataLabels.transparency: 系列内のデータラベルのテキストの透明度。
seriesItem.dataLabels.backColor: 系列内のデータラベルの背景色。
seriesItem.dataLabels.backColor.type: チャート系列dataLabelsのパターン塗りつぶし背景色タイプ。
seriesItem.dataLabels.backColor.foregroundColor: チャート系列dataLabelsの前景色のパターン塗りつぶし。
seriesItem.dataLabels.backColor.backgroundColor: チャート系列dataLabelsの背景色のパターン塗りつぶし。
seriesItem.dataLabels.backColorTransparency: 系列内のデータラベルの背景色の透明度。
seriesItem.dataLabels.borderColor: 系列内のデータラベルの境界線の色。
seriesItem.dataLabels.borderWidth: 系列内のデータラベルの境界線の幅。
seriesItem.dataLabels.borderColorTransparency: 系列内のデータラベルの境界線の色の透明度。

使用例

Javascript

// 次のサンプルコードは、新しい系列を追加する方法を示します。
var dataRange = "A1:D4";
var chart = activeSheet.charts.add('Chart1', GC.Spread.Sheets.Charts.ChartType.columnClustered, 250, 20, 600, 400, dataRange);
chart.series.add({
    chartType: GC.Spread.Sheets.Charts.ChartType.columnClustered,
    axisGroup: GC.Spread.Sheets.Charts.AxisGroup.primary,
    backColor: {
        color: "lightblue",
        width: 2
    },
    xValues: "A2:A4",
    yValues: "B2:B4"
});

参照

SeriesCollection タイプ