ExcelScript.ChartSeries interface

リファレンス

パッケージ:: ExcelScript

グラフのデータ系列を表します。

注釈

例

/**
 * This sample produces a line chart with two series.
 * The chart assumes data in A1:E5 that looks like this:
 * Product Qtr1 Qtr2 Qtr3 Qtr4
 * Frames 5000 7000 6544 4377
 * Saddles 400 323 276 651
 */
function main(workbook: ExcelScript.Workbook) {
  // Establish the ranges to use.
  const sheet = workbook.getActiveWorksheet();
  const headerRange = sheet.getRange("A1:E1");
  const firstSeriesRange = sheet.getRange("A2:E2");
  const secondSeriesRange = sheet.getRange("A3:E3");

  // Create the chart.
  const lineChart = sheet.addChart(ExcelScript.ChartType.line, headerRange);

  // Add the first chart series.
  const firstSeries = lineChart.addChartSeries();
  firstSeries.setXAxisValues(headerRange);
  firstSeries.setValues(firstSeriesRange);

  // Add the second chart series.
  const secondSeries = lineChart.addChartSeries();
  secondSeries.setXAxisValues(headerRange);
  secondSeries.setValues(secondSeriesRange);
}

メソッド

addChartTrendline(type)	近似曲線のコレクションに新しい近似曲線を追加します。
delete()	グラフ系列を削除します。
getAxisGroup()	指定した系列のグループを指定します。
getBinOptions()	ヒストグラム図とパレート図のビンのオプションをカプセル化します。
getBoxwhiskerOptions()	箱ひげ図グラフのオプションをカプセル化します。
getBubbleScale()	既定のサイズのパーセンテージを表す 0 (ゼロ) から 300 までの整数値とすることができます。このプロパティは、バブルチャートにのみ使用できます。
getChartTrendline(index)	インデックスによって近似曲線オブジェクトを取得します。これは、items 配列の挿入順序です。
getChartType()	グラフ系列の種類を表します。詳細は「`ExcelScript.ChartType`」をご覧ください。
getDataLabels()	系列内のすべてのデータラベルのコレクションを表します。
getDimensionDataSourceString(dimension)	グラフ系列のデータソースの文字列表現を取得します。文字列表現には、セルアドレスなどの情報を指定できます。
getDimensionDataSourceType(dimension)	グラフ系列のデータソースの種類を取得します。
getDimensionValues(dimension)	グラフ系列の 1 つのディメンションから値を取得します。これらは、指定されたディメンションと、グラフ系列のデータのマップ方法に応じて、カテゴリ値またはデータ値のいずれかです。
getDoughnutHoleSize()	グラフ系列のドーナツの穴の大きさを表します。ドーナツグラフとドーナツ分解グラフでのみ有効です。無効な `InvalidArgument` グラフでエラーをスローします。
getExplosion()	円グラフまたはドーナツグラフスライスの展開値を指定します。切り出し表示は行われず、スライスの先端が円の中心と一致する場合、0 を返します。
getFiltered()	系列をフィルター処理するかどうかを指定します。等高線グラフには適用されません。
getFirstSliceAngle()	最初の円グラフまたはドーナツグラフスライスの角度を度 (垂直から時計回り) で指定します。円グラフ、3-D 円グラフ、およびドーナツグラフにのみ適用されます。 0 から 360 の範囲内で値を指定できます。
getFormat()	塗りつぶしと線の書式設定を含むグラフ系列の書式設定を表します。
getGapWidth()	グラフ系列間に設けられる間隔を表します。横棒グラフと縦棒グラフ、および折れ線グラフと円グラフの特定のクラスでのみ有効です。無効なグラフで無効な引数例外をスローします。
getGradientMaximumColor()	領域マップグラフ系列の最大値の色を指定します。
getGradientMaximumType()	領域マップグラフ系列の最大値の型を指定します。
getGradientMaximumValue()	領域マップグラフ系列の最大値を指定します。
getGradientMidpointColor()	領域マップグラフ系列の中点値の色を指定します。
getGradientMidpointType()	リージョンマップグラフ系列の中点値の型を指定します。
getGradientMidpointValue()	リージョンマップグラフ系列の中点の値を指定します。
getGradientMinimumColor()	領域マップグラフ系列の最小値の色を指定します。
getGradientMinimumType()	地域マップグラフ系列の最小値の型を指定します。
getGradientMinimumValue()	領域マップグラフ系列の最小値を指定します。
getGradientStyle()	領域マップグラフの系列グラデーションスタイルを指定します。
getHasDataLabels()	系列にデータラベルがあるかどうかを指定します。
getInvertColor()	系列内の負のデータポイントの塗りつぶしの色を指定します。
getInvertIfNegative()	True の場合は、負の数値に対応するアイテムのパターンを反転します。
getMapOptions()	リージョンマップグラフのオプションをカプセル化します。
getMarkerBackgroundColor()	グラフ系列のマーカーの背景色を指定します。
getMarkerForegroundColor()	グラフ系列のマーカーの前景色を指定します。
getMarkerSize()	グラフ系列のマーカーサイズを指定します。
getMarkerStyle()	グラフ系列のマーカースタイルを指定します。詳細は「`ExcelScript.ChartMarkerStyle`」をご覧ください。
getName()	グラフ内の系列の名前を指定します。名前の長さは 255 文字を超えてはなりません。
getOverlap()	横棒と縦棒の配置方法を指定します。 -100 から 100 の範囲内で値を指定できます。 2-D 横棒グラフと 2-D 縦棒グラフにのみ適用されます。
getParentLabelStrategy()	ツリーマップグラフの系列親ラベル戦略領域を指定します。
getPlotOrder()	グラフグループ内のグラフ系列のプロット順序を指定します。
getPoints()	系列内のすべてのポイントのコレクションを返します。
getSecondPlotSize()	円グラフまたは円グラフの 2 番目のセクションのサイズを、1 次円グラフのサイズに対する割合として指定します。 5 から 200 の範囲内で値を指定できます。
getShowConnectorLines()	コネクタ線をウォーターフォールグラフに表示するかどうかを指定します。
getShowLeaderLines()	系列内のデータラベルごとに引出し線を表示するかどうかを指定します。
getShowShadow()	系列に影があるかどうかを指定します。
getSmooth()	系列がスムーズかどうかを指定します。折れ線グラフと散布図にのみ適用されます。
getSplitType()	円グラフまたは円グラフの 2 つのセクションを分割する方法を指定します。
getSplitValue()	円グラフまたは円グラフの 2 つのセクションを区切るしきい値を指定します。
getTrendlines()	系列内の近似曲線のコレクション。
getVaryByCategories()	True を指定すると、各データマーカーに異なる色またはパターンが割り当てられます。グラフに含まれるデータ系列は 1 つだけでなければなりません。
getXErrorBars()	グラフ系列の誤差範囲オブジェクトを表します。
getYErrorBars()	グラフ系列の誤差範囲オブジェクトを表します。
setAxisGroup(axisGroup)	指定した系列のグループを指定します。
setBubbleScale(bubbleScale)	既定のサイズのパーセンテージを表す 0 (ゼロ) から 300 までの整数値とすることができます。このプロパティは、バブルチャートにのみ使用できます。
setBubbleSizes(sourceData)	グラフ系列のバブルサイズを設定します。バブルチャートにのみ適用されます。
setChartType(chartType)	グラフ系列の種類を表します。詳細は「`ExcelScript.ChartType`」をご覧ください。
setDoughnutHoleSize(doughnutHoleSize)	グラフ系列のドーナツの穴の大きさを表します。ドーナツグラフとドーナツ分解グラフでのみ有効です。無効な `InvalidArgument` グラフでエラーをスローします。
setExplosion(explosion)	円グラフまたはドーナツグラフスライスの展開値を指定します。切り出し表示は行われず、スライスの先端が円の中心と一致する場合、0 を返します。
setFiltered(filtered)	系列をフィルター処理するかどうかを指定します。等高線グラフには適用されません。
setFirstSliceAngle(firstSliceAngle)	最初の円グラフまたはドーナツグラフスライスの角度を度 (垂直から時計回り) で指定します。円グラフ、3-D 円グラフ、およびドーナツグラフにのみ適用されます。 0 から 360 の範囲内で値を指定できます。
setGapWidth(gapWidth)	グラフ系列間に設けられる間隔を表します。横棒グラフと縦棒グラフ、および折れ線グラフと円グラフの特定のクラスでのみ有効です。無効なグラフで無効な引数例外をスローします。
setGradientMaximumColor(gradientMaximumColor)	領域マップグラフ系列の最大値の色を指定します。
setGradientMaximumType(gradientMaximumType)	領域マップグラフ系列の最大値の型を指定します。
setGradientMaximumValue(gradientMaximumValue)	領域マップグラフ系列の最大値を指定します。
setGradientMidpointColor(gradientMidpointColor)	領域マップグラフ系列の中点値の色を指定します。
setGradientMidpointType(gradientMidpointType)	リージョンマップグラフ系列の中点値の型を指定します。
setGradientMidpointValue(gradientMidpointValue)	リージョンマップグラフ系列の中点の値を指定します。
setGradientMinimumColor(gradientMinimumColor)	領域マップグラフ系列の最小値の色を指定します。
setGradientMinimumType(gradientMinimumType)	地域マップグラフ系列の最小値の型を指定します。
setGradientMinimumValue(gradientMinimumValue)	領域マップグラフ系列の最小値を指定します。
setGradientStyle(gradientStyle)	領域マップグラフの系列グラデーションスタイルを指定します。
setHasDataLabels(hasDataLabels)	系列にデータラベルがあるかどうかを指定します。
setInvertColor(invertColor)	系列内の負のデータポイントの塗りつぶしの色を指定します。
setInvertIfNegative(invertIfNegative)	True の場合は、負の数値に対応するアイテムのパターンを反転します。
setMarkerBackgroundColor(markerBackgroundColor)	グラフ系列のマーカーの背景色を指定します。
setMarkerForegroundColor(markerForegroundColor)	グラフ系列のマーカーの前景色を指定します。
setMarkerSize(markerSize)	グラフ系列のマーカーサイズを指定します。
setMarkerStyle(markerStyle)	グラフ系列のマーカースタイルを指定します。詳細は「`ExcelScript.ChartMarkerStyle`」をご覧ください。
setName(name)	グラフ内の系列の名前を指定します。名前の長さは 255 文字を超えてはなりません。
setOverlap(overlap)	横棒と縦棒の配置方法を指定します。 -100 から 100 の範囲内で値を指定できます。 2-D 横棒グラフと 2-D 縦棒グラフにのみ適用されます。
setParentLabelStrategy(parentLabelStrategy)	ツリーマップグラフの系列親ラベル戦略領域を指定します。
setPlotOrder(plotOrder)	グラフグループ内のグラフ系列のプロット順序を指定します。
setSecondPlotSize(secondPlotSize)	円グラフまたは円グラフの 2 番目のセクションのサイズを、1 次円グラフのサイズに対する割合として指定します。 5 から 200 の範囲内で値を指定できます。
setShowConnectorLines(showConnectorLines)	コネクタ線をウォーターフォールグラフに表示するかどうかを指定します。
setShowLeaderLines(showLeaderLines)	系列内のデータラベルごとに引出し線を表示するかどうかを指定します。
setShowShadow(showShadow)	系列に影があるかどうかを指定します。
setSmooth(smooth)	系列がスムーズかどうかを指定します。折れ線グラフと散布図にのみ適用されます。
setSplitType(splitType)	円グラフまたは円グラフの 2 つのセクションを分割する方法を指定します。
setSplitValue(splitValue)	円グラフまたは円グラフの 2 つのセクションを区切るしきい値を指定します。
setValues(sourceData)	グラフ系列の値を設定します。散布図の場合は、y 軸の値を参照します。
setVaryByCategories(varyByCategories)	True を指定すると、各データマーカーに異なる色またはパターンが割り当てられます。グラフに含まれるデータ系列は 1 つだけでなければなりません。
setXAxisValues(sourceData)	グラフ系列の x 軸の値を設定します。

