Back to Devexpress

StepProgressBar Class

wpf-devexpress-dot-xpf-dot-controls.md

latest5.2 KB
Original Source

StepProgressBar Class

A control that visualizes event chains.

Namespace : DevExpress.Xpf.Controls

Assembly : DevExpress.Xpf.Controls.v25.2.dll

NuGet Package : DevExpress.Wpf.Controls

Declaration

csharp
[DXLicenseWpf]
public class StepProgressBar :
    Selector
vb
<DXLicenseWpf>
Public Class StepProgressBar
    Inherits Selector

Remarks

Run Demo: StepProgressBar

StepProgressBar Visual Structure

The StepProgressBar consists of StepProgressBarItem objects and the progress line. Each StepProgressBarItem contains an item state indicator and two labels on opposite sides:

Create a StepProgressBar

  1. Add a StepProgressBar to your window in any of the following ways:

  2. Create StepProgressBarItem objects and add them to the StepProgressBar markup. These objects are individual steps within the overall progress:

  3. Specify each item’s labels:

  4. Display images for completed steps:

Generate Items from the View Model

The StepProgressBar can obtain its items from a View Model collection:

  1. Create a collection of items that should be displayed in the StepProgressBar:

  2. Create a View Model:

  3. Specify the window’s DataContext and bind StepProgressBar.ItemsSource and StepProgressBar.SelectedItem to View Model properties:

  4. Use the StepProgressBar.ItemContainerStyle property to bind generated items to data:

Customize Appearance

The following properties allow you to customize the control’s appearance. Property names are self-explanatory.

  1. NearContent, NearContentTemplate, NearContentTemplateSelector

  2. FarContent, FarContentTemplate, FarContentTemplateSelector

  3. Content, ContentTemplate, ContentTemplateSelector

  4. ShowProgress, ProgressSize, ProgressAnimationDuration, ProgressStyle, Offset

  5. ShowOuterBorder, OuterBorderBrush, OuterBorderSize, OuterBorderIndent

Keyboard Navigation

Use the following keys or shortcuts to interact with the StepProgressBar control:

KeyAction
TabNavigates between views on a page.
← → ↑ ↓Navigates between items within the StepProgressBar control.
Space or EnterActivates the focused item within the StepProgressBar control.

Information on Screen Reader Support and Contrast Theme Availability

Refer to the following topic for more information on the accessibility support in DevExpress WPF Controls: Accessibility Support.

Inheritance

Object DispatcherObject DependencyObject Visual UIElement FrameworkElement Control ItemsControl Selector StepProgressBar

See Also

StepProgressBar Members

DevExpress.Xpf.Controls Namespace