ToolStripProgressBar.Maximum Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets the upper bound of the range that is defined for this ToolStripProgressBar.

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

public int Maximum { get; set; }

Property Value

Type: System.Int32

An integer representing the upper bound of the range. The default is 100.

This property specifies the upper limit of the Value property. When the value of the Maximum property is changed, the ToolStripProgressBar control is redrawn to reflect the new range of the control. When the value of the Value property is equal to the value of the Maximum property, the progress bar is completely filled.

You can use this property to specify a value that the Value property must be set to (by setting the Value property or using the Increment or PerformStep methods) to indicate that an operation is complete. For example, you can set the value of the Maximum property to the total number of files in a file copy operation. Each time a file is copied, the Value property can be increased by one until the total number of files is copied. At that point, the progress bar would be completely filled.

The following code example demonstrates a use of the Maximum property in a ToolStripProgressBar that calculates a sequence of Fibonacci numbers. This code example is part of a larger example that provided for the ToolStripProgressBar class.

requestedCountControl = new NumericUpDown();
requestedCountControl.Maximum = 1000;
requestedCountControl.Minimum = 1;
requestedCountControl.Value = 100;

.NET Framework
Available since 2.0
Return to top