CustomDrawSeriesPointEventArgs.LabelText Property

Gets or sets the text of a label for the point currently being painted.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v19.2.dll

Declaration

C#

public string LabelText { get; set; }

VB.NET

Public Property LabelText As String

Property Value

Type	Description
String	A String representing a label’s text.

Remarks

Use the LabelText property to change the text of a label for the point currently being painted when handling the ChartControl.CustomDrawSeriesPoint event. For a series with points containing two labels, you can also specify the CustomDrawSeriesPointEventArgs.SecondLabelText property.

Note

If the LabelText property is set to Empty or null (Nothing in Visual Basic), this label will be hidden.

Example

Handle the ChartControl.CustomDrawSeriesPoint event to conditionally hide series labels. In the event handler, change the CustomDrawSeriesPointEventArgs.LabelText property value to String.Empty to hide a label.

Note

Handling the WebChartControl.CustomDrawSeriesPoint (ChartControlSettings.CustomDrawSeriesPoint) event is necessary to perform the same for the Chart Control for ASP.NET and MVC.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-hide-an-individual-series-label-t543112

Form1.cs

private void OnCustomDrawSeriesPoint(object sender, CustomDrawSeriesPointEventArgs e) {
    if (e.SeriesPoint.Values[0] < 1) {
        e.LabelText = String.Empty;
    }
}

Form1.vb

Private Sub OnCustomDrawSeriesPoint(ByVal sender As Object, ByVal e As CustomDrawSeriesPointEventArgs) Handles chartControl1.CustomDrawSeriesPoint
    If e.SeriesPoint.Values(0) < 1 Then
        e.LabelText = String.Empty
    End If
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the LabelText property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-show-only-peak-series-labels-e1072/CS/CustomLabelsWithaLargeAmountOfData/Form1.cs#L31

if (e.SeriesPoint.Values[0] <= e.Series.Points[index+1].Values[0])
    e.LabelText = "";
return;

how-to-change-the-series-line-color-when-the-value-is-under-a-predefined-level-e462/CS/Form1.cs#L45

    (e.SeriesDrawOptions as LineDrawOptions).MarkerVisible = false;
    e.LabelText = "";
}

how-to-show-series-labels-for-hot-tracked-points-e2483/CS/ShowLabelsOnHotTrack/Form1.cs#L35

{
    e.LabelText = "";
}

how-to-hide-an-individual-series-label-t543112/CS/HiddenLabelsSample/Form1.cs#L16

if (e.SeriesPoint.Values[0] < 1) {
    e.LabelText = String.Empty;
}

how-to-conditionally-hide-series-labels-e452/CS/Form1.cs#L29

if(!e.Series.Points.Max(p => p.ArgumentX.NumericalArgument).Equals(e.SeriesPoint.NumericalArgument)) {
    e.LabelText = "";
}

VB.NET

how-to-show-only-peak-series-labels-e1072/VB/CustomLabelsWithaLargeAmountOfData/Form1.vb#L27

If e.SeriesPoint.Values(0) <= e.Series.Points(index+1).Values(0) Then
    e.LabelText = ""
End If

how-to-change-the-series-line-color-when-the-value-is-under-a-predefined-level-e462/VB/Form1.vb#L40

    TryCast(e.SeriesDrawOptions, LineDrawOptions).MarkerVisible = False
    e.LabelText = ""
End If

how-to-show-series-labels-for-hot-tracked-points-e2483/VB/ShowLabelsOnHotTrack/Form1.vb#L30

If Not Object.Equals(e.SeriesPoint, m_HotTrackedPoint) Then
    e.LabelText = ""
End If

how-to-hide-an-individual-series-label-t543112/VB/HiddenLabelsSample/Form1.vb#L18

If e.SeriesPoint.Values(0) < 1 Then
    e.LabelText = String.Empty
End If

how-to-conditionally-hide-series-labels-e452/VB/Form1.vb#L31

If Not e.Series.Points.Max(Function(p) p.ArgumentX.NumericalArgument).Equals(e.SeriesPoint.NumericalArgument) Then
    e.LabelText = ""
End If