StepProgressBar.SelectedItemChanged Event

Fires when the selection moves to another item.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v20.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DXCategory("Property Changed")]
public event StepProgressBarSelectedItemChangedEventHandler SelectedItemChanged

VB.NET

<DXCategory("Property Changed")>
Public Event SelectedItemChanged As StepProgressBarSelectedItemChangedEventHandler

Event Data

The SelectedItemChanged event's data class is DevExpress.XtraEditors.StepProgressBarSelectedItemChangedEventArgs.

Remarks

The sample below illustrates how to change item settings when the SelectedItemChanged event occurs.

C#

spBar1.ConnectorLineThickness = 15;
spBar1.IndentBetweenItems = 50;
spBar1.IndicatorLineThickness = 4;
spBar1.ItemOptions.ConnectorOffset = -20;
spBar1.ItemOptions.Indicator.ActiveStateDrawMode = DevExpress.XtraEditors.IndicatorDrawMode.None;
spBar1.ItemOptions.Indicator.InactiveStateDrawMode = DevExpress.XtraEditors.IndicatorDrawMode.None;
spBar1.ItemOptions.Indicator.Width = 50;

private void spBar1_SelectedItemChanged(object sender, StepProgressBarSelectedItemChangedEventArgs e) {
    DevExpress.XtraEditors.StepProgressBar bar = sender as DevExpress.XtraEditors.StepProgressBar;
    foreach (StepProgressBarItem item in bar.Items) {
        item.Options.Indicator.Images.ActiveStateImageOptions.SvgImage = null;
        item.Options.Indicator.Width = 50;
        item.Options.ConnectorOffset = -20;
        item.ContentBlock1.Description = null;
    }
    if (e.Item != null) {
        e.Item.Options.Indicator.Images.ActiveStateImageOptions.SvgImage = svgImageCollection1[0];
        e.Item.Options.Indicator.Width = 100;
        e.Item.ContentBlock1.Description = "Step " + (bar.SelectedItemIndex + 1).ToString() + " of 6";
        e.Item.Options.ConnectorOffset = 0;
        if (bar.SelectedItemIndex < 3)
            bar.Appearances.CommonActiveColor = Color.IndianRed;
        if (bar.SelectedItemIndex >= 3 && bar.SelectedItemIndex < 5)
            bar.Appearances.CommonActiveColor = Color.Goldenrod;
        if (bar.SelectedItemIndex >= 5)
            bar.Appearances.CommonActiveColor = Color.Green;
    }
}

VB.NET

spBar1.ConnectorLineThickness = 15
spBar1.IndentBetweenItems = 50
spBar1.IndicatorLineThickness = 4
spBar1.ItemOptions.ConnectorOffset = -20
spBar1.ItemOptions.Indicator.ActiveStateDrawMode = DevExpress.XtraEditors.IndicatorDrawMode.None
spBar1.ItemOptions.Indicator.InactiveStateDrawMode = DevExpress.XtraEditors.IndicatorDrawMode.None
spBar1.ItemOptions.Indicator.Width = 50

private void spBar1_SelectedItemChanged(Object sender, StepProgressBarSelectedItemChangedEventArgs e)
    Dim bar As DevExpress.XtraEditors.StepProgressBar = TryCast(sender, DevExpress.XtraEditors.StepProgressBar)
    For Each item As StepProgressBarItem In bar.Items
        item.Options.Indicator.Images.ActiveStateImageOptions.SvgImage = Nothing
        item.Options.Indicator.Width = 50
        item.Options.ConnectorOffset = -20
        item.ContentBlock1.Description = Nothing
    Next item
    If e.Item IsNot Nothing Then
        e.Item.Options.Indicator.Images.ActiveStateImageOptions.SvgImage = svgImageCollection1(0)
        e.Item.Options.Indicator.Width = 100
        e.Item.ContentBlock1.Description = "Step " & (bar.SelectedItemIndex + 1).ToString() & " of 6"
        e.Item.Options.ConnectorOffset = 0
        If bar.SelectedItemIndex < 3 Then
            bar.Appearances.CommonActiveColor = Color.IndianRed
        End If
        If bar.SelectedItemIndex >= 3 AndAlso bar.SelectedItemIndex < 5 Then
            bar.Appearances.CommonActiveColor = Color.Goldenrod
        End If
        If bar.SelectedItemIndex >= 5 Then
            bar.Appearances.CommonActiveColor = Color.Green
        End If
    End If