Excel.ChartSeries class

グラフのデータ系列を表します。Represents a series in a chart.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

Extends

プロパティ

axisGroup

指定した系列のグループを取得または設定します。Returns or sets the group for the specified series. 読み取り/書き込みRead/Write

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

binOptions

ヒストグラムグラフおよびパレート図の bin オプションをカプセル化します。Encapsulates the bin options for histogram charts and pareto charts. 読み取り専用です。Read-only.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

boxwhiskerOptions

箱ひげ図のオプションをカプセル化します。Encapsulates the options for the box and whisker charts. 読み取り専用です。Read-only.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

bubbleScale

これは、既定のサイズの割合を表す 0 (ゼロ) から300までの整数値にすることができます。This can be an integer value from 0 (zero) to 300, representing the percentage of the default size. このプロパティは、バブルチャートにのみ適用されます。This property only applies to bubble charts. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

chartType

グラフ系列の種類を表します。Represents the chart type of a series. 詳細については、「ChartType」を参照してください。See Excel.ChartType for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

context

オブジェクトに関連付けられている要求コンテキスト。The request context associated with the object. これにより、アドインのプロセスが Office ホストアプリケーションのプロセスに接続されます。This connects the add-in's process to the Office host application's process.

dataLabels

系列に含まれるすべてのデータ ラベルのコレクションを表します。Represents a collection of all dataLabels in the series.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

doughnutHoleSize

グラフ系列のドーナツの穴の大きさを表します。Represents the doughnut hole size of a chart series. ドーナツ グラフと doughnutExploded グラフでのみ有効です。Only valid on doughnut and doughnutExploded charts. 無効なグラフで無効な引数の例外をスローします。Throws an invalid argument exception on invalid charts.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

explosion

円グラフまたはドーナツ グラフのスライス切り出し表示の値を返すか設定します。Returns or sets the explosion value for a pie-chart or doughnut-chart slice. 切り出し表示は行われず、スライスの先端が円の中心と一致する場合、0 を返します。Returns 0 (zero) if there's no explosion (the tip of the slice is in the center of the pie). 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

filtered

データ系列がフィルター処理されるかどうかを表すブール値。Boolean value representing if the series is filtered or not. 等高線グラフには適用されません。Not applicable for surface charts.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

firstSliceAngle

円グラフまたはドーナツ グラフの最初のスライスの角度 (縦の中心から時計回りでの度数) を返すか設定します。Returns or sets the angle of the first pie-chart or doughnut-chart slice, in degrees (clockwise from vertical). 円グラフ、3-D 円グラフ、およびドーナツ グラフにのみ適用されます。Applies only to pie, 3-D pie, and doughnut charts. 0 から 360 の範囲内で値を指定できます。Can be a value from 0 through 360. 読み取り/書き込みRead/Write

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

format

グラフの系列の書式設定を表します。これには、塗りつぶしと線の書式設定が含まれます。Represents the formatting of a chart series, which includes fill and line formatting. 読み取り専用です。Read-only.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

gapWidth

グラフ系列間に設けられる間隔を表します。Represents the gap width of a chart series. 横棒グラフと縦棒グラフ、および折れ線グラフと円グラフの特定のクラスに対してのみ有効です。Only valid on bar and column charts, as well as specific classes of line and pie charts. 無効なグラフで無効な引数の例外をスローします。Throws an invalid argument exception on invalid charts.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

gradientMaximumColor

領域マップグラフの系列の最大値の色を設定または返します。Returns or sets the color for maximum value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMaximumType

リージョン マップ グラフ系列の最大値の種類を設定または返します。Returns or sets the type for maximum value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMaximumValue

リージョン マップ グラフ系列の最大値を設定または返します。Returns or sets the maximum value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMidpointColor

地域マップのグラフ系列の中間値の色を設定または返します。Returns or sets the color for midpoint value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMidpointType

リージョン マップ グラフ系列の中間値の種類を設定または返します。Returns or sets the type for midpoint value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMidpointValue

リージョン マップ グラフ系列の中間値を設定または返します。Returns or sets the midpoint value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMinimumColor

地域マップのグラフ系列の最小値の色を設定または返します。Returns or sets the color for minimum value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMinimumType

リージョン マップ グラフ系列の最小値の種類を設定または返します。Returns or sets the type for minimum value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMinimumValue

