Skip to content

Add comprehensive Range Bar Series documentation under Data Chart Range Series #14

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Copilot wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

Add comprehensive Range Bar Series documentation under Data Chart Range Series #14

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b09375b
Initial plan
Copilot Jun 1, 2026
650f747
Expand Range Bar Series documentation topic
Copilot Jun 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 51 additions & 1 deletion topics/en/datachart-series-range-bar.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,23 @@

= Range Bar Series

The link:{DataChartLink}.RangeBarSeries.html[RangeBarSeries] is a new xamDataChart series type that displays value ranges as horizontal bars. It is the bar-oriented counterpart to the link:{DataChartLink}.RangeColumnSeries.html[RangeColumnSeries].
== Overview

The link:{DataChartLink}.RangeBarSeries.html[RangeBarSeries] is a xamDataChart series type that displays value ranges as horizontal bars. It is the bar-oriented counterpart to the link:{DataChartLink}.RangeColumnSeries.html[RangeColumnSeries].

Range Bar Series uses a link:{DataChartLink}.CategoryYAxis.html[CategoryYAxis] for categories and a link:{DataChartLink}.NumericXAxis.html[NumericXAxis] for values, with each bar spanning from a low value to a high value on the X axis.

== Class Hierarchy

[source]
----
RangeCategorySeries
├── HorizontalRangeCategorySeries
│ ├── RangeColumnSeries (categories on X, value ranges on Y)
│ └── RangeAreaSeries (categories on X, value ranges on Y)
└── VerticalRangeCategorySeries
└── RangeBarSeries (categories on Y, value ranges on X)
----

== Requirements

Expand Down Expand Up @@ -62,6 +78,40 @@ To plot a `RangeBarSeries` in xamDataChart:
| `HighMemberAsLegendUnit` | Specifies the unit shown after the high value in the data legend.
|===

== Comparison with Range Column Series

[options="header", cols="a,a,a"]
|===
| Feature | Range Column Series | Range Bar Series
| Orientation | Vertical columns | Horizontal bars
| Category Axis | CategoryXAxis (horizontal) | CategoryYAxis (vertical)
| Value Axis | NumericYAxis (vertical) | NumericXAxis (horizontal)
| Base Class | HorizontalRangeCategorySeries | VerticalRangeCategorySeries
| IsVertical | false | true
| IsBar | false | true
|===

== Data Format

The Range Bar Series expects data items with high and low numeric values and a category label:

[source,json]
----
[
{ "Label": "A", "High": 1000, "Low": 800 },
{ "Label": "B", "High": 200, "Low": 100 },
{ "Label": "C", "High": 400, "Low": 200 },
{ "Label": "D", "High": -200, "Low": -400 },
{ "Label": "E", "High": 200, "Low": 100 }
]
----

== Related Series

* link:{DataChartLink}.RangeColumnSeries.html[RangeColumnSeries]
* link:{DataChartLink}.RangeAreaSeries.html[RangeAreaSeries]
* link:{DataChartLink}.BarSeries.html[BarSeries]

== Related Topics

* link:changelog.html[Ultimate UI for WPF Changelog]
Expand Down