メソッドの詳細

addChartTrendline(type)

近似曲線のコレクションに新しい近似曲線を追加します。

addChartTrendline(type?: ChartTrendlineType): ChartTrendline;

パラメーター

type: ExcelScript.ChartTrendlineType

近似曲線の種類を指定します。既定値は "Linear" です。詳細は「ExcelScript.ChartTrendline」をご覧ください。

戻り値

ExcelScript.ChartTrendline

delete()

グラフ系列を削除します。

delete(): void;

戻り値

void

getAxisGroup()

指定した系列のグループを指定します。

getAxisGroup(): ChartAxisGroup;

戻り値

ExcelScript.ChartAxisGroup

getBinOptions()

ヒストグラム図とパレート図のビンのオプションをカプセル化します。

getBinOptions(): ChartBinOptions;

戻り値

ExcelScript.ChartBinOptions

getBoxwhiskerOptions()

箱ひげ図グラフのオプションをカプセル化します。

getBoxwhiskerOptions(): ChartBoxwhiskerOptions;

戻り値

ExcelScript.ChartBoxwhiskerOptions

getBubbleScale()

既定のサイズのパーセンテージを表す 0 (ゼロ) から 300 までの整数値とすることができます。このプロパティは、バブルチャートにのみ使用できます。

getBubbleScale(): number;

