DxChart<T>.SeriesSelectionMode Property

Specifies whether a user can select series.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v22.1.dll

NuGet Package: DevExpress.Blazor

Declaration

[DefaultValue(ChartSelectionMode.None)]
[Parameter]
public ChartSelectionMode SeriesSelectionMode { get; set; }

Property Value

Type	Default	Description
ChartSelectionMode	None	A value that identifies a selection mode.

Available values:

Name	Description
None	A user cannot select points or series.
Single	A single point or series can be selected at the same time.
Multiple	Multiple points or series can be selected at the same time.

Remarks

A user can click a continuous series (lines or areas) to select an entire series:

Use the following properties to enable/disable selection for individual series:

• AreaSeriesBase.SelectionMode
• BarSeriesBase.SelectionMode
• BubbleSeries.SelectionMode
• FinancialSeriesBase.SelectionMode
• LineSeriesBase.SelectionMode
• RangeAreaSeries.SelectionMode
• RangeBarSeries.SelectionMode
• ScatterSeries.SelectionMode

You can specify the DxChart.PointSelectionMode (DxPieChart.PointSelectionMode property to set selection mode for points. Note that for discrete series (for example, bars), the PointSelectionMode property has a higher priority over the SeriesSelectionMode property. This means that these properties are not applied simultaneously.

Example

The following example enables selection for a line chart:

• A user can select multiple points. Points with the same argument are selected when the user selects a point.
• A user can select an entire series by clicking a line segment. When the user selects a series, the selection of the previously selected series is reset.

Razor

<DxChart Data="@dataPoints"
         SeriesSelectionMode=ChartSelectionMode.Single
         PointSelectionMode=ChartSelectionMode.Multiple>

    <DxChartLineSeries ArgumentField="@((DataPoint i) => i.Arg)"
                       ValueField="@((DataPoint i) => i.Value1)"
                       Name="Series 1"
                       HoverMode=ChartContinuousSeriesHoverMode.None
                       SelectionMode=ChartContinuousSeriesSelectionMode.Series>
        <DxChartSeriesPoint HoverMode=ChartSeriesPointHoverMode.None
                            SelectionMode=ChartSeriesPointSelectionMode.AllPointsForArgument />
    </DxChartLineSeries>

    <DxChartLineSeries ArgumentField="@((DataPoint i) => i.Arg)"
                       ValueField="@((DataPoint i) => i.Value2)"
                       Name="Series 2"
                       HoverMode=ChartContinuousSeriesHoverMode.None
                       SelectionMode=ChartContinuousSeriesSelectionMode.Series>
        <DxChartSeriesPoint HoverMode=ChartSeriesPointHoverMode.None
                            SelectionMode=ChartSeriesPointSelectionMode.AllPointsForArgument />
    </DxChartLineSeries>

    <DxChartLineSeries ArgumentField="@((DataPoint i) => i.Arg)"
                       ValueField="@((DataPoint i) => i.Value3)"
                       Name="Series 3"
                       HoverMode=ChartContinuousSeriesHoverMode.None
                       SelectionMode=ChartContinuousSeriesSelectionMode.Series>
        <DxChartSeriesPoint HoverMode=ChartSeriesPointHoverMode.None
                            SelectionMode=ChartSeriesPointSelectionMode.AllPointsForArgument />
    </DxChartLineSeries>

</DxChart>