Project

ChartForgeX

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

View on GitHub Releases Get package
Stars 47
Forks 2
NuGet downloads 75,067
Release ChartForgeX-v2.0.0
Language: HTML Updated: 2026-10-12

API Reference

Class

VisualCanvasKeyValueBlockLayer

Namespace ChartForgeX.Composition
Assembly ChartForgeX.Visuals
Base VisualCanvasLayer
Modifiers sealed

Reusable key/value text block with measured label columns and wrapped value text.

Inheritance

Constructors

public VisualCanvasKeyValueBlockLayer(Double x, Double y, Double width, Double height, IEnumerable<VisualCanvasKeyValueItem> items) #

Initializes a key/value text block layer.

Parameters

x System.Double requiredposition: 0
The block X coordinate.
y System.Double requiredposition: 1
The block Y coordinate.
width System.Double requiredposition: 2
The block width.
height System.Double requiredposition: 3
The initial block height.
items System.Collections.Generic.IEnumerable<ChartForgeX.Composition.VisualCanvasKeyValueItem> requiredposition: 4
The key/value rows.

Methods

MeasureHeight 2 overloads
public Double MeasureHeight() #
Returns: Double

Measures the block height using the current text and wrapping settings and the default theme font family.

public Double MeasureHeight(VisualCanvasTheme theme) #
Returns: Double

Measures the block height with the font family the block draws with on a canvas using theme.

Parameters

theme ChartForgeX.Composition.VisualCanvasTheme requiredposition: 0

Properties

public IReadOnlyList<VisualCanvasKeyValueItem> Items { get; } #

Gets the key/value rows.

public Double LabelFontSize { get; set; } #

Gets or sets the label font size.

public Double ValueFontSize { get; set; } #

Gets or sets the value font size.

public Double ColumnGap { get; set; } #

Gets or sets the gap between label and value columns.

public Double RowGap { get; set; } #

Gets or sets the gap between rows.

public Double? LabelWidth { get; set; } #

Gets or sets an explicit label column width. When empty, the widest label is measured.

public Double? ValueWrapWidth { get; set; } #

Gets or sets an explicit value wrap width. When empty, the remaining block width is used.

public ChartColor? LabelColorOverride { get; set; } #

Gets or sets an optional default label color override.

public ChartColor? ValueColorOverride { get; set; } #

Gets or sets an optional default value color override.

public String FontFamilyName { get; set; } #

Gets or sets the font family for this block. When empty, the canvas theme family is used by SVG and PNG output alike.

public Boolean LabelEmphasized { get; set; } #

Gets or sets whether labels use the emphasized text treatment.

public Boolean ValueEmphasized { get; set; } #

Gets or sets whether values use the emphasized text treatment.