戻り値

number

getChartTrendline(index)

インデックスによって近似曲線オブジェクトを取得します。これは、items 配列の挿入順序です。

getChartTrendline(index: number): ChartTrendline;

パラメーター

index: number

items 配列内の挿入順序を表します。

戻り値

ExcelScript.ChartTrendline

getChartType()

グラフ系列の種類を表します。詳細は「ExcelScript.ChartType」をご覧ください。

getChartType(): ChartType;

戻り値

ExcelScript.ChartType

getDataLabels()

系列内のすべてのデータラベルのコレクションを表します。

getDataLabels(): ChartDataLabels;

戻り値

ExcelScript.ChartDataLabels

getDimensionDataSourceString(dimension)

グラフ系列のデータソースの文字列表現を取得します。文字列表現には、セルアドレスなどの情報を指定できます。

getDimensionDataSourceString(dimension: ChartSeriesDimension): string;

パラメーター

dimension: ExcelScript.ChartSeriesDimension

データの元の軸のディメンション。

戻り値

string

getDimensionDataSourceType(dimension)

グラフ系列のデータソースの種類を取得します。

getDimensionDataSourceType(
            dimension: ChartSeriesDimension
        ): ChartDataSourceType;

パラメーター

dimension: ExcelScript.ChartSeriesDimension

