Excel.Interfaces.ChartSeriesLoadOptions interface
Represents a series in a chart.
Remarks
Properties
| $all | Specifying |
| axis |
Specifies the group for the specified series. |
| bin |
Encapsulates the bin options for histogram charts and pareto charts. |
| boxwhisker |
Encapsulates the options for the box and whisker charts. |
| bubble |
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. |
| chart |
Represents the chart type of a series. See |
| data |
Represents a collection of all data labels in the series. |
| doughnut |
Represents the doughnut hole size of a chart series. Only valid on doughnut and doughnut exploded charts. Throws an |
| explosion | Specifies the explosion value for a pie-chart or doughnut-chart slice. Returns 0 (zero) if there's no explosion (the tip of the slice is in the center of the pie). |
| filtered | Specifies if the series is filtered. Not applicable for surface charts. |
| first |
Specifies the angle of the first pie-chart or doughnut-chart slice, in degrees (clockwise from vertical). Applies only to pie, 3-D pie, and doughnut charts. Can be a value from 0 through 360. |
| format | Represents the formatting of a chart series, which includes fill and line formatting. |
| gap |
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. |
| gradient |
Specifies the color for maximum value of a region map chart series. |
| gradient |
Specifies the type for maximum value of a region map chart series. |
| gradient |
Specifies the maximum value of a region map chart series. |
| gradient |
Specifies the color for the midpoint value of a region map chart series. |
| gradient |
Specifies the type for the midpoint value of a region map chart series. |
| gradient |
Specifies the midpoint value of a region map chart series. |
| gradient |
Specifies the color for the minimum value of a region map chart series. |
| gradient |
Specifies the type for the minimum value of a region map chart series. |
| gradient |
Specifies the minimum value of a region map chart series. |
| gradient |
Specifies the series gradient style of a region map chart. |
| has |
Specifies if the series has data labels. |
| invert |
Specifies the fill color for negative data points in a series. |
| invert |
True if Excel inverts the pattern in the item when it corresponds to a negative number. |
| map |
Encapsulates the options for a region map chart. |
| marker |
Specifies the marker background color of a chart series. |
| marker |
Specifies the marker foreground color of a chart series. |
| marker |
Specifies the marker size of a chart series. The supported size range is 2 to 72. This method returns an InvalidArgument error if it's set with a size outside of the supported range. |
| marker |
Specifies the marker style of a chart series. See |
| name | Specifies the name of a series in a chart. The name's length should not be greater than 255 characters. |
| overlap | Specifies how bars and columns are positioned. Can be a value between -100 and 100. Applies only to 2-D bar and 2-D column charts. |
| parent |
Specifies the series parent label strategy area for a treemap chart. |
| plot |
Specifies the plot order of a chart series within the chart group. |
| points | Returns a collection of all points in the series. |
| second |
Specifies 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. Can be a value from 5 to 200. |
| show |
Specifies whether connector lines are shown in waterfall charts. |
| show |
Specifies whether leader lines are displayed for each data label in the series. |
| show |
Specifies if the series has a shadow. |
| smooth | Specifies if the series is smooth. Only applicable to line and scatter charts. |
| split |
Specifies the way the two sections of either a pie-of-pie chart or a bar-of-pie chart are split. |
| split |
Specifies the threshold value that separates two sections of either a pie-of-pie chart or a bar-of-pie chart. |
| vary |
True if Excel assigns a different color or pattern to each data marker. The chart must contain only one series. |
| x |
Represents the error bar object of a chart series. |
| y |
Represents the error bar object of a chart series. |
Property Details
$all
Specifying $all for the LoadOptions loads all the scalar properties (e.g.: Range.address) but not the navigational properties (e.g.: Range.format.fill.color).
$all?: boolean;Property Value
boolean
axisGroup
Specifies the group for the specified series.
axisGroup?: boolean;Property Value
boolean
Remarks
binOptions
Encapsulates the bin options for histogram charts and pareto charts.
binOptions?: Excel.Interfaces.ChartBinOptionsLoadOptions;Property Value
Remarks
boxwhiskerOptions
Encapsulates the options for the box and whisker charts.
boxwhiskerOptions?: Excel.Interfaces.ChartBoxwhiskerOptionsLoadOptions;Property Value
Remarks
bubbleScale
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.
bubbleScale?: boolean;Property Value
boolean
Remarks
chartType
Represents the chart type of a series. See Excel.ChartType for details.
chartType?: boolean;Property Value
boolean
Remarks
dataLabels
Represents a collection of all data labels in the series.
dataLabels?: Excel.Interfaces.ChartDataLabelsLoadOptions;Property Value
Remarks
doughnutHoleSize
Represents the doughnut hole size of a chart series. Only valid on doughnut and doughnut exploded charts. Throws an InvalidArgument error on invalid charts.
doughnutHoleSize?: boolean;Property Value
boolean
Remarks
explosion
Specifies the explosion value for a pie-chart or doughnut-chart slice. Returns 0 (zero) if there's no explosion (the tip of the slice is in the center of the pie).
explosion?: boolean;Property Value
boolean
Remarks
filtered
Specifies if the series is filtered. Not applicable for surface charts.
filtered?: boolean;Property Value
boolean
Remarks
firstSliceAngle
Specifies the angle of the first pie-chart or doughnut-chart slice, in degrees (clockwise from vertical). Applies only to pie, 3-D pie, and doughnut charts. Can be a value from 0 through 360.
firstSliceAngle?: boolean;Property Value
boolean
Remarks
format
Represents the formatting of a chart series, which includes fill and line formatting.
format?: Excel.Interfaces.ChartSeriesFormatLoadOptions;Property Value
Remarks
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.
gapWidth?: boolean;Property Value
boolean
Remarks
gradientMaximumColor
Specifies the color for maximum value of a region map chart series.
gradientMaximumColor?: boolean;Property Value
boolean
Remarks
gradientMaximumType
Specifies the type for maximum value of a region map chart series.
gradientMaximumType?: boolean;Property Value
boolean
Remarks
gradientMaximumValue
Specifies the maximum value of a region map chart series.
gradientMaximumValue?: boolean;Property Value
boolean
Remarks
gradientMidpointColor
Specifies the color for the midpoint value of a region map chart series.
gradientMidpointColor?: boolean;Property Value
boolean
Remarks
gradientMidpointType
Specifies the type for the midpoint value of a region map chart series.
gradientMidpointType?: boolean;Property Value
boolean
Remarks
gradientMidpointValue
Specifies the midpoint value of a region map chart series.
gradientMidpointValue?: boolean;Property Value
boolean
Remarks
gradientMinimumColor
Specifies the color for the minimum value of a region map chart series.
gradientMinimumColor?: boolean;Property Value
boolean
Remarks
gradientMinimumType
Specifies the type for the minimum value of a region map chart series.
gradientMinimumType?: boolean;Property Value
boolean
Remarks
gradientMinimumValue
Specifies the minimum value of a region map chart series.
gradientMinimumValue?: boolean;Property Value
boolean
Remarks
gradientStyle
Specifies the series gradient style of a region map chart.
gradientStyle?: boolean;Property Value
boolean
Remarks
hasDataLabels
Specifies if the series has data labels.
hasDataLabels?: boolean;Property Value
boolean
Remarks
invertColor
Specifies the fill color for negative data points in a series.
invertColor?: boolean;Property Value
boolean
Remarks
invertIfNegative
True if Excel inverts the pattern in the item when it corresponds to a negative number.
invertIfNegative?: boolean;Property Value
boolean
Remarks
mapOptions
Encapsulates the options for a region map chart.
mapOptions?: Excel.Interfaces.ChartMapOptionsLoadOptions;Property Value
Remarks
markerBackgroundColor
Specifies the marker background color of a chart series.
markerBackgroundColor?: boolean;Property Value
boolean
Remarks
markerForegroundColor
Specifies the marker foreground color of a chart series.
markerForegroundColor?: boolean;Property Value
boolean
Remarks
markerSize
Specifies the marker size of a chart series. The supported size range is 2 to 72. This method returns an InvalidArgument error if it's set with a size outside of the supported range.
markerSize?: boolean;Property Value
boolean
Remarks
markerStyle
Specifies the marker style of a chart series. See Excel.ChartMarkerStyle for details.
markerStyle?: boolean;Property Value
boolean
Remarks
name
Specifies the name of a series in a chart. The name's length should not be greater than 255 characters.
name?: boolean;Property Value
boolean
Remarks
overlap
Specifies how bars and columns are positioned. Can be a value between -100 and 100. Applies only to 2-D bar and 2-D column charts.
overlap?: boolean;Property Value
boolean
Remarks
parentLabelStrategy
Specifies the series parent label strategy area for a treemap chart.
parentLabelStrategy?: boolean;Property Value
boolean
Remarks
plotOrder
Specifies the plot order of a chart series within the chart group.
plotOrder?: boolean;Property Value
boolean
Remarks
points
Returns a collection of all points in the series.
points?: Excel.Interfaces.ChartPointsCollectionLoadOptions;Property Value
Remarks
secondPlotSize
Specifies 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. Can be a value from 5 to 200.
secondPlotSize?: boolean;Property Value
boolean
Remarks
showConnectorLines
Specifies whether connector lines are shown in waterfall charts.
showConnectorLines?: boolean;Property Value
boolean
Remarks
showLeaderLines
Specifies whether leader lines are displayed for each data label in the series.
showLeaderLines?: boolean;Property Value
boolean
Remarks
showShadow
Specifies if the series has a shadow.
showShadow?: boolean;Property Value
boolean
Remarks
smooth
Specifies if the series is smooth. Only applicable to line and scatter charts.
smooth?: boolean;Property Value
boolean
Remarks
splitType
Specifies the way the two sections of either a pie-of-pie chart or a bar-of-pie chart are split.
splitType?: boolean;Property Value
boolean
Remarks
splitValue
Specifies the threshold value that separates two sections of either a pie-of-pie chart or a bar-of-pie chart.
splitValue?: boolean;Property Value
boolean
Remarks
varyByCategories
True if Excel assigns a different color or pattern to each data marker. The chart must contain only one series.
varyByCategories?: boolean;Property Value
boolean
Remarks
xErrorBars
Represents the error bar object of a chart series.
xErrorBars?: Excel.Interfaces.ChartErrorBarsLoadOptions;Property Value
Remarks
yErrorBars
Represents the error bar object of a chart series.
yErrorBars?: Excel.Interfaces.ChartErrorBarsLoadOptions;Property Value
Remarks
Office Add-ins
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for