Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/
Class

OfficeSeries

OfficeIMO

Namespace
OfficeIMO
Assembly
OfficeIMO.Core
Source revision
e163ccb36643 with working tree changes
Modifiers
sealed

Dependency-free chart series values used by shared OfficeIMO visual renderers.

Inheritance

  • object
  • OfficeSeries

Usage

Explore 9 API references to this type

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

Accepted by parameters 1

Constructors

OfficeSeries 5 overloads
public OfficeSeries(string name, IEnumerable<double> values) #

Initializes a chart series snapshot.

Parameters

name string required
Display name for the series.
values System.Collections.Generic.IEnumerable<double> required
Values aligned with the chart categories.
public OfficeSeries(string name, IEnumerable<double> values, IEnumerable<double>? xValues) #

Initializes a chart series snapshot with optional numeric X-axis values for scatter charts.

Parameters

name string required
Display name for the series.
values System.Collections.Generic.IEnumerable<double> required
Values aligned with the chart categories or X-axis values.
xValues System.Collections.Generic.IEnumerable<double>? required
Optional numeric X-axis values for this series.
public OfficeSeries(string name, IEnumerable<double> values, IEnumerable<double>? xValues, OfficeColor? color) #

Initializes a chart series snapshot with optional numeric X-axis values and source style metadata.

Parameters

name string required
Display name for the series.
values System.Collections.Generic.IEnumerable<double> required
Values aligned with the chart categories or X-axis values.
xValues System.Collections.Generic.IEnumerable<double>? required
Optional numeric X-axis values for this series.
color OfficeIMO.OfficeColor? required
Optional source-defined series color.
public OfficeSeries(string name, IEnumerable<double> values, IEnumerable<double>? xValues, OfficeColor? color, IEnumerable<OfficeColor?>? pointColors) #

Initializes a chart series snapshot with optional source style metadata.

Parameters

name string required
Display name for the series.
values System.Collections.Generic.IEnumerable<double> required
Values aligned with the chart categories or X-axis values.
xValues System.Collections.Generic.IEnumerable<double>? required
Optional numeric X-axis values for this series.
color OfficeIMO.OfficeColor? required
Optional source-defined series color.
pointColors System.Collections.Generic.IEnumerable<OfficeIMO.OfficeColor?>? required
Optional source-defined colors aligned with individual values.
public OfficeSeries(string name, IEnumerable<double> values, IEnumerable<double>? xValues, OfficeColor? color, IEnumerable<OfficeColor?>? pointColors, bool showMarkers, bool showInLegend = true, bool connectLine = true, OfficeLength? markerSize = null, OfficeChartMarkerShape? markerShape = null, OfficeColor? markerOutlineColor = null, OfficeLength? markerOutlineWidth = null, OfficeLength? strokeWidth = null, OfficeStrokeDashStyle? strokeDashStyle = null, OfficeChartType? renderKind = null, OfficeChartAxisGroup axisGroup = Primary) #

Initializes a chart series snapshot with optional source style metadata and marker visibility.

Parameters

name string required
Display name for the series.
values System.Collections.Generic.IEnumerable<double> required
Values aligned with the chart categories or X-axis values.
xValues System.Collections.Generic.IEnumerable<double>? required
Optional numeric X-axis values for this series.
color OfficeIMO.OfficeColor? required
Optional source-defined series color.
pointColors System.Collections.Generic.IEnumerable<OfficeIMO.OfficeColor?>? required
Optional source-defined colors aligned with individual values.
showMarkers bool required
Whether this series should render markers when the chart layout enables them.
showInLegend bool = true optional
Whether this series should appear in rendered legends.
connectLine bool = true optional
Whether this series should render connecting line segments when the chart family supports them.
markerSize OfficeIMO.OfficeLength? = null optional
Optional physical marker diameter, greater than zero. Null uses the renderer or native format default.
markerShape OfficeIMO.Drawing.OfficeChartMarkerShape? = null optional
Optional source-defined marker shape.
markerOutlineColor OfficeIMO.OfficeColor? = null optional
Optional source-defined marker outline color.
markerOutlineWidth OfficeIMO.OfficeLength? = null optional
Optional source-defined marker outline physical width, greater than zero and at most 1584 points.
strokeWidth OfficeIMO.OfficeLength? = null optional
Optional source-defined series stroke physical width, greater than zero and at most 1584 points.
strokeDashStyle OfficeIMO.Drawing.OfficeStrokeDashStyle? = null optional
Optional source-defined series stroke dash style.
renderKind OfficeIMO.OfficeChartType? = null optional
Optional per-series chart kind used by mixed/combo chart renderers.
axisGroup OfficeIMO.Drawing.OfficeChartAxisGroup = Primary optional
Primary or secondary value axis used by combo chart renderers.

Methods