データの元の軸のディメンション。

戻り値

ExcelScript.ChartDataSourceType

getDimensionValues(dimension)

グラフ系列の 1 つのディメンションから値を取得します。これらは、指定されたディメンションと、グラフ系列のデータのマップ方法に応じて、カテゴリ値またはデータ値のいずれかです。

getDimensionValues(dimension: ChartSeriesDimension): string[];

パラメーター

dimension: ExcelScript.ChartSeriesDimension

データの元の軸のディメンション。

戻り値

string[]

getDoughnutHoleSize()

グラフ系列のドーナツの穴の大きさを表します。ドーナツグラフとドーナツ分解グラフでのみ有効です。無効な InvalidArgument グラフでエラーをスローします。

getDoughnutHoleSize(): number;

戻り値

number

getExplosion()

円グラフまたはドーナツグラフスライスの展開値を指定します。切り出し表示は行われず、スライスの先端が円の中心と一致する場合、0 を返します。

getExplosion(): number;

戻り値

number

getFiltered()

系列をフィルター処理するかどうかを指定します。等高線グラフには適用されません。

getFiltered(): boolean;

戻り値

boolean

getFirstSliceAngle()

最初の円グラフまたはドーナツグラフスライスの角度を度 (垂直から時計回り) で指定します。円グラフ、3-D 円グラフ、およびドーナツグラフにのみ適用されます。 0 から 360 の範囲内で値を指定できます。

getFirstSliceAngle(): number;

戻り値

number

getFormat()

塗りつぶしと線の書式設定を含むグラフ系列の書式設定を表します。

getFormat(): ChartSeriesFormat;

戻り値

ExcelScript.ChartSeriesFormat

getGapWidth()

グラフ系列間に設けられる間隔を表します。横棒グラフと縦棒グラフ、および折れ線グラフと円グラフの特定のクラスでのみ有効です。無効なグラフで無効な引数例外をスローします。