リージョン マップ グラフ系列の最小値を設定または返します。Returns or sets the minimum value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientStyle

リージョン マップ グラフのグラデーション スタイルを設定または返します。Returns or sets series gradient style of a region map chart. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

hasDataLabels

系列のデータ ラベルの有無を表すブール値。Boolean value representing if the series has data labels or not.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

invertColor

系列の負のデータ ポイントに対して塗りつぶしの色を設定または返します。Returns or sets the fill color for negative data points in a series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

invertIfNegative

true の場合、Microsoft Excel により、負の数値に対応する項目でパターンが反転されます。True if Microsoft Excel inverts the pattern in the item when it corresponds to a negative number. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

mapOptions

地域マップグラフのオプションをカプセル化します。Encapsulates the options for a region map chart. 読み取り専用です。Read-only.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

markerBackgroundColor

グラフ系列のマーカー背景色を表します。Represents markers background color of a chart series.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

markerForegroundColor

グラフ系列のマーカー前景色を表します。Represents markers foreground color of a chart series.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

markerSize

グラフ系列のマーカー サイズを表します。Represents marker size of a chart series.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

markerStyle

グラフ系列のマーカー スタイルを表します。Represents marker style of a chart series. 詳細については、「ChartMarkerStyle」を参照してください。See Excel.ChartMarkerStyle for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

name

グラフのデータ系列の名前を表します。Represents the name of a series in a chart.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

overlap

横棒と縦棒の配置方法を指定します。Specifies how bars and columns are positioned. -100 から100までの値を指定できます。Can be a value between –100 and 100. 2-D 横棒グラフと 2-D 縦棒グラフにのみ適用されます。Applies only to 2-D bar and 2-D column charts. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

parentLabelStrategy

ツリーマップグラフの系列の親ラベル戦略領域を設定または返します。Returns or sets the series parent label strategy area for a treemap chart. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

plotOrder

グラフ グループ内でのグラフ系列のプロット順序を表します。Represents the plot order of a chart series within the chart group.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

points

データ系列にあるすべてのポイントのコレクションを返します。Represents a collection of all points in the series. 値の取得のみ可能です。Read-only.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

secondPlotSize

補助円グラフ付き円グラフまたは補助縦棒グラフ付き円グラフのセカンダリ セクションのサイズを、プライマリ セクションのサイズのパーセンテージとして返すか設定します。Returns or sets the size of the secondary section of either a pie of pie chart or a bar of pie chart, as a percentage of the size of the primary pie. 5 から 200 の範囲内で値を指定できます。Can be a value from 5 to 200. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

showConnectorLines

フォールウォーターグラフでコネクタの線を表示するかどうかを指定します。Specifies whether or not connector lines are shown in waterfall charts. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

showLeaderLines

データ系列の各データラベルに対して、引き出し線を表示するかどうかを指定します。Specifies whether or not leader lines are displayed for each data label in the series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

showShadow

系列に影があるかどうかを表すブール型 (Boolean) の値を指定します。Boolean value representing if the series has a shadow or not.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

smooth

系列が平滑化されるかどうかを表すブール値。Boolean value representing if the series is smooth or not. 折れ線グラフおよび散布図にのみ適用されます。Only applicable to line and scatter charts.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

splitType

補助円グラフ付き円グラフまたは補助縦棒グラフ付き円グラフを 2 つの部分に分割する方法を返すか設定します。Returns or sets the way the two sections of either a pie of pie chart or a bar of pie chart are split. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

splitValue

円グラフまたは補助縦棒グラフ付き円グラフの2つのセクションを区切るしきい値を取得または設定します。Returns or sets the threshold value that separates two sections of either a pie-of-pie chart or a bar-of-pie chart. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

trendlines

データ系列に含まれる近似曲線のコレクションを表します。Represents a collection of trendlines in the series. 読み取り専用です。Read-only.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

varyByCategories

true の場合、Microsoft Excel により、データ マーカーごとに異なる色またはパターンが割り当てられます。True if Microsoft Excel assigns a different color or pattern to each data marker. グラフに含まれるデータ系列は 1 つだけでなければなりません。The chart must contain only one series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

xErrorBars

グラフ系列の誤差バーオブジェクトを表します。Represents the error bar object of a chart series.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

yErrorBars

グラフ系列の誤差バーオブジェクトを表します。Represents the error bar object of a chart series.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

