ChartControl.EmptyChartText Property

Provides access to the settings of the text to be displayed in the chart control, when it has no data to display.

Assembly : DevExpress.XtraCharts.v25.2.UI.dll

NuGet Package : DevExpress.Win.Charts

Declaration

C#
VB.NET

csharp

public EmptyChartText EmptyChartText { get; }

Public ReadOnly Property EmptyChartText As EmptyChartText

Property Value

Type	Description
EmptyChartText

An EmptyChartText object, representing the empty chart text options.

Remarks

Use the EmptyChartText to access and specify the options of the text displayed by a chart at runtime.

Note

The text that indicates that the chart has no data to display appears at runtime in the following cases:

when the SimpleDiagram is used with an empty point series;
when it is impossible to determine the diagram type because no Series are added and/or the series template is not defined.

To access options of the text that indicates that the chart is too small for its diagram to be drawn, use the ChartControl.SmallChartText property.

For the WebChartControl, use the similar WebChartControl.EmptyChartText property.

Example

This example demonstrates how to provide a text for a chart, which it should display at runtime, when there’s no data to be represented by the chart.

C#
VB.NET

csharp

EmptyChartText myText = chartControl1.EmptyChartText;
myText.EnableAntialiasing = true;
myText.Text = "There are no visible series to represent in the chart.";
myText.TextColor = Color.Beige;

Dim myText As EmptyChartText = chartControl1.EmptyChartText
myText.EnableAntialiasing = True
myText.Text = "There are no visible series to represent in the chart."
myText.TextColor = Color.Beige