Excel.ChartSeries class

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

axisGroup: Excel.ChartAxisGroup | "Primary" | "Secondary";

プロパティ値

注釈

[API セット: ExcelApi 1.8]

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

readonly binOptions: Excel.ChartBinOptions;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

readonly boxwhiskerOptions: Excel.ChartBoxwhiskerOptions;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

bubbleScale: number;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

chartType: Excel.ChartType | "Invalid" | "ColumnClustered" | "ColumnStacked" | "ColumnStacked100" | "3DColumnClustered" | "3DColumnStacked" | "3DColumnStacked100" | "BarClustered" | "BarStacked" | "BarStacked100" | "3DBarClustered" | "3DBarStacked" | "3DBarStacked100" | "LineStacked" | "LineStacked100" | "LineMarkers" | "LineMarkersStacked" | "LineMarkersStacked100" | "PieOfPie" | "PieExploded" | "3DPieExploded" | "BarOfPie" | "XYScatterSmooth" | "XYScatterSmoothNoMarkers" | "XYScatterLines" | "XYScatterLinesNoMarkers" | "AreaStacked" | "AreaStacked100" | "3DAreaStacked" | "3DAreaStacked100" | "DoughnutExploded" | "RadarMarkers" | "RadarFilled" | "Surface" | "SurfaceWireframe" | "SurfaceTopView" | "SurfaceTopViewWireframe" | "Bubble" | "Bubble3DEffect" | "StockHLC" | "StockOHLC" | "StockVHLC" | "StockVOHLC" | "CylinderColClustered" | "CylinderColStacked" | "CylinderColStacked100" | "CylinderBarClustered" | "CylinderBarStacked" | "CylinderBarStacked100" | "CylinderCol" | "ConeColClustered" | "ConeColStacked" | "ConeColStacked100" | "ConeBarClustered" | "ConeBarStacked" | "ConeBarStacked100" | "ConeCol" | "PyramidColClustered" | "PyramidColStacked" | "PyramidColStacked100" | "PyramidBarClustered" | "PyramidBarStacked" | "PyramidBarStacked100" | "PyramidCol" | "3DColumn" | "Line" | "3DLine" | "3DPie" | "Pie" | "XYScatter" | "3DArea" | "Area" | "Doughnut" | "Radar" | "Histogram" | "Boxwhisker" | "Pareto" | "RegionMap" | "Treemap" | "Waterfall" | "Sunburst" | "Funnel";

プロパティ値

注釈

[API セット: ExcelApi 1.7]

オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。

context: RequestContext;

プロパティ値

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

readonly dataLabels: Excel.ChartDataLabels;

プロパティ値

注釈

[API セット: ExcelApi 1.8]

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

doughnutHoleSize: number;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

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

explosion: number;

プロパティ値

注釈

[API セット: ExcelApi 1.8]

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

filtered: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

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

firstSliceAngle: number;

プロパティ値

注釈

[API セット: ExcelApi 1.8]

塗りつぶしと線の書式設定を含む、グラフ シリーズの書式設定を表します。

readonly format: Excel.ChartSeriesFormat;

プロパティ値

注釈

[API セット: ExcelApi 1.1]

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

gapWidth: number;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

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

gradientMaximumColor: string;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

gradientMaximumType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

gradientMaximumValue: number;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

gradientMidpointColor: string;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

地域マップ グラフ系列の中間値の種類を指定します。

gradientMidpointType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";

プロパティ値

注釈

[API セット: ExcelApi 1.9]

地域マップ グラフ シリーズの中間値を指定します。

gradientMidpointValue: number;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

gradientMinimumColor: string;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

地域マップ グラフ シリーズの最小値の種類を指定します。

gradientMinimumType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";

プロパティ値

注釈

[API セット: ExcelApi 1.9]

地域マップ グラフ シリーズの最小値を指定します。

gradientMinimumValue: number;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

gradientStyle: Excel.ChartGradientStyle | "TwoPhaseColor" | "ThreePhaseColor";

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

hasDataLabels: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

系列内の負のデータ要素の塗りつぶしの色を指定します。

invertColor: string;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

アイテムが負の数に対応するときに、Excel が反転された場合は true。

invertIfNegative: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.8]

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

readonly mapOptions: Excel.ChartMapOptions;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

グラフ シリーズのマーカーの背景色を指定します。

markerBackgroundColor: string;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

グラフ シリーズのマーカーの前景色を指定します。

markerForegroundColor: string;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

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

markerSize: number;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

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

markerStyle: Excel.ChartMarkerStyle | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" | "Triangle" | "X" | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture";

プロパティ値

