IChartSeriesLabel.Texts Property
Specifies text content for series labels.
Namespace: DevExpress.Blazor
Assembly: DevExpress.Blazor.v24.2.dll
NuGet Package: DevExpress.Blazor
#Declaration
string[] Texts { get; set; }
#Property Value
Type | Description |
---|---|
String[] | An array of text strings. |
#Remarks
IChartSeriesLabel properties allow you to configure point label settings. To access these settings, use the PointLabel property in a CustomizeSeriesPoint event handler.
The Texts
property allows you to specify the series label text. The length of the array depends on series type:
- Two strings for range series
- One string for other series types
#Range Series Example
The following code snippet displays labels for the specified series point and customizes label text:
<DxChart Data="@weatherForecasts"
CustomizeSeriesPoint = "@PreparePointLabel"
Width="100%">
<DxChartTitle Text="Annual Temperature" />
<DxChartRangeBarSeries ValueField="@((DetailedWeatherSummary i) => i.AverageTemperatureF)"
ArgumentField="@(i => new DateTime(2000, i.Date.Month, 1))"
Name="New York"
Filter="@((DetailedWeatherSummary i) => i.City == "NEW YORK")">
</DxChartRangeBarSeries>
@* ... *@
</DxChart>
@code {
IEnumerable<DetailedWeatherSummary> weatherForecasts;
protected override async Task OnInitializedAsync() {
weatherForecasts = await WeatherSummaryDataProvider.GetDataAsync();
}
protected void PreparePointLabel(ChartSeriesPointCustomizationSettings pointSettings) {
if (pointSettings.Point is ChartRangeSeriesPoint point) {
var endValue = (double)point.EndValue;
var startValue = (double)point.StartValue;
DateTime dateTime = (DateTime)point.Argument;
if (dateTime.Month == 5)
pointSettings.PointLabel.Visible = true;
pointSettings.PointLabel.Texts = new string[] { $"{startValue}, °F", $"{endValue}, °F" };
}
}
}
#Line Series Example
The following code snippet customizes label text for visible series points:
<DxChart Data="@WeatherForecasts"
CustomizeSeriesPoint="@PreparePointLabel"
Width="100%">
<DxChartTitle Text="Annual Weather in New York" />
<DxChartLineSeries SummaryMethod="@(i => i.Average())"
ValueField="@((DetailedWeatherSummary i) => i.AverageTemperatureF)"
ArgumentField="@(i => new DateTime(2000, i.Date.Month, 1))"
Name="Temperature, F"
Filter="@((DetailedWeatherSummary i) => i.City == "NEW YORK")" />
@* ... *@
</DxChart>
@code {
IEnumerable<DetailedWeatherSummary> WeatherForecasts;
protected override async Task OnInitializedAsync() {
WeatherForecasts = await WeatherSummaryDataProvider.GetDataAsync();
}
protected void PreparePointLabel(ChartSeriesPointCustomizationSettings pointSettings) {
double value = (double)pointSettings.Point.Value;
if (value > 50 && value < 70)
pointSettings.PointLabel.Visible = true;
pointSettings.PointLabel.Texts = new string[] { $"{Math.Round(value, 2)} °F" };
}
}