メソッド

delete()

グラフ系列を削除します。Deletes the chart series.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

load(option)

オブジェクトの指定のプロパティを読み込むコマンドを待ち行列に入れます。Queues up a command to load the specified properties of the object. プロパティを読み取るには先に "context.sync()" を呼び出す必要があります。You must call "context.sync()" before reading the properties.

load(propertyNames)

オブジェクトの指定のプロパティを読み込むコマンドを待ち行列に入れます。Queues up a command to load the specified properties of the object. プロパティを読み取るcontext.sync()前に、を呼び出す必要があります。You must call context.sync() before reading the properties.

load(propertyNamesAndPaths)

オブジェクトの指定のプロパティを読み込むコマンドを待ち行列に入れます。Queues up a command to load the specified properties of the object. プロパティを読み取るcontext.sync()前に、を呼び出す必要があります。You must call context.sync() before reading the properties.

set(properties, options)

一度に1つのオブジェクトの複数のプロパティを設定します。Sets multiple properties of an object at the same time. 適切なプロパティを持つプレーンオブジェクト、または同じ種類の別の API オブジェクトのいずれかを渡すことができます。You can pass either a plain object with the appropriate properties, or another API object of the same type.

set(properties)

既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを設定します。Sets multiple properties on the object at the same time, based on an existing loaded object.

setBubbleSizes(sourceData)

グラフ系列のバブル サイズを設定します。Set bubble sizes for a chart series. バブル チャートにのみ適用されます。Only works for bubble charts.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

setValues(sourceData)

グラフ系列の値を設定します。Set values for a chart series. 散布図の場合、Y 軸の値を意味します。For scatter chart, it means Y axis values.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

setXAxisValues(sourceData)

グラフ系列の X 軸の値を設定します。Set values of X axis for a chart series. 散布図にのみ適用されます。Only works for scatter charts.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

toJSON()

API オブジェクトがtoJSON()渡されるときに、より有用な出力を提供するために、JavaScript メソッドをオーバーライドします。JSON.stringify()Overrides the JavaScript toJSON() method in order to provide more useful output when an API object is passed to JSON.stringify(). (JSON.stringifyその後、渡されたtoJSONオブジェクトのメソッドを呼び出します。元の Excel ChartSeries オブジェクトは API オブジェクトであるのに対しtoJSONて、メソッドはプレーンな JavaScript オブジェクト (として入力されます) を返します。Excel.Interfaces.ChartSeriesData, in turn, calls the toJSON method of the object that is passed to it.) Whereas the original Excel.ChartSeries object is an API object, the toJSON method returns a plain JavaScript object (typed as Excel.Interfaces.ChartSeriesData) は、元のオブジェクトから読み込まれた子プロパティの浅いコピーを格納します。) that contains shallow copies of any loaded child properties from the original object.

プロパティの詳細

axisGroup

指定した系列のグループを取得または設定します。Returns or sets the group for the specified series. 読み取り/書き込みRead/Write

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

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

プロパティ値

Excel.ChartAxisGroup | "Primary" | "Secondary"

binOptions

ヒストグラムグラフおよびパレート図の bin オプションをカプセル化します。Encapsulates the bin options for histogram charts and pareto charts. 読み取り専用です。Read-only.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

readonly binOptions: Excel.ChartBinOptions;

プロパティ値

boxwhiskerOptions

箱ひげ図のオプションをカプセル化します。Encapsulates the options for the box and whisker charts. 読み取り専用です。Read-only.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

readonly boxwhiskerOptions: Excel.ChartBoxwhiskerOptions;

プロパティ値

bubbleScale

これは、既定のサイズの割合を表す 0 (ゼロ) から300までの整数値にすることができます。This can be an integer value from 0 (zero) to 300, representing the percentage of the default size. このプロパティは、バブルチャートにのみ適用されます。This property only applies to bubble charts. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

bubbleScale: number;

プロパティ値

number

chartType

グラフ系列の種類を表します。Represents the chart type of a series. 詳細については、「ChartType」を参照してください。See Excel.ChartType for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

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";

プロパティ値

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"

context

オブジェクトに関連付けられている要求コンテキスト。The request context associated with the object. これにより、アドインのプロセスが Office ホストアプリケーションのプロセスに接続されます。This connects the add-in's process to the Office host application's process.