注釈

[API セット: ExcelApi 1.7]

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

name: string;

プロパティ値

注釈

[API セット: ExcelApi 1.1]

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

overlap: number;

プロパティ値

注釈

[API セット: ExcelApi 1.8]

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

parentLabelStrategy: Excel.ChartParentLabelStrategy | "None" | "Banner" | "Overlapping";

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

plotOrder: number;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

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

readonly points: Excel.ChartPointsCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.1]

円グラフまたは縦棒グラフのいずれかの第 2 セクションのサイズを、第 1 の円のサイズに対する割合で指定します。 5 から 200 の範囲内で値を指定できます。

secondPlotSize: number;

プロパティ値

注釈

[API セット: ExcelApi 1.8]

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

showConnectorLines: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

showLeaderLines: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

showShadow: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

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

smooth: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

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

splitType: Excel.ChartSplitType | "SplitByPosition" | "SplitByValue" | "SplitByPercentValue" | "SplitByCustomSplit";

プロパティ値

注釈

[API セット: ExcelApi 1.8]

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

splitValue: number;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

readonly trendlines: Excel.ChartTrendlineCollection;

プロパティ値

注釈

[API セット: ExcelApi 1.7]

Excel が各データ マーカーに異なる色またはパターンを割り当てている場合は true。 グラフに含まれるデータ系列は 1 つだけでなければなりません。

varyByCategories: boolean;

プロパティ値

注釈

[API セット: ExcelApi 1.8]

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

readonly xErrorBars: Excel.ChartErrorBars;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

readonly yErrorBars: Excel.ChartErrorBars;

プロパティ値

注釈

[API セット: ExcelApi 1.9]

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

delete(): void;

返品

注釈

[API セット: ExcelApi 1.7]

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

getDimensionDataSourceString(dimension: Excel.ChartSeriesDimension): OfficeExtension.ClientResult<string>;

パラメーター

返品

注釈

[API セット: ExcelApi 1.15]

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

getDimensionDataSourceString(dimension: "Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"): OfficeExtension.ClientResult<string>;

パラメーター

返品

注釈

[API セット: ExcelApi 1.15]

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

getDimensionDataSourceType(dimension: Excel.ChartSeriesDimension): OfficeExtension.ClientResult<Excel.ChartDataSourceType>;

パラメーター

返品

注釈

[API セット: ExcelApi 1.15]

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

getDimensionDataSourceType(dimension: "Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"): OfficeExtension.ClientResult<Excel.ChartDataSourceType>;

パラメーター

返品

注釈

[API セット: ExcelApi 1.15]

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

getDimensionValues(dimension: Excel.ChartSeriesDimension): OfficeExtension.ClientResult<string[]>;

パラメーター

返品

注釈

[API セット: ExcelApi 1.12]

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

getDimensionValues(dimension: "Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"): OfficeExtension.ClientResult<string[]>;

パラメーター

返品

注釈

[API セット: ExcelApi 1.12]

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(options?: Excel.Interfaces.ChartSeriesLoadOptions): Excel.ChartSeries;

パラメーター

返品

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNames?: string | string[]): Excel.ChartSeries;

パラメーター

返品

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.ChartSeries;

パラメーター

返品

オブジェクトの複数のプロパティを同時に設定します。 適切なプロパティを持つプレーン オブジェクト、または同じ型の別の API オブジェクトを渡すことができます。

set(properties: Interfaces.ChartSeriesUpdateData, options?: OfficeExtension.UpdateOptions): void;

パラメーター

返品

既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを同時に設定します。

set(properties: Excel.ChartSeries): void;

パラメーター

返品

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

setBubbleSizes(sourceData: Range): void;

パラメーター

返品

注釈

[API セット: ExcelApi 1.7]

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

setValues(sourceData: Range): void;

パラメーター

返品

注釈

[API セット: ExcelApi 1.7]

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

setXAxisValues(sourceData: Range): void;

パラメーター

返品

注釈

[API セット: ExcelApi 1.7]

API オブジェクトが JSON.stringify() に渡されるときに、より有用な出力を提供するために、JavaScript toJSON() メソッドをオーバーライドします。 (次に、JSON.stringify渡されたオブジェクトの toJSON メソッドを呼び出します)。元の Excel.ChartSeries オブジェクトが API オブジェクトであるのに対し、 toJSON メソッドは、元のオブジェクトから読み込まれた子プロパティの浅いコピーを含むプレーンな JavaScript オブジェクト ( Excel.Interfaces.ChartSeriesData と型指定) を返します。

toJSON(): Excel.Interfaces.ChartSeriesData;

返品