次の方法で共有


ExcelScript.ChartSeries interface

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

注釈

/**
 * 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()

グラフ系列のマーカー サイズを指定します。 サポートされているサイズの範囲は 2 ~ 72 です。 サポートされている範囲外のサイズで設定されている場合、このメソッドは InvalidArgument エラーを返します。

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)

グラフ系列のマーカー サイズを指定します。 サポートされているサイズの範囲は 2 ~ 72 です。 サポートされている範囲外のサイズで設定されている場合、このメソッドは InvalidArgument エラーを返します。

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」をご覧ください。

戻り値

delete()

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

delete(): void;

戻り値

void

getAxisGroup()

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

getAxisGroup(): ChartAxisGroup;

戻り値

getBinOptions()

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

getBinOptions(): ChartBinOptions;

戻り値

getBoxwhiskerOptions()

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

getBoxwhiskerOptions(): ChartBoxwhiskerOptions;

戻り値

getBubbleScale()

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

getBubbleScale(): number;

戻り値

number

getChartTrendline(index)

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

getChartTrendline(index: number): ChartTrendline;

パラメーター

index

number

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

戻り値

getChartType()

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

getChartType(): ChartType;

戻り値

getDataLabels()

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

getDataLabels(): ChartDataLabels;

戻り値

getDimensionDataSourceString(dimension)

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

getDimensionDataSourceString(dimension: ChartSeriesDimension): string;

パラメーター

dimension
ExcelScript.ChartSeriesDimension

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

戻り値

string

getDimensionDataSourceType(dimension)

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

getDimensionDataSourceType(
            dimension: ChartSeriesDimension
        ): ChartDataSourceType;

パラメーター

dimension
ExcelScript.ChartSeriesDimension

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

戻り値

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;

戻り値

getGapWidth()

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

getGapWidth(): number;

戻り値

number

getGradientMaximumColor()

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

getGradientMaximumColor(): string;

戻り値

string

getGradientMaximumType()

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

getGradientMaximumType(): ChartGradientStyleType;

戻り値

getGradientMaximumValue()

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

getGradientMaximumValue(): number;

戻り値

number

getGradientMidpointColor()

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

getGradientMidpointColor(): string;

戻り値

string

getGradientMidpointType()

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

getGradientMidpointType(): ChartGradientStyleType;

戻り値

getGradientMidpointValue()

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

getGradientMidpointValue(): number;

戻り値

number

getGradientMinimumColor()

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

getGradientMinimumColor(): string;

戻り値

string

getGradientMinimumType()

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

getGradientMinimumType(): ChartGradientStyleType;

戻り値

getGradientMinimumValue()

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

getGradientMinimumValue(): number;

戻り値

number

getGradientStyle()

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

getGradientStyle(): ChartGradientStyle;

戻り値

getHasDataLabels()

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

getHasDataLabels(): boolean;

戻り値

boolean

getInvertColor()

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

getInvertColor(): string;

戻り値

string

getInvertIfNegative()

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

getInvertIfNegative(): boolean;

戻り値

boolean

getMapOptions()

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

getMapOptions(): ChartMapOptions;

戻り値

getMarkerBackgroundColor()

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

getMarkerBackgroundColor(): string;

戻り値

string

getMarkerForegroundColor()

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

getMarkerForegroundColor(): string;

戻り値

string

getMarkerSize()

グラフ系列のマーカー サイズを指定します。 サポートされているサイズの範囲は 2 ~ 72 です。 サポートされている範囲外のサイズで設定されている場合、このメソッドは InvalidArgument エラーを返します。

getMarkerSize(): number;

戻り値

number

getMarkerStyle()

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

getMarkerStyle(): 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;

戻り値

getPlotOrder()

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

getPlotOrder(): number;

戻り値

number

getPoints()

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

getPoints(): 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;

戻り値

getSplitValue()

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

getSplitValue(): number;

戻り値

number

getTrendlines()

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

getTrendlines(): ChartTrendline[];

戻り値

getVaryByCategories()

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

getVaryByCategories(): boolean;

戻り値

boolean

getXErrorBars()

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

getXErrorBars(): ChartErrorBars;

戻り値

getYErrorBars()

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

getYErrorBars(): 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;

パラメーター

戻り値

void

setBubbleScale(bubbleScale)

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

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;

パラメーター

戻り値

void

setDoughnutHoleSize(doughnutHoleSize)

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

setDoughnutHoleSize(doughnutHoleSize: number): void;

パラメーター

doughnutHoleSize

number

戻り値

void

setExplosion(explosion)

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

setExplosion(explosion: number): void;

パラメーター

explosion

number

戻り値

void

setFiltered(filtered)

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

setFiltered(filtered: boolean): void;

パラメーター

filtered

boolean

戻り値

void

setFirstSliceAngle(firstSliceAngle)

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

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;

パラメーター

戻り値

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;

パラメーター

戻り値

void

setGradientMinimumValue(gradientMinimumValue)

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

setGradientMinimumValue(gradientMinimumValue: number): void;

パラメーター

gradientMinimumValue

number

戻り値

void

setGradientStyle(gradientStyle)

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

setGradientStyle(gradientStyle: ChartGradientStyle): void;

パラメーター

戻り値

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)

グラフ系列のマーカー サイズを指定します。 サポートされているサイズの範囲は 2 ~ 72 です。 サポートされている範囲外のサイズで設定されている場合、このメソッドは InvalidArgument エラーを返します。

setMarkerSize(markerSize: number): void;

パラメーター

markerSize

number

戻り値

void

setMarkerStyle(markerStyle)

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

setMarkerStyle(markerStyle: ChartMarkerStyle): void;

パラメーター

戻り値

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;

パラメーター

戻り値

void

setPlotOrder(plotOrder)

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

setPlotOrder(plotOrder: number): void;

パラメーター

plotOrder

number

戻り値

void

setSecondPlotSize(secondPlotSize)

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

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;

パラメーター

戻り値

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)

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

setVaryByCategories(varyByCategories: boolean): void;

パラメーター

varyByCategories

boolean

戻り値

void

setXAxisValues(sourceData)

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

setXAxisValues(sourceData: Range): void;

パラメーター

sourceData
ExcelScript.Range

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

戻り値

void