Project

ChartForgeX

Render deterministic charts, dashboards, topology, hierarchy, and report visuals directly from .NET.

Stars 45
Forks 2
NuGet downloads 48,107
Release ChartForgeX-v1.7.0
Language: HTML Updated: 2026-09-02

API Reference

Class

ChartGrid

Namespace ChartForgeX.Core

Describes a dependency-free small-multiple report made from multiple charts.

Inheritance

  • Object
  • ChartGrid

Usage

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

Accepted by parameters

Methods

Add 2 overloads
Add(ChartForgeX.Core.Chart chart) #

Adds a chart to the grid.

Parameters

chart ChartForgeX.Core.Chart required
The chart to add.

Returns

The current chart grid.

Add(ChartForgeX.Core.Chart chart, System.Int32 columnSpan, System.Int32 rowSpan) #

Adds a chart to the grid with a panel span.

Parameters

chart ChartForgeX.Core.Chart required
The chart to add.
columnSpan System.Int32 required
The number of columns occupied by the chart panel.
rowSpan System.Int32 required
The number of rows occupied by the chart panel.

Returns

The current chart grid.

Create() #

Creates a new chart grid.

Returns

A new chart grid instance.

FromFacets``2(ChartForgeX.Data.ChartDataset{``0} arg1, System.Func{``0,``1} arg2, System.Func{``1,ChartForgeX.Data.ChartDataset{``0},ChartForgeX.Core.Chart} arg3, System.Int32 arg4, System.Collections.Generic.IEqualityComparer{``1} arg5) #

Builds a small-multiple grid from deterministic dataset groups.

Parameters

arg1 ChartForgeX.Data.ChartDataset{``0} required
arg2 System.Func{``0,``1} required
arg3 System.Func{``1,ChartForgeX.Data.ChartDataset{``0},ChartForgeX.Core.Chart} required
arg4 System.Int32 required
arg5 System.Collections.Generic.IEqualityComparer{``1} required
WithAutomaticPanelSize() #

Clears the fixed panel size so composed exports use the largest chart dimensions.

Returns

The current chart grid.

WithAutomaticTheme() #

Clears the grid theme so renderers use the first chart theme.

Returns

The current chart grid.

WithColumns(System.Int32 columns) #

Sets the preferred number of columns on wide viewports.

Parameters

columns System.Int32 required
The preferred column count.

Returns

The current chart grid.

WithGap(System.Int32 gap) #

Sets the gap between charts in pixels.

Parameters

gap System.Int32 required
The gap in pixels.

Returns

The current chart grid.

WithPadding(System.Int32 padding) #

Sets the outer padding around exported grid content in pixels.

Parameters

padding System.Int32 required
The padding in pixels.

Returns

The current chart grid.

WithPanelFit(ChartForgeX.Primitives.VisualPanelFit fit) #

Sets how charts fit inside fixed-size grid panels.

Parameters

fit ChartForgeX.Primitives.VisualPanelFit required
The panel fit behavior.

Returns

The current chart grid.

WithPanelSize(System.Int32 width, System.Int32 height) #

Sets a fixed panel size for composed SVG and PNG grid exports.

Parameters

width System.Int32 required
The panel width in pixels.
height System.Int32 required
The panel height in pixels.

Returns

The current chart grid.

WithPanelSpan(System.Int32 chartIndex, System.Int32 columnSpan, System.Int32 rowSpan) #

Sets the panel span for an existing chart in the grid.

Parameters

chartIndex System.Int32 required
The zero-based chart index.
columnSpan System.Int32 required
The number of columns occupied by the chart panel.
rowSpan System.Int32 required
The number of rows occupied by the chart panel.

Returns

The current chart grid.

WithPngOutputScale 2 overloads
WithPngOutputScale(System.Int32 scale) #

Sets the output pixel multiplier used by composed PNG grid exports.

Parameters

scale System.Int32 required
The output scale from one to four. Higher values emit larger PNG dimensions with the same logical grid layout.

Returns

The current chart grid.

WithPngOutputScale(ChartForgeX.Core.ChartPngOutputScale scale) #

Sets the output pixel multiplier used by composed PNG grid exports using a named density preset.

Parameters

scale ChartForgeX.Core.ChartPngOutputScale required
The output density preset.

Returns

The current chart grid.

WithSharedAxes() #

Applies shared cartesian x-axis and y-axis ranges to all compatible charts in the grid.

Returns

The current chart grid.

WithSharedXAxis() #

Applies one shared cartesian x-axis range to all compatible charts in the grid.

Returns

The current chart grid.

WithSharedYAxis() #

Applies one shared cartesian y-axis range to all compatible charts in the grid.

Returns

The current chart grid.

WithSubtitle(System.String subtitle) #

Sets the report subtitle.

Parameters

subtitle System.String required
The report subtitle.

Returns

The current chart grid.

WithSubtitleStyle(System.Action{ChartForgeX.Typography.TextStyleOverride} configure) #

Configures grid subtitle text styling.

Parameters

configure System.Action{ChartForgeX.Typography.TextStyleOverride} required
The style configuration callback.

Returns

The current chart grid.

WithTheme(ChartForgeX.Themes.ChartTheme theme) #

Sets the theme used by the grid background and heading.

Parameters

theme ChartForgeX.Themes.ChartTheme required
The grid theme.

Returns

The current chart grid.

WithTitle(System.String title) #

Sets the report title.

Parameters

title System.String required
The report title.

Returns

The current chart grid.

WithTitleStyle(System.Action{ChartForgeX.Typography.TextStyleOverride} configure) #

Configures grid title text styling.

Parameters

configure System.Action{ChartForgeX.Typography.TextStyleOverride} required
The style configuration callback.

Returns

The current chart grid.

Properties

Title #

Gets or sets the report title.

Subtitle #

Gets or sets the report subtitle.

Columns #

Gets or sets the preferred number of columns on wide viewports.

Gap #

Gets or sets the gap between charts in pixels.

Padding #

Gets or sets the outer padding around exported grid content in pixels.

PngOutputScale #

Gets or sets the output pixel multiplier used by composed PNG grid exports.

PanelSize #

Gets or sets the optional fixed panel size used by composed SVG and PNG grid exports.

PanelFit #

Gets or sets how charts fit inside fixed-size grid panels.

Theme #

Gets or sets the optional theme used by the grid background and heading.

TitleStyle #

Gets the text style used for the grid title.

SubtitleStyle #

Gets the text style used for the grid subtitle.

Charts #

Gets the charts included in the grid.

PanelSpans #

Gets the panel spans for charts included in the grid.