API Reference
OfficeChartSeries
Dependency-free chart series values used by shared OfficeIMO visual renderers.
Inheritance
- Object
- OfficeChartSeries
Usage
This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.
Returned or exposed by
Accepted by parameters
- Constructor OfficeChartData.OfficeChartData
Constructors
public OfficeChartSeries(String name, IEnumerable<Double> values) #Initializes a chart series snapshot.
Parameters
- name System.String
- Display name for the series.
- values System.Collections.Generic.IEnumerable{System.Double}
- Values aligned with the chart categories.
public OfficeChartSeries(String name, IEnumerable<Double> values, IEnumerable<Double> xValues) #Initializes a chart series snapshot with optional numeric X-axis values for scatter charts.
Parameters
- name System.String
- Display name for the series.
- values System.Collections.Generic.IEnumerable{System.Double}
- Values aligned with the chart categories or X-axis values.
- xValues System.Collections.Generic.IEnumerable{System.Double}
- Optional numeric X-axis values for this series.
public OfficeChartSeries(String name, IEnumerable<Double> values, IEnumerable<Double> xValues, Nullable<OfficeColor> color) #Initializes a chart series snapshot with optional numeric X-axis values and source style metadata.
Parameters
- name System.String
- Display name for the series.
- values System.Collections.Generic.IEnumerable{System.Double}
- Values aligned with the chart categories or X-axis values.
- xValues System.Collections.Generic.IEnumerable{System.Double}
- Optional numeric X-axis values for this series.
- color System.Nullable{OfficeIMO.Drawing.OfficeColor}
- Optional source-defined series color.
public OfficeChartSeries(String name, IEnumerable<Double> values, IEnumerable<Double> xValues, Nullable<OfficeColor> color, IEnumerable<Nullable<OfficeColor>> pointColors) #Initializes a chart series snapshot with optional source style metadata.
Parameters
- name System.String
- Display name for the series.
- values System.Collections.Generic.IEnumerable{System.Double}
- Values aligned with the chart categories or X-axis values.
- xValues System.Collections.Generic.IEnumerable{System.Double}
- Optional numeric X-axis values for this series.
- color System.Nullable{OfficeIMO.Drawing.OfficeColor}
- Optional source-defined series color.
- pointColors System.Collections.Generic.IEnumerable{System.Nullable{OfficeIMO.Drawing.OfficeColor}}
- Optional source-defined colors aligned with individual values.
public OfficeChartSeries(String name, IEnumerable<Double> values, IEnumerable<Double> xValues, Nullable<OfficeColor> color, IEnumerable<Nullable<OfficeColor>> pointColors, Boolean showMarkers, Boolean showInLegend = true, Boolean connectLine = true, Nullable<Int32> markerSize = null, Nullable<OfficeChartMarkerShape> markerShape = null, Nullable<OfficeColor> markerOutlineColor = null, Nullable<Double> markerOutlineWidth = null, Nullable<Double> strokeWidth = null, Nullable<OfficeStrokeDashStyle> strokeDashStyle = null, Nullable<OfficeChartKind> renderKind = null, OfficeChartAxisGroup axisGroup = Primary) #Initializes a chart series snapshot with optional source style metadata and marker visibility.
Parameters
- name System.String
- Display name for the series.
- values System.Collections.Generic.IEnumerable{System.Double}
- Values aligned with the chart categories or X-axis values.
- xValues System.Collections.Generic.IEnumerable{System.Double}
- Optional numeric X-axis values for this series.
- color System.Nullable{OfficeIMO.Drawing.OfficeColor}
- Optional source-defined series color.
- pointColors System.Collections.Generic.IEnumerable{System.Nullable{OfficeIMO.Drawing.OfficeColor}}
- Optional source-defined colors aligned with individual values.
- showMarkers System.Boolean
- Whether this series should render markers when the chart layout enables them.
- showInLegend System.Boolean = true
- Whether this series should appear in rendered legends.
- connectLine System.Boolean = true
- Whether this series should render connecting line segments when the chart family supports them.
- markerSize System.Nullable{System.Int32} = null
- Optional source-defined marker diameter in drawing units.
- markerShape System.Nullable{OfficeIMO.Drawing.OfficeChartMarkerShape} = null
- Optional source-defined marker shape.
- markerOutlineColor System.Nullable{OfficeIMO.Drawing.OfficeColor} = null
- Optional source-defined marker outline color.
- markerOutlineWidth System.Nullable{System.Double} = null
- Optional source-defined marker outline width in points, greater than zero and at most 1584.
- strokeWidth System.Nullable{System.Double} = null
- Optional source-defined series stroke width in points, greater than zero and at most 1584.
- strokeDashStyle System.Nullable{OfficeIMO.Drawing.OfficeStrokeDashStyle} = null
- Optional source-defined series stroke dash style.
- renderKind System.Nullable{OfficeIMO.Drawing.OfficeChartKind} = null
- Optional per-series chart kind used by mixed/combo chart renderers.
- axisGroup OfficeIMO.Drawing.OfficeChartAxisGroup = Primary
- Primary or secondary value axis used by combo chart renderers.
Methods
public static OfficeChartSeries CreateBubble(String name, IEnumerable<Double> xValues, IEnumerable<Double> yValues, IEnumerable<Double> bubbleSizes, Nullable<OfficeColor> color, IEnumerable<Nullable<OfficeColor>> pointColors, Boolean showInLegend, Nullable<OfficeColor> markerOutlineColor, Nullable<Double> markerOutlineWidth) #OfficeChartSeriesCreates a bubble-chart series with numeric X/Y coordinates and per-point bubble sizes.
Parameters
- name System.String
- Display name for the series.
- xValues System.Collections.Generic.IEnumerable{System.Double}
- Numeric X-axis values.
- yValues System.Collections.Generic.IEnumerable{System.Double}
- Numeric Y-axis values.
- bubbleSizes System.Collections.Generic.IEnumerable{System.Double}
- Non-negative bubble sizes aligned with the X/Y values.
- color System.Nullable{OfficeIMO.Drawing.OfficeColor}
- Optional source-defined series color.
- pointColors System.Collections.Generic.IEnumerable{System.Nullable{OfficeIMO.Drawing.OfficeColor}}
- Optional source-defined colors aligned with individual bubbles.
- showInLegend System.Boolean
- Whether this series should appear in rendered legends.
- markerOutlineColor System.Nullable{OfficeIMO.Drawing.OfficeColor}
- Optional source-defined bubble outline color.
- markerOutlineWidth System.Nullable{System.Double}
- Optional source-defined bubble outline width in points, greater than zero and at most 1584.
public static OfficeChartSeries CreateBubble(String name, IEnumerable<Double> xValues, IEnumerable<Double> yValues, IEnumerable<Double> bubbleSizes, Nullable<OfficeColor> color = null, IEnumerable<Nullable<OfficeColor>> pointColors = null, Boolean showInLegend = true, Nullable<OfficeColor> markerOutlineColor = null, Nullable<Double> markerOutlineWidth = null, Boolean showMarkerOutline = true) #OfficeChartSeriesCreates a bubble-chart series with explicit control over whether bubble outlines are rendered.
Parameters
- name System.String
- Display name for the series.
- xValues System.Collections.Generic.IEnumerable{System.Double}
- Numeric X-axis values.
- yValues System.Collections.Generic.IEnumerable{System.Double}
- Numeric Y-axis values.
- bubbleSizes System.Collections.Generic.IEnumerable{System.Double}
- Non-negative bubble sizes aligned with the X/Y values.
- color System.Nullable{OfficeIMO.Drawing.OfficeColor} = null
- Optional source-defined series color.
- pointColors System.Collections.Generic.IEnumerable{System.Nullable{OfficeIMO.Drawing.OfficeColor}} = null
- Optional source-defined colors aligned with individual bubbles.
- showInLegend System.Boolean = true
- Whether this series should appear in rendered legends.
- markerOutlineColor System.Nullable{OfficeIMO.Drawing.OfficeColor} = null
- Optional source-defined bubble outline color.
- markerOutlineWidth System.Nullable{System.Double} = null
- Optional source-defined bubble outline width in points, greater than zero and at most 1584.
- showMarkerOutline System.Boolean = true
- Whether the bubble outline should be rendered.
public OfficeChartSeries WithLegendVisibility(Boolean showInLegend) #OfficeChartSeriesReturns a copy with the requested legend visibility and unchanged data and appearance.
Parameters
- showInLegend System.Boolean
public OfficeChartSeries WithPointExplosions(IEnumerable<Int32> pointExplosions) #OfficeChartSeriesReturns a copy with an explosion percentage for each pie or doughnut point. Null leaves native point offsets unchanged during data updates.
Parameters
- pointExplosions System.Collections.Generic.IEnumerable{System.Int32}
public OfficeChartSeries WithPointStyles(IEnumerable<OfficeChartPointStyle> pointStyles) #OfficeChartSeriesReturns a copy with aligned immutable point styles. Null removes shared style metadata; null entries inherit the series/theme appearance and any legacy PointColors entry.
Parameters
- pointStyles System.Collections.Generic.IEnumerable{OfficeIMO.Drawing.OfficeChartPointStyle}
Inherited Methods
public override Boolean Equals(Object obj) #BooleanParameters
- obj Object
Properties
public String Name { get; } #Series display name.
public IReadOnlyList<Double> Values { get; } #Series values aligned with chart categories.
public IReadOnlyList<Double> XValues { get; } #Optional per-series numeric X-axis values for scatter charts.
public IReadOnlyList<Double> BubbleSizes { get; } #Optional per-point sizes for bubble charts.
public Nullable<OfficeColor> Color { get; } #Optional source-defined series color.
public IReadOnlyList<Nullable<OfficeColor>> PointColors { get; } #Optional source-defined colors aligned with individual series values.
public IReadOnlyList<OfficeChartPointStyle> PointStyles { get; set; } #Optional point styles aligned with the values; explicit fills override PointColors.
public IReadOnlyList<Int32> PointExplosions { get; set; } #Optional pie or doughnut slice offsets, as percentages of the slice radius.
public Boolean ShowMarkers { get; } #Whether this series should render markers when the chart layout enables markers.
public Nullable<Int32> MarkerSize { get; } #Optional source-defined marker diameter in drawing units.
public Nullable<OfficeChartMarkerShape> MarkerShape { get; } #Optional source-defined marker shape.
public Nullable<OfficeColor> MarkerOutlineColor { get; } #Optional source-defined marker outline color.
public Nullable<Double> MarkerOutlineWidth { get; } #Optional source-defined marker outline width in points, greater than zero and at most 1584.
public Boolean ShowMarkerOutline { get; } #Whether the marker or bubble outline should be rendered.
public Nullable<Double> StrokeWidth { get; } #Optional source-defined series stroke width in points, greater than zero and at most 1584.
public Nullable<OfficeStrokeDashStyle> StrokeDashStyle { get; } #Optional source-defined series stroke dash style.
public Nullable<OfficeChartKind> RenderKind { get; } #Optional per-series chart kind for mixed/combo chart rendering.
public OfficeChartAxisGroup AxisGroup { get; } #Primary or secondary value axis used by combo chart renderers.
public Boolean ShowInLegend { get; } #Whether this series should appear in rendered legends.
public Boolean ConnectLine { get; } #Whether this series should render connecting line segments when the chart family supports them.
Fields
public const Int32 MaximumPointExplosionPercent #Largest pie or doughnut point explosion that the shared renderer supports.
400