getGapWidth(): number;

戻り値

number

getGradientMaximumColor()

領域マップグラフ系列の最大値の色を指定します。

getGradientMaximumColor(): string;

戻り値

string

getGradientMaximumType()

領域マップグラフ系列の最大値の型を指定します。

getGradientMaximumType(): ChartGradientStyleType;

戻り値

ExcelScript.ChartGradientStyleType

getGradientMaximumValue()

領域マップグラフ系列の最大値を指定します。

getGradientMaximumValue(): number;

戻り値

number

getGradientMidpointColor()

領域マップグラフ系列の中点値の色を指定します。

getGradientMidpointColor(): string;

戻り値

string

getGradientMidpointType()

リージョンマップグラフ系列の中点値の型を指定します。

getGradientMidpointType(): ChartGradientStyleType;

戻り値

ExcelScript.ChartGradientStyleType

getGradientMidpointValue()

リージョンマップグラフ系列の中点の値を指定します。

getGradientMidpointValue(): number;

戻り値

number

getGradientMinimumColor()

領域マップグラフ系列の最小値の色を指定します。

getGradientMinimumColor(): string;

戻り値

string

getGradientMinimumType()

地域マップグラフ系列の最小値の型を指定します。

getGradientMinimumType(): ChartGradientStyleType;

戻り値

ExcelScript.ChartGradientStyleType

getGradientMinimumValue()

領域マップグラフ系列の最小値を指定します。

getGradientMinimumValue(): number;

戻り値

number

getGradientStyle()

領域マップグラフの系列グラデーションスタイルを指定します。

getGradientStyle(): ChartGradientStyle;

戻り値

ExcelScript.ChartGradientStyle

getHasDataLabels()

系列にデータラベルがあるかどうかを指定します。

getHasDataLabels(): boolean;

戻り値

boolean

getInvertColor()

系列内の負のデータポイントの塗りつぶしの色を指定します。

getInvertColor(): string;

戻り値

string

getInvertIfNegative()

True の場合は、負の数値に対応するアイテムのパターンを反転します。

getInvertIfNegative(): boolean;

戻り値

boolean

getMapOptions()

リージョンマップグラフのオプションをカプセル化します。

getMapOptions(): ChartMapOptions;

戻り値

ExcelScript.ChartMapOptions

getMarkerBackgroundColor()

グラフ系列のマーカーの背景色を指定します。

getMarkerBackgroundColor(): string;

戻り値

string

getMarkerForegroundColor()

グラフ系列のマーカーの前景色を指定します。

getMarkerForegroundColor(): string;

戻り値

string

getMarkerSize()

グラフ系列のマーカーサイズを指定します。

getMarkerSize(): number;

戻り値

number

getMarkerStyle()

グラフ系列のマーカースタイルを指定します。詳細は「ExcelScript.ChartMarkerStyle」をご覧ください。

getMarkerStyle(): ChartMarkerStyle;

戻り値

ExcelScript.ChartMarkerStyle

getName()

グラフ内の系列の名前を指定します。名前の長さは 255 文字を超えてはなりません。

getName(): string;

戻り値

string

例

