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

LabelPlacementRequest

Namespace ChartForgeX.Rendering
Assembly ChartForgeX
Modifiers sealed

A measured label with an anchor, priority and ordered candidate positions.

Inheritance

  • Object
  • LabelPlacementRequest

Usage

Explore 2 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.

Returned or exposed by 1

Accepted by parameters 1

Constructors

public LabelPlacementRequest(String text, ChartPoint anchor, TextStyle style, IReadOnlyList<LabelCandidate> candidates, Int32 priority = 0) #

Creates a placement request. Higher priorities are placed first; equal priorities retain input order.

Parameters

text System.String requiredposition: 0
anchor ChartForgeX.Primitives.ChartPoint requiredposition: 1
style ChartForgeX.Typography.TextStyle requiredposition: 2
candidates System.Collections.Generic.IReadOnlyList<ChartForgeX.Rendering.LabelCandidate> requiredposition: 3
priority System.Int32 = 0 optionalposition: 4

Properties

public String Text { get; } #

Gets the original text, retained even when its visible label is shortened or dropped.

public ChartPoint Anchor { get; } #

Gets the anchor in logical pixels.

public TextStyle Style { get; } #

Gets the resolved text style.

public IReadOnlyList<LabelCandidate> Candidates { get; } #

Gets candidates in preference order.

public Int32 Priority { get; } #

Gets placement priority.

public LabelFallbackRule Fallback { get; set; } #

Gets or sets the fallback rule.

public Boolean HasLeaderLine { get; set; } #

Gets or sets whether a displaced label should have a leader from its anchor.

public String? AssociatedMarkId { get; set; } #

Gets or sets the associated mark identity. A label fully contained in that mark is intentional; all other intersections are rejected.

public ChartRect? Bounds { get; set; } #

Gets or sets optional bounds restricting this label, in addition to the scene bounds.

public Double Padding { get; set; } #

Gets or sets padding around text, such as its halo or badge inset, in logical pixels.