ProgressBar Class (System.Windows.Controls)

Switch on low bandwidth view

Collapse All

Language Filter

Other versions are also available for the following:

.NET Framework Class Library for Silverlight

ProgressBar Class

Updated: February 2009

Represents a control that indicates the progress of an operation.

Namespace: System.Windows.Controls
Assembly: System.Windows (in System.Windows.dll)

Syntax

Visual Basic (Declaration)

<TemplatePartAttribute(Name := "ProgressBarTrack", Type := GetType(FrameworkElement))> _
<TemplateVisualStateAttribute(Name := "Determinate", GroupName := "CommonStates")> _
<TemplateVisualStateAttribute(Name := "Indeterminate", GroupName := "CommonStates")> _
<TemplatePartAttribute(Name := "ProgressBarIndicator", Type := GetType(FrameworkElement))> _
Public Class ProgressBar _
    Inherits RangeBase

Visual Basic (Usage)

Dim instance As ProgressBar

[TemplatePartAttribute(Name = "ProgressBarTrack", Type = typeof(FrameworkElement))]
[TemplateVisualStateAttribute(Name = "Determinate", GroupName = "CommonStates")]
[TemplateVisualStateAttribute(Name = "Indeterminate", GroupName = "CommonStates")]
[TemplatePartAttribute(Name = "ProgressBarIndicator", Type = typeof(FrameworkElement))]
public class ProgressBar : RangeBase

XAML Object Element Usage

<ProgressBar .../>

Remarks

A ProgressBar control visually indicates progress of a lengthy operation with one of two styles.

A bar that displays a repeating pattern.
A bar that fills based on a value.

The following illustration shows a progress bar indicating value-based progress.

ProgressBar Control

The IsIndeterminate property determines the appearance of a ProgressBar. Set IsIndeterminate to true to display a repeating pattern. Set IsIndeterminate to false to fill the bar based on a value. When IsIndeterminate is false, you specify the range with the Minimum and Maximum properties. By default Minimum is 0 and Maximum is 100. To specify the progress value, you set the Value property.
You can change the appearance of a ProgressBar by changing its default style. For more information, see Control Customization.

Examples

The following example demonstrates a value-based ProgressBar and an indeterminate ProgressBar.

<StackPanel x:Name="LayoutRoot" Background="White">
   <Border BorderThickness="5" BorderBrush="Black">
    <StackPanel Background="LightGray">
        <TextBlock HorizontalAlignment="Center" Margin="10" 
            Text="Value-Based Progress Bar" />
        <ProgressBar x:Name="pg1" Value="100"  Margin="10" Maximum="200" 
            Height="15" IsIndeterminate="False" />
    </StackPanel>
</Border>
    <Border BorderThickness="5" BorderBrush="Black">
        <StackPanel Background="LightGray">
            <TextBlock HorizontalAlignment="Center" 
                Margin="10" Text="Indeterminate Progress Bar" />
            <ProgressBar x:Name="pg2" Margin="10" Height="15" 
                IsIndeterminate="True"   />
        </StackPanel>
    </Border>
</StackPanel>

Inheritance Hierarchy

System..::.Object
  System.Windows..::.DependencyObject
    System.Windows..::.UIElement
      System.Windows..::.FrameworkElement
        System.Windows.Controls..::.Control
          System.Windows.Controls.Primitives..::.RangeBase
            System.Windows.Controls..::.ProgressBar

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Reference

ProgressBar Members

System.Windows.Controls Namespace

Other Resources

Controls by Function

Getting Started with Controls

Change History

Date	History	Reason
February 2009	Fixed broken link.	Customer feedback.