context: RequestContext;

プロパティ値

RequestContext

dataLabels

系列に含まれるすべてのデータ ラベルのコレクションを表します。Represents a collection of all dataLabels in the series.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

readonly dataLabels: Excel.ChartDataLabels;

プロパティ値

doughnutHoleSize

グラフ系列のドーナツの穴の大きさを表します。Represents the doughnut hole size of a chart series. ドーナツ グラフと doughnutExploded グラフでのみ有効です。Only valid on doughnut and doughnutExploded charts. 無効なグラフで無効な引数の例外をスローします。Throws an invalid argument exception on invalid charts.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

doughnutHoleSize: number;

プロパティ値

number

explosion

円グラフまたはドーナツ グラフのスライス切り出し表示の値を返すか設定します。Returns or sets the explosion value for a pie-chart or doughnut-chart slice. 切り出し表示は行われず、スライスの先端が円の中心と一致する場合、0 を返します。Returns 0 (zero) if there's no explosion (the tip of the slice is in the center of the pie). 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

explosion: number;

プロパティ値

number

filtered

データ系列がフィルター処理されるかどうかを表すブール値。Boolean value representing if the series is filtered or not. 等高線グラフには適用されません。Not applicable for surface charts.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

filtered: boolean;

プロパティ値

boolean

firstSliceAngle

円グラフまたはドーナツ グラフの最初のスライスの角度 (縦の中心から時計回りでの度数) を返すか設定します。Returns or sets the angle of the first pie-chart or doughnut-chart slice, in degrees (clockwise from vertical). 円グラフ、3-D 円グラフ、およびドーナツ グラフにのみ適用されます。Applies only to pie, 3-D pie, and doughnut charts. 0 から 360 の範囲内で値を指定できます。Can be a value from 0 through 360. 読み取り/書き込みRead/Write

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

firstSliceAngle: number;

プロパティ値

number

format

グラフの系列の書式設定を表します。これには、塗りつぶしと線の書式設定が含まれます。Represents the formatting of a chart series, which includes fill and line formatting. 読み取り専用です。Read-only.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

readonly format: Excel.ChartSeriesFormat;

プロパティ値

gapWidth

グラフ系列間に設けられる間隔を表します。Represents the gap width of a chart series. 横棒グラフと縦棒グラフ、および折れ線グラフと円グラフの特定のクラスに対してのみ有効です。Only valid on bar and column charts, as well as specific classes of line and pie charts. 無効なグラフで無効な引数の例外をスローします。Throws an invalid argument exception on invalid charts.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

gapWidth: number;

プロパティ値

number

gradientMaximumColor

領域マップグラフの系列の最大値の色を設定または返します。Returns or sets the color for maximum value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMaximumColor: string;

プロパティ値

string

gradientMaximumType

リージョン マップ グラフ系列の最大値の種類を設定または返します。Returns or sets the type for maximum value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

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

プロパティ値

Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent"

gradientMaximumValue

リージョン マップ グラフ系列の最大値を設定または返します。Returns or sets the maximum value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMaximumValue: number;

プロパティ値

number

gradientMidpointColor

地域マップのグラフ系列の中間値の色を設定または返します。Returns or sets the color for midpoint value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMidpointColor: string;

プロパティ値

string

gradientMidpointType

リージョン マップ グラフ系列の中間値の種類を設定または返します。Returns or sets the type for midpoint value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

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

プロパティ値

Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent"

gradientMidpointValue

リージョン マップ グラフ系列の中間値を設定または返します。Returns or sets the midpoint value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMidpointValue: number;

プロパティ値

number

gradientMinimumColor

地域マップのグラフ系列の最小値の色を設定または返します。Returns or sets the color for minimum value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMinimumColor: string;

プロパティ値

string

gradientMinimumType

リージョン マップ グラフ系列の最小値の種類を設定または返します。Returns or sets the type for minimum value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

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

プロパティ値

Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent"

gradientMinimumValue

リージョン マップ グラフ系列の最小値を設定または返します。Returns or sets the minimum value of a region map chart series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

gradientMinimumValue: number;

プロパティ値

number

gradientStyle

リージョン マップ グラフのグラデーション スタイルを設定または返します。Returns or sets series gradient style of a region map chart. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

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

プロパティ値

