Project

ChartForgeX

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

Stars 47
Forks 2
NuGet downloads 75,067
Release ChartForgeX-v2.0.0
Language: HTML Updated: 2026-10-12

API Reference

Class

ChartAxis

Namespace ChartForgeX.Core
Assembly ChartForgeX
Modifiers sealed

Defines renderer-neutral bounds, scale, ticks, labels, and visibility for one chart axis.

Inheritance

  • Object
  • ChartAxis

Usage

Explore 14 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 3

Constructors

public ChartAxis() #

Methods

public ChartAxis WithAutomaticBounds() #
Returns: ChartAxis

Clears explicit bounds.

public ChartAxis WithBounds(Double minimum, Double maximum) #
Returns: ChartAxis

Sets explicit bounds.

Parameters

minimum System.Double requiredposition: 0
maximum System.Double requiredposition: 1
public ChartAxis WithLabelFormatter(Func<Double, String>? formatter) #
Returns: ChartAxis

Sets the label formatter.

Parameters

formatter System.Func<System.Double, System.String>? requiredposition: 0
public ChartAxis WithReversal(Boolean reversed = true) #
Returns: ChartAxis

Reverses the visual direction while retaining bounds and source values.

Parameters

reversed System.Boolean = true optionalposition: 0
public ChartAxis WithScale(ChartScaleKind scale) #
Returns: ChartAxis

Sets the mathematical scale.

Parameters

scale ChartForgeX.Core.ChartScaleKind requiredposition: 0
public ChartAxis WithTimeScale(TimeZoneInfo? timeZone = null, Boolean showTimeZone = false, String? label = null) #
Returns: ChartAxis

Uses a UTC time scale displayed in timeZone (UTC when null) and optionally shows the zone designator.

Parameters

timeZone System.TimeZoneInfo? = null optionalposition: 0
The display time zone, or null for UTC.
showTimeZone System.Boolean = false optionalposition: 1
Whether the axis title shows the zone designator.
label System.String? = null optionalposition: 2
An optional designator such as CET or Europe/Warsaw.

Returns

The current axis.

public ChartAxis WithValueFormat(ChartValueFormat? format) #
Returns: ChartAxis

Sets the numeric display policy; null restores scale-aware automatic formatting.

Parameters

format ChartForgeX.Core.ChartValueFormat? requiredposition: 0
public ChartAxis WithVisibility(Boolean visible = true) #
Returns: ChartAxis

Sets axis visibility.

Parameters

visible System.Boolean = true optionalposition: 0

Properties

public Double? Minimum { get; set; } #

Gets or sets an explicit minimum. Null enables automatic bounds.

public Double? Maximum { get; set; } #

Gets or sets an explicit maximum. Null enables automatic bounds.

public ChartScaleKind Scale { get; set; } #

Gets or sets the mathematical axis scale.

public Double SymmetricLogarithmThreshold { get; set; } #

Gets or sets the positive linear threshold used by symmetric logarithmic scaling.

public Int32 TickCount { get; set; } #

Gets or sets the preferred number of generated ticks.

public ChartLabelDensity LabelDensity { get; set; } #

Gets or sets label density.

public Double LabelAngle { get; set; } #

Gets or sets label rotation in degrees, or an offset from the selected relative orientation.

public ChartAxisLabelOrientation LabelOrientation { get; set; } #

Gets or sets how labels follow the axis. The default is a fixed screen orientation.

public Boolean Visible { get; set; } #

Gets or sets a value indicating whether the axis and its labels are visible.

public Boolean Reversed { get; set; } #

Gets or sets whether increasing values advance in the reverse visual direction. Bounds and source labels keep their original values.

public Boolean ShowLine { get; set; } #

Gets or sets a value indicating whether the axis rule is visible.

public Func<Double, String>? LabelFormatter { get; set; } #

Gets or sets a formatter for generated labels.

public ChartValueFormat? ValueFormat { get; set; } #

Gets or sets the numeric display policy. Null uses the chart fallback or the scale-aware default for time axes.

public TimeZoneInfo? TimeZone { get; set; } #

Gets or sets the display time zone for ChartScaleKind.Time axes. Axis values are UTC instants; null keeps ticks and labels in UTC. A zone moves tick alignment and labels to that zone's wall-clock time.

public String? TimeZoneLabel { get; set; } #

Gets or sets the time-zone designator shown when ChartAxis.ShowTimeZone is enabled. Null uses UTC when ChartAxis.TimeZone is null, otherwise the zone identifier. Zone identifiers differ between Windows and IANA systems, so set an explicit label when output must match across platforms.

public Boolean ShowTimeZone { get; set; } #

Gets or sets a value indicating whether time axes append the time-zone designator to the axis title, or show it as the title when no title is set. Only the x-axis title is decorated.

public List<ChartAxisLabel> Labels { get; } #

Gets explicit value-to-label mappings.