/**
 * This sample logs the names of each of the chart series in a chart named "ColumnClusteredChart".
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current worksheet.
  let selectedSheet = workbook.getActiveWorksheet();

  // Get an existing chart named "ColumnClusteredChart".
  let chart = selectedSheet.getChart("ColumnClusteredChart");

  // Log the name of each chart series in the chart.
  let seriesList = chart.getSeries();
  seriesList.forEach((series) => {
    console.log(series.getName());
  });
}

getOverlap()

横棒と縦棒の配置方法を指定します。 -100 から 100 の範囲内で値を指定できます。 2-D 横棒グラフと 2-D 縦棒グラフにのみ適用されます。

getOverlap(): number;

戻り値

number

getParentLabelStrategy()

ツリーマップグラフの系列親ラベル戦略領域を指定します。

getParentLabelStrategy(): ChartParentLabelStrategy;

戻り値

ExcelScript.ChartParentLabelStrategy

getPlotOrder()

グラフグループ内のグラフ系列のプロット順序を指定します。

getPlotOrder(): number;

戻り値

number

getPoints()

系列内のすべてのポイントのコレクションを返します。

getPoints(): ChartPoint[];

戻り値

ExcelScript.ChartPoint[]

getSecondPlotSize()

円グラフまたは円グラフの 2 番目のセクションのサイズを、1 次円グラフのサイズに対する割合として指定します。 5 から 200 の範囲内で値を指定できます。

getSecondPlotSize(): number;

戻り値

number

getShowConnectorLines()

コネクタ線をウォーターフォールグラフに表示するかどうかを指定します。

getShowConnectorLines(): boolean;

戻り値

boolean

getShowLeaderLines()

系列内のデータラベルごとに引出し線を表示するかどうかを指定します。

getShowLeaderLines(): boolean;

戻り値

boolean

getShowShadow()

系列に影があるかどうかを指定します。

getShowShadow(): boolean;

戻り値

boolean

getSmooth()

系列がスムーズかどうかを指定します。折れ線グラフと散布図にのみ適用されます。

getSmooth(): boolean;

戻り値

boolean

getSplitType()

円グラフまたは円グラフの 2 つのセクションを分割する方法を指定します。

getSplitType(): ChartSplitType;

戻り値

ExcelScript.ChartSplitType

getSplitValue()

円グラフまたは円グラフの 2 つのセクションを区切るしきい値を指定します。

getSplitValue(): number;

戻り値

number

getTrendlines()

系列内の近似曲線のコレクション。

getTrendlines(): ChartTrendline[];

戻り値

ExcelScript.ChartTrendline[]

getVaryByCategories()

True を指定すると、各データマーカーに異なる色またはパターンが割り当てられます。グラフに含まれるデータ系列は 1 つだけでなければなりません。

getVaryByCategories(): boolean;

戻り値

boolean

getXErrorBars()

グラフ系列の誤差範囲オブジェクトを表します。

getXErrorBars(): ChartErrorBars;

戻り値

ExcelScript.ChartErrorBars

getYErrorBars()

グラフ系列の誤差範囲オブジェクトを表します。

getYErrorBars(): ChartErrorBars;

戻り値

ExcelScript.ChartErrorBars

例

/**
 * This script adds error bars for the standard error of each chart series point.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range for the chart.
  const worksheet = workbook.getWorksheet("Sample");
  const dataRange = worksheet.getRange("A1:B15");

  // Create a line chart.
  const chart = worksheet.addChart(ExcelScript.ChartType.line, dataRange);

  // For each series, add error bars for the standard error on each point
  const allSeries = chart.getSeries();
  allSeries.forEach((series) => {
    series.getYErrorBars().setType(ExcelScript.ChartErrorBarsType.stError);
    series.getYErrorBars().setVisible(true);
  });
}

setAxisGroup(axisGroup)

指定した系列のグループを指定します。

setAxisGroup(axisGroup: ChartAxisGroup): void;

パラメーター

axisGroup: ExcelScript.ChartAxisGroup

戻り値

void

setBubbleScale(bubbleScale)

setBubbleScale(bubbleScale: number): void;

パラメーター

bubbleScale: number

戻り値

void

setBubbleSizes(sourceData)

グラフ系列のバブルサイズを設定します。バブルチャートにのみ適用されます。

setBubbleSizes(sourceData: Range): void;

パラメーター

sourceData: ExcelScript.Range

Rangeソースデータに対応するオブジェクト。

戻り値

void

setChartType(chartType)

グラフ系列の種類を表します。詳細は「ExcelScript.ChartType」をご覧ください。

setChartType(chartType: ChartType): void;

パラメーター

chartType: ExcelScript.ChartType

戻り値

void

setDoughnutHoleSize(doughnutHoleSize)

setDoughnutHoleSize(doughnutHoleSize: number): void;

パラメーター

doughnutHoleSize: number

戻り値

void

setExplosion(explosion)

setExplosion(explosion: number): void;

パラメーター

explosion: number

戻り値

void

setFiltered(filtered)

系列をフィルター処理するかどうかを指定します。等高線グラフには適用されません。

setFiltered(filtered: boolean): void;

パラメーター

filtered: boolean

戻り値

void

setFirstSliceAngle(firstSliceAngle)

setFirstSliceAngle(firstSliceAngle: number): void;

パラメーター

firstSliceAngle: number

戻り値

void

setGapWidth(gapWidth)

setGapWidth(gapWidth: number): void;

パラメーター

gapWidth: number

戻り値

void

setGradientMaximumColor(gradientMaximumColor)

領域マップグラフ系列の最大値の色を指定します。

setGradientMaximumColor(gradientMaximumColor: string): void;

パラメーター

gradientMaximumColor: string

戻り値

void

setGradientMaximumType(gradientMaximumType)

領域マップグラフ系列の最大値の型を指定します。

setGradientMaximumType(
            gradientMaximumType: ChartGradientStyleType
        ): void;

パラメーター

gradientMaximumType: ExcelScript.ChartGradientStyleType

戻り値

void

setGradientMaximumValue(gradientMaximumValue)

領域マップグラフ系列の最大値を指定します。

setGradientMaximumValue(gradientMaximumValue: number): void;

パラメーター

gradientMaximumValue: number

戻り値

void

setGradientMidpointColor(gradientMidpointColor)

領域マップグラフ系列の中点値の色を指定します。

setGradientMidpointColor(gradientMidpointColor: string): void;

パラメーター

gradientMidpointColor: string

戻り値

void

setGradientMidpointType(gradientMidpointType)

リージョンマップグラフ系列の中点値の型を指定します。

setGradientMidpointType(
            gradientMidpointType: ChartGradientStyleType
        ): void;

パラメーター

gradientMidpointType: ExcelScript.ChartGradientStyleType

戻り値

void

setGradientMidpointValue(gradientMidpointValue)

リージョンマップグラフ系列の中点の値を指定します。

setGradientMidpointValue(gradientMidpointValue: number): void;

パラメーター

gradientMidpointValue: number

戻り値

void

setGradientMinimumColor(gradientMinimumColor)

領域マップグラフ系列の最小値の色を指定します。

setGradientMinimumColor(gradientMinimumColor: string): void;

パラメーター

gradientMinimumColor: string

戻り値

void

setGradientMinimumType(gradientMinimumType)

地域マップグラフ系列の最小値の型を指定します。

setGradientMinimumType(
            gradientMinimumType: ChartGradientStyleType
        ): void;

パラメーター

gradientMinimumType: ExcelScript.ChartGradientStyleType

戻り値

void

setGradientMinimumValue(gradientMinimumValue)

領域マップグラフ系列の最小値を指定します。

setGradientMinimumValue(gradientMinimumValue: number): void;

パラメーター

gradientMinimumValue: number

戻り値

void

setGradientStyle(gradientStyle)

領域マップグラフの系列グラデーションスタイルを指定します。

setGradientStyle(gradientStyle: ChartGradientStyle): void;

パラメーター

gradientStyle: ExcelScript.ChartGradientStyle

戻り値

void

setHasDataLabels(hasDataLabels)

系列にデータラベルがあるかどうかを指定します。

setHasDataLabels(hasDataLabels: boolean): void;

パラメーター

hasDataLabels: boolean

戻り値

void

setInvertColor(invertColor)

系列内の負のデータポイントの塗りつぶしの色を指定します。

setInvertColor(invertColor: string): void;

パラメーター

invertColor: string

戻り値

void

setInvertIfNegative(invertIfNegative)

True の場合は、負の数値に対応するアイテムのパターンを反転します。

setInvertIfNegative(invertIfNegative: boolean): void;

パラメーター

invertIfNegative: boolean

戻り値

void

setMarkerBackgroundColor(markerBackgroundColor)

グラフ系列のマーカーの背景色を指定します。

setMarkerBackgroundColor(markerBackgroundColor: string): void;

パラメーター

markerBackgroundColor: string

戻り値

void

setMarkerForegroundColor(markerForegroundColor)

グラフ系列のマーカーの前景色を指定します。

setMarkerForegroundColor(markerForegroundColor: string): void;

パラメーター

markerForegroundColor: string

戻り値

void

setMarkerSize(markerSize)

グラフ系列のマーカーサイズを指定します。

setMarkerSize(markerSize: number): void;

パラメーター

markerSize: number

戻り値

void

setMarkerStyle(markerStyle)

グラフ系列のマーカースタイルを指定します。詳細は「ExcelScript.ChartMarkerStyle」をご覧ください。

setMarkerStyle(markerStyle: ChartMarkerStyle): void;

パラメーター

markerStyle: ExcelScript.ChartMarkerStyle

戻り値

void

setName(name)

グラフ内の系列の名前を指定します。名前の長さは 255 文字を超えてはなりません。

setName(name: string): void;

パラメーター

name: string

戻り値

void

setOverlap(overlap)

横棒と縦棒の配置方法を指定します。 -100 から 100 の範囲内で値を指定できます。 2-D 横棒グラフと 2-D 縦棒グラフにのみ適用されます。

setOverlap(overlap: number): void;

パラメーター

overlap: number

戻り値

void

例

/**
 * This sample sets the overlap of the columns in a chart named "ColumnClusteredChart".
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current worksheet.
  let selectedSheet = workbook.getActiveWorksheet();

  // Get an existing chart named "ColumnClusteredChart".
  let chart = selectedSheet.getChart("ColumnClusteredChart");

  // Set the overlap of every column of each series within a category.
  let seriesList = chart.getSeries();
  seriesList.forEach((series) => {
    // An overlap of 25 means the columns have 25% of their length overlapping with the adjacent columns in the same category.
    series.setOverlap(25);
  });
}

setParentLabelStrategy(parentLabelStrategy)

ツリーマップグラフの系列親ラベル戦略領域を指定します。

setParentLabelStrategy(
            parentLabelStrategy: ChartParentLabelStrategy
        ): void;

パラメーター

parentLabelStrategy: ExcelScript.ChartParentLabelStrategy

戻り値

void

setPlotOrder(plotOrder)

グラフグループ内のグラフ系列のプロット順序を指定します。

setPlotOrder(plotOrder: number): void;

パラメーター

plotOrder: number

戻り値

void

setSecondPlotSize(secondPlotSize)

setSecondPlotSize(secondPlotSize: number): void;

パラメーター

secondPlotSize: number

戻り値

void

setShowConnectorLines(showConnectorLines)

コネクタ線をウォーターフォールグラフに表示するかどうかを指定します。

setShowConnectorLines(showConnectorLines: boolean): void;

パラメーター

showConnectorLines: boolean

戻り値

void

setShowLeaderLines(showLeaderLines)

系列内のデータラベルごとに引出し線を表示するかどうかを指定します。

setShowLeaderLines(showLeaderLines: boolean): void;

パラメーター

showLeaderLines: boolean

戻り値

void

setShowShadow(showShadow)

系列に影があるかどうかを指定します。

setShowShadow(showShadow: boolean): void;

パラメーター

showShadow: boolean

戻り値

void

setSmooth(smooth)

系列がスムーズかどうかを指定します。折れ線グラフと散布図にのみ適用されます。

setSmooth(smooth: boolean): void;

パラメーター

smooth: boolean

戻り値

void

setSplitType(splitType)

円グラフまたは円グラフの 2 つのセクションを分割する方法を指定します。

setSplitType(splitType: ChartSplitType): void;

パラメーター

splitType: ExcelScript.ChartSplitType

戻り値

void

setSplitValue(splitValue)

円グラフまたは円グラフの 2 つのセクションを区切るしきい値を指定します。

setSplitValue(splitValue: number): void;

パラメーター

splitValue: number

戻り値

void

setValues(sourceData)

グラフ系列の値を設定します。散布図の場合は、y 軸の値を参照します。

setValues(sourceData: Range): void;

パラメーター

sourceData: ExcelScript.Range

Rangeソースデータに対応するオブジェクト。

戻り値

void

setVaryByCategories(varyByCategories)

setVaryByCategories(varyByCategories: boolean): void;

パラメーター

varyByCategories: boolean

戻り値

void

setXAxisValues(sourceData)

グラフ系列の x 軸の値を設定します。

setXAxisValues(sourceData: Range): void;

パラメーター

sourceData: ExcelScript.Range

Rangeソースデータに対応するオブジェクト。

戻り値

void