Excel.ChartGradientStyle | "TwoPhaseColor" | "ThreePhaseColor"

hasDataLabels

系列のデータ ラベルの有無を表すブール値。Boolean value representing if the series has data labels or not.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

hasDataLabels: boolean;

プロパティ値

boolean

invertColor

系列の負のデータ ポイントに対して塗りつぶしの色を設定または返します。Returns or sets the fill color for negative data points in a series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

invertColor: string;

プロパティ値

string

invertIfNegative

true の場合、Microsoft Excel により、負の数値に対応する項目でパターンが反転されます。True if Microsoft Excel inverts the pattern in the item when it corresponds to a negative number. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

invertIfNegative: boolean;

プロパティ値

boolean

mapOptions

地域マップグラフのオプションをカプセル化します。Encapsulates the options for a region map chart. 読み取り専用です。Read-only.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

readonly mapOptions: Excel.ChartMapOptions;

プロパティ値

markerBackgroundColor

グラフ系列のマーカー背景色を表します。Represents markers background color of a chart series.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

markerBackgroundColor: string;

プロパティ値

string

Examples

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let salesTable = sheet.tables.getItem("SalesTable");
    let dataRange = sheet.getRange("A1:E7");

    // Create an XY scatter chart.
    let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
    chart.title.text = "Bicycle Parts Quarterly Sales"; 
  
    let series = chart.series;
    let series0 = series.getItemAt(0);
    let series1 = series.getItemAt(1);
    let series2 = series.getItemAt(2);
    let series3 = series.getItemAt(3);

    // Set markers.
    series0.markerStyle = "Dash";
    series0.markerForegroundColor = "black";
    series1.markerStyle = "Star";
    series1.markerForegroundColor = "black";
    series2.markerStyle = "X";
    series2.markerSize = 12;
    series3.markerStyle = "Triangle";
    series3.markerBackgroundColor = "purple";

    await context.sync();
});

markerForegroundColor

グラフ系列のマーカー前景色を表します。Represents markers foreground color of a chart series.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

markerForegroundColor: string;

プロパティ値

string

Examples

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let salesTable = sheet.tables.getItem("SalesTable");
    let dataRange = sheet.getRange("A1:E7");

    // Create an XY scatter chart.
    let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
    chart.title.text = "Bicycle Parts Quarterly Sales"; 
  
    let series = chart.series;
    let series0 = series.getItemAt(0);
    let series1 = series.getItemAt(1);
    let series2 = series.getItemAt(2);
    let series3 = series.getItemAt(3);

    // Set markers.
    series0.markerStyle = "Dash";
    series0.markerForegroundColor = "black";
    series1.markerStyle = "Star";
    series1.markerForegroundColor = "black";
    series2.markerStyle = "X";
    series2.markerSize = 12;
    series3.markerStyle = "Triangle";
    series3.markerBackgroundColor = "purple";

    await context.sync();
});

markerSize

グラフ系列のマーカー サイズを表します。Represents marker size of a chart series.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

markerSize: number;

プロパティ値

number

Examples

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let salesTable = sheet.tables.getItem("SalesTable");
    let dataRange = sheet.getRange("A1:E7");

    // Create an XY scatter chart.
    let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
    chart.title.text = "Bicycle Parts Quarterly Sales"; 
  
    let series = chart.series;
    let series0 = series.getItemAt(0);
    let series1 = series.getItemAt(1);
    let series2 = series.getItemAt(2);
    let series3 = series.getItemAt(3);

    // Set markers.
    series0.markerStyle = "Dash";
    series0.markerForegroundColor = "black";
    series1.markerStyle = "Star";
    series1.markerForegroundColor = "black";
    series2.markerStyle = "X";
    series2.markerSize = 12;
    series3.markerStyle = "Triangle";
    series3.markerBackgroundColor = "purple";

    await context.sync();
});

markerStyle

グラフ系列のマーカー スタイルを表します。Represents marker style of a chart series. 詳細については、「ChartMarkerStyle」を参照してください。See Excel.ChartMarkerStyle for details.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

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

プロパティ値

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

