DxChart<T>.DeselectPoints(String, T[]) Method

Deselects specific series points.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v24.2.dll

NuGet Package: DevExpress.Blazor

Declaration

public void DeselectPoints(
    string seriesName,
    params T[] points
)

Parameters

Name	Type	Description
seriesName	String	The series name.
points	T[]	Data points.

Remarks

Set the DxChart.PointSelectionMode property to Single or Multiple to enable point selection in <DxChart>.

Call the following methods to manage point selection in code:

SelectPoints

Select specific series points in code.

DeselectPoints

Deselect specific series points in code.

ClearSelectionAsync()

Resets selection in the entire Chart component.

SelectPoints and DeselectPoints method overloads accept a single or multiple data points as parameters. The Chart component applies point selection based on the corresponding SelectionMode property value:

• BarSeriesBase.SelectionMode
• FinancialSeriesBase.SelectionMode
• BubbleSeries.SelectionMode
• RangeBarSeries.SelectionMode
• ScatterSeries.SelectionMode
• DxChartSeriesPoint.SelectionMode

When you call SelectPoints or DeselectPoints method overloads, <DxChart> raises the SelectionChanged event. You can obtain information about the selected point in the event handler.

Example

The following code snippet selects and deselects points of the specified series on button clicks:

Razor

<DxChart Data="@DataSource"
         @ref="chart"
         Width="900px"
         PointSelectionMode="ChartSelectionMode.Multiple">
    <DxChartBarSeries ArgumentField="@((StatisticPoint v) => v.Country)"
                      ValueField="@((StatisticPoint v) => v.Population24)"
                      Name="2024" />
    <DxChartLineSeries ArgumentField="@((StatisticPoint v) => v.Country)"
                       ValueField="@((StatisticPoint v) => v.Population23)"
                       Name="2023" />
    <DxChartLegend Orientation="Orientation.Vertical"
                   HorizontalAlignment="HorizontalAlignment.Right"
                   Position="RelativePosition.Outside" />
    <DxChartTitle Text="Population by Country" />
</DxChart>

<DxButton Text="Select points"
          Click="SelectPoints"
          RenderStyleMode="ButtonRenderStyleMode.Outline" />
<DxButton Text="Deselect points"
          Click="DeselectPoints"
          RenderStyleMode="ButtonRenderStyleMode.Outline" />

@code {
    DxChart<StatisticPoint> chart;
    IEnumerable<StatisticPoint> DataSource = Enumerable.Empty<StatisticPoint>();
    protected override void OnInitialized() {
        DataSource = GenerateData();
    }

    void SelectPoints() {
        // Pass the series index (order) as a parameter
        chart.SelectPoints(0, DataSource.First(), DataSource.Last());
        // Pass the series name as a parameter
        chart.SelectPoints("2024", DataSource.First(), DataSource.Last());
    }
    void DeselectPoints() {
        // Pass the series index (order) as a parameter
        chart.DeselectPoints(0, DataSource.First());
        // Pass the series name as a parameter
        chart.DeselectPoints("2024", DataSource.First());
    }
}

DataSource

public static List<StatisticPoint> GenerateData() {
    return new List<StatisticPoint>() {
        new StatisticPoint("Germany", 84552242, 83294633),
        new StatisticPoint("UK", 69138192, 67736802),
        new StatisticPoint("France", 66548530, 64756584),
        new StatisticPoint("Italy", 59342867, 58870763),
        new StatisticPoint("Spain", 47910526, 47519628),
    };
}
public class StatisticPoint {
    public string Country { get; set; }
    public int Population24 { get; set; }
    public int Population23 { get; set; }
    public StatisticPoint(string country, int population24, int population23) {
        Country = country;
        Population24 = population24;
        Population23 = population23;
    }
}