public static OfficeSeries CreateBubble(string name, IEnumerable<double> xValues, IEnumerable<double> yValues, IEnumerable<double> bubbleSizes, OfficeColor? color = null, IEnumerable<OfficeColor?>? pointColors = null, bool showInLegend = true, OfficeColor? markerOutlineColor = null, OfficeLength? markerOutlineWidth = null, bool showMarkerOutline = true) #

Creates a bubble-chart series with explicit control over whether bubble outlines are rendered.

Parameters

name string required
Display name for the series.
xValues System.Collections.Generic.IEnumerable<double> required
Numeric X-axis values.
yValues System.Collections.Generic.IEnumerable<double> required
Numeric Y-axis values.
bubbleSizes System.Collections.Generic.IEnumerable<double> required
Non-negative bubble sizes aligned with the X/Y values.
color OfficeIMO.OfficeColor? = null optional
Optional source-defined series color.
pointColors System.Collections.Generic.IEnumerable<OfficeIMO.OfficeColor?>? = null optional
Optional source-defined colors aligned with individual bubbles.
showInLegend bool = true optional
Whether this series should appear in rendered legends.
markerOutlineColor OfficeIMO.OfficeColor? = null optional
Optional source-defined bubble outline color.
markerOutlineWidth OfficeIMO.OfficeLength? = null optional
Optional source-defined bubble outline physical width, greater than zero and at most 1584 points.
showMarkerOutline bool = true optional
Whether the bubble outline should be rendered.
public static OfficeSeries From<T, TValue>(IEnumerable<T?> data, Expression<Func<T?, TValue?>> value, string? name = null) #

Creates chart values from a numeric selector. A direct property selector supplies its own series name.

Type Parameters

T
TValue

Parameters

data System.Collections.Generic.IEnumerable<T?> required
value System.Linq.Expressions.Expression<System.Func<T?, TValue?>> required
name string? = null optional
public OfficeSeries WithLegendVisibility(bool showInLegend) #

Returns a copy with the requested legend visibility and unchanged data and appearance.

Parameters

showInLegend bool required
public OfficeSeries WithPointExplosions(IEnumerable<int>? pointExplosions) #

Returns 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<int>? required
public OfficeSeries WithPointStyles(IEnumerable<OfficeChartPointStyle?>? pointStyles) #

Returns 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?>? required
public OfficeSeries WithSeriesStyle(OfficeChartPointStyle? style) #

Returns a copy with independent series fill and outline paint. Null restores inherited paint.

Parameters

style OfficeIMO.Drawing.OfficeChartPointStyle? required
public OfficeSeries WithTrendline(OfficeChartTrendline? trendline) #

Returns a copy with the trendline replaced; null removes it.

Parameters

trendline OfficeIMO.Drawing.OfficeChartTrendline? required

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 OfficeColor? Color { get; } #

Optional source-defined series color.

public IReadOnlyList<OfficeColor?>? PointColors { get; } #

Optional source-defined colors aligned with individual series values.

public OfficeChartPointStyle? SeriesStyle { get; private set; } #

Optional series fill and outline overrides, independent of the legacy palette colour.

public IReadOnlyList<OfficeChartPointStyle?>? PointStyles { get; private set; } #

Optional point styles aligned with the values; explicit fills override PointColors.

public IReadOnlyList<int>? PointExplosions { get; private set; } #

Optional pie or doughnut slice offsets, as percentages of the slice radius.

public OfficeChartTrendline? Trendline { get; private set; } #

Optional trendline fitted to this series.

public bool ShowMarkers { get; } #

Gets the source marker preference. Constructors without a visibility argument use the theme's line-marker defaults; explicit visibility and point styling take precedence.

public OfficeLength? MarkerSize { get; } #

Optional physical marker diameter, greater than zero. Null uses the renderer or native format default.

public OfficeChartMarkerShape? MarkerShape { get; } #

Optional source-defined marker shape.

public OfficeColor? MarkerOutlineColor { get; } #

Optional source-defined marker outline color.

public OfficeLength? MarkerOutlineWidth { get; } #

Optional source-defined marker outline physical width, greater than zero and at most 1584 points.

public bool ShowMarkerOutline { get; } #

Whether the marker or bubble outline should be rendered.

public OfficeLength? StrokeWidth { get; } #

Optional source-defined series stroke physical width, greater than zero and at most 1584 points.

public OfficeStrokeDashStyle? StrokeDashStyle { get; } #

Optional source-defined series stroke dash style.

public OfficeChartType? 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 bool ShowInLegend { get; } #

Whether this series should appear in rendered legends.

public bool ConnectLine { get; } #

Whether this series should render connecting line segments when the chart family supports them.

Fields

public const int MaximumPointExplosionPercent #

Largest pie or doughnut point explosion that the shared renderer supports.

Value: 400