Examples

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let salesTable = sheet.tables.getItem("SalesTable");
    let dataRange = sheet.getRange("A1:E7");

    // Create an XY scatter chart.
    let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
    chart.title.text = "Bicycle Parts Quarterly Sales"; 
  
    let series = chart.series;
    let series0 = series.getItemAt(0);
    let series1 = series.getItemAt(1);
    let series2 = series.getItemAt(2);
    let series3 = series.getItemAt(3);

    // Set markers.
    series0.markerStyle = "Dash";
    series0.markerForegroundColor = "black";
    series1.markerStyle = "Star";
    series1.markerForegroundColor = "black";
    series2.markerStyle = "X";
    series2.markerSize = 12;
    series3.markerStyle = "Triangle";
    series3.markerBackgroundColor = "purple";

    await context.sync();
});

name

グラフのデータ系列の名前を表します。Represents the name of a series in a chart.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

name: string;

プロパティ値

string

overlap

横棒と縦棒の配置方法を指定します。Specifies how bars and columns are positioned. -100 から100までの値を指定できます。Can be a value between –100 and 100. 2-D 横棒グラフと 2-D 縦棒グラフにのみ適用されます。Applies only to 2-D bar and 2-D column charts. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

overlap: number;

プロパティ値

number

parentLabelStrategy

ツリーマップグラフの系列の親ラベル戦略領域を設定または返します。Returns or sets the series parent label strategy area for a treemap chart. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

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

プロパティ値

Excel.ChartParentLabelStrategy | "None" | "Banner" | "Overlapping"

plotOrder

グラフ グループ内でのグラフ系列のプロット順序を表します。Represents the plot order of a chart series within the chart group.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

plotOrder: number;

プロパティ値

number

points

データ系列にあるすべてのポイントのコレクションを返します。Represents a collection of all points in the series. 値の取得のみ可能です。Read-only.

[API セット: excelapi 1.1][ API set: ExcelApi 1.1 ]

readonly points: Excel.ChartPointsCollection;

プロパティ値

secondPlotSize

補助円グラフ付き円グラフまたは補助縦棒グラフ付き円グラフのセカンダリ セクションのサイズを、プライマリ セクションのサイズのパーセンテージとして返すか設定します。Returns or sets the size of the secondary section of either a pie of pie chart or a bar of pie chart, as a percentage of the size of the primary pie. 5 から 200 の範囲内で値を指定できます。Can be a value from 5 to 200. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

secondPlotSize: number;

プロパティ値

number

showConnectorLines

フォールウォーターグラフでコネクタの線を表示するかどうかを指定します。Specifies whether or not connector lines are shown in waterfall charts. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

showConnectorLines: boolean;

プロパティ値

boolean

showLeaderLines

データ系列の各データラベルに対して、引き出し線を表示するかどうかを指定します。Specifies whether or not leader lines are displayed for each data label in the series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

showLeaderLines: boolean;

プロパティ値

boolean

showShadow

系列に影があるかどうかを表すブール型 (Boolean) の値を指定します。Boolean value representing if the series has a shadow or not.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

showShadow: boolean;

プロパティ値

boolean

smooth

系列が平滑化されるかどうかを表すブール値。Boolean value representing if the series is smooth or not. 折れ線グラフおよび散布図にのみ適用されます。Only applicable to line and scatter charts.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

smooth: boolean;

プロパティ値

boolean

splitType

補助円グラフ付き円グラフまたは補助縦棒グラフ付き円グラフを 2 つの部分に分割する方法を返すか設定します。Returns or sets the way the two sections of either a pie of pie chart or a bar of pie chart are split. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

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

プロパティ値

Excel.ChartSplitType | "SplitByPosition" | "SplitByValue" | "SplitByPercentValue" | "SplitByCustomSplit"

splitValue

円グラフまたは補助縦棒グラフ付き円グラフの2つのセクションを区切るしきい値を取得または設定します。Returns or sets the threshold value that separates two sections of either a pie-of-pie chart or a bar-of-pie chart. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

splitValue: number;

プロパティ値

number

trendlines

データ系列に含まれる近似曲線のコレクションを表します。Represents a collection of trendlines in the series. 読み取り専用です。Read-only.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

readonly trendlines: Excel.ChartTrendlineCollection;

プロパティ値

varyByCategories

true の場合、Microsoft Excel により、データ マーカーごとに異なる色またはパターンが割り当てられます。True if Microsoft Excel assigns a different color or pattern to each data marker. グラフに含まれるデータ系列は 1 つだけでなければなりません。The chart must contain only one series. 読み取り/書き込み可能。Read/Write.

[API セット: excelapi 1.8][ API set: ExcelApi 1.8 ]

varyByCategories: boolean;

プロパティ値

boolean

xErrorBars

グラフ系列の誤差バーオブジェクトを表します。Represents the error bar object of a chart series.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

readonly xErrorBars: Excel.ChartErrorBars;

プロパティ値

yErrorBars

グラフ系列の誤差バーオブジェクトを表します。Represents the error bar object of a chart series.

[API セット: excelapi 1.9][ API set: ExcelApi 1.9 ]

readonly yErrorBars: Excel.ChartErrorBars;

プロパティ値

メソッドの詳細

delete()

グラフ系列を削除します。Deletes the chart series.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

delete(): void;

戻り値

void

Examples

await Excel.run(async (context) => {
  const sheet = context.workbook.worksheets.getItem("Sample");
  const seriesCollection = sheet.charts.getItemAt(0).series;
  seriesCollection.load("count");
  await context.sync();

  if (seriesCollection.count > 0) {
    const series = seriesCollection.getItemAt(0);

    // Delete the first series.
    series.delete();
  }

  await context.sync();
});

load(option)

オブジェクトの指定のプロパティを読み込むコマンドを待ち行列に入れます。Queues up a command to load the specified properties of the object. プロパティを読み取るには先に "context.sync()" を呼び出す必要があります。You must call "context.sync()" before reading the properties.

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

パラメーター

戻り値

注釈

このシグネチャに加えて、このメソッドのシグネチャは次のとおりです。In addition to this signature, this method has the following signatures:

load(option?: string | string[]): Excel.ChartSeries-Where オプションは、読み込むプロパティを指定する、コンマで区切られた文字列または文字列の配列です。load(option?: string | string[]): Excel.ChartSeries - Where option is a comma-delimited string or an array of strings that specify the properties to load.

load(option?: { select?: string; expand?: string; }): Excel.ChartSeries-Where オプションを指定します。 select は、読み込むプロパティを指定するコンマで区切られた文字列で、オプション expand は読み込むナビゲーションプロパティを指定するコンマ区切りの文字列です。load(option?: { select?: string; expand?: string; }): Excel.ChartSeries - Where option.select is a comma-delimited string that specifies the properties to load, and options.expand is a comma-delimited string that specifies the navigation properties to load.

load(option?: { select?: string; expand?: string; top?: number; skip?: number }): Excel.ChartSeries-コレクション型でのみ使用できます。load(option?: { select?: string; expand?: string; top?: number; skip?: number }): Excel.ChartSeries - Only available on collection types. これは、前述の署名に似ています。It is similar to the preceding signature. Top は、結果に含めることができるコレクション項目の最大数を指定します。Option.top specifies the maximum number of collection items that can be included in the result. 省略すると、スキップされ、結果に含まれないアイテムの数を指定します。Option.skip specifies the number of items that are to be skipped and not included in the result. Option を指定すると、指定した数のアイテムをスキップした後に結果セットが開始されます。If option.top is specified, the result set will start after skipping the specified number of items.

load(propertyNames)

オブジェクトの指定のプロパティを読み込むコマンドを待ち行列に入れます。Queues up a command to load the specified properties of the object. プロパティを読み取るcontext.sync()前に、を呼び出す必要があります。You must call context.sync() before reading the properties.

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

パラメーター

propertyNames
string | string[]

読み込むプロパティを指定する、コンマで区切られた文字列または文字列の配列。A comma-delimited string or an array of strings that specify the properties to load.

戻り値

Examples

// Rename the 1st series of Chart1 to "New Series Name"
Excel.run(function (ctx) { 
    var chart = ctx.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");    
    chart.series.getItemAt(0).name = "New Series Name";
    return ctx.sync().then(function() {
            console.log("Series1 Renamed");
    });
}).catch(function(error) {
    console.log("Error: " + error);
    if (error instanceof OfficeExtension.Error) {
        console.log("Debug info: " + JSON.stringify(error.debugInfo));
    }
});

load(propertyNamesAndPaths)

オブジェクトの指定のプロパティを読み込むコマンドを待ち行列に入れます。Queues up a command to load the specified properties of the object. プロパティを読み取るcontext.sync()前に、を呼び出す必要があります。You must call context.sync() before reading the properties.

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

パラメーター

propertyNamesAndPaths
{ select?: string; expand?: string; }

ここで、は、読み込むプロパティを指定するコンマで区切られた文字列を指定します。 expand は、読み込むナビゲーションプロパティを指定するコンマ区切りの文字列です。Where propertyNamesAndPaths.select is a comma-delimited string that specifies the properties to load, and propertyNamesAndPaths.expand is a comma-delimited string that specifies the navigation properties to load.

戻り値

set(properties, options)

一度に1つのオブジェクトの複数のプロパティを設定します。Sets multiple properties of an object at the same time. 適切なプロパティを持つプレーンオブジェクト、または同じ種類の別の API オブジェクトのいずれかを渡すことができます。You can pass either a plain object with the appropriate properties, or another API object of the same type.

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

パラメーター

properties
Interfaces.ChartSeriesUpdateData

メソッドが呼び出されるオブジェクトのプロパティに構造化 isomorphically されているプロパティを持つ JavaScript オブジェクト。A JavaScript object with properties that are structured isomorphically to the properties of the object on which the method is called.

options
OfficeExtension.UpdateOptions

プロパティオブジェクトが読み取り専用プロパティを設定しようとした場合にエラーを抑制するオプションを提供します。Provides an option to suppress errors if the properties object tries to set any read-only properties.

戻り値

void

注釈

このメソッドには、次の追加のシグネチャがあります。This method has the following additional signature:

set(properties: Excel.ChartSeries): void

set(properties)

既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを設定します。Sets multiple properties on the object at the same time, based on an existing loaded object.

set(properties: Excel.ChartSeries): void;

パラメーター

properties
Excel.ChartSeries

戻り値

void

setBubbleSizes(sourceData)

グラフ系列のバブル サイズを設定します。Set bubble sizes for a chart series. バブル チャートにのみ適用されます。Only works for bubble charts.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

setBubbleSizes(sourceData: Range): void;

パラメーター

sourceData
Range

データ ソースに対応する Range オブジェクトです。The Range object corresponding to the source data.

戻り値

void

setValues(sourceData)

グラフ系列の値を設定します。Set values for a chart series. 散布図の場合、Y 軸の値を意味します。For scatter chart, it means Y axis values.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

setValues(sourceData: Range): void;

パラメーター

sourceData
Range

データ ソースに対応する Range オブジェクトです。The Range object corresponding to the source data.

戻り値

void

Examples

await Excel.run(async (context) => {
  const sheet = context.workbook.worksheets.getItem("Sample");

  let seriesCollection = sheet.charts.getItemAt(0);
  let rangeSelection = sheet.getRange("C2:C7");
  let xRangeSelection = sheet.getRange("A1:A7");

  // Add a series.
  let newSeries = seriesCollection.series.add("Qtr2");
  newSeries.setValues(rangeSelection);
  newSeries.setXAxisValues(xRangeSelection);

  await context.sync();
});

setXAxisValues(sourceData)

グラフ系列の X 軸の値を設定します。Set values of X axis for a chart series. 散布図にのみ適用されます。Only works for scatter charts.

[API セット: excelapi 1.7][ API set: ExcelApi 1.7 ]

setXAxisValues(sourceData: Range): void;

パラメーター

sourceData
Range

データ ソースに対応する Range オブジェクトです。The Range object corresponding to the source data.

戻り値

void

toJSON()

API オブジェクトがtoJSON()渡されるときに、より有用な出力を提供するために、JavaScript メソッドをオーバーライドします。JSON.stringify()Overrides the JavaScript toJSON() method in order to provide more useful output when an API object is passed to JSON.stringify(). (JSON.stringifyその後、渡されたtoJSONオブジェクトのメソッドを呼び出します。元の Excel ChartSeries オブジェクトは API オブジェクトであるのに対しtoJSONて、メソッドはプレーンな JavaScript オブジェクト (として入力されます) を返します。Excel.Interfaces.ChartSeriesData, in turn, calls the toJSON method of the object that is passed to it.) Whereas the original Excel.ChartSeries object is an API object, the toJSON method returns a plain JavaScript object (typed as Excel.Interfaces.ChartSeriesData) は、元のオブジェクトから読み込まれた子プロパティの浅いコピーを格納します。) that contains shallow copies of any loaded child properties from the original object.

toJSON(): Excel.Interfaces.ChartSeriesData;

戻り値