ProgressBar::Value Property
Gets or sets the current position of the progress bar.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Property Value
Type: System::Int32The position within the range of the progress bar. The default is 0.
| Exception | Condition |
|---|---|
| ArgumentException |
The minimum and maximum values of the Value property are specified by the Minimum and Maximum properties. This property enables you to increment or decrement the value of the progress bar directly. To perform consistent increases in the value of the ProgressBar control you can use the Step property with the PerformStep method. To increase the progress bar value by varying amounts, use the Increment method.
The following code example demonstrates how to use the Increment method and the Value property to increment the value of a ProgressBar in the Tick event of a Timer. The example also displays the Value property in a StatusBarPanel to provide a textual representation of the ProgressBar. This example requires that you have a ProgressBar control, named progressBar1, and a StatusBar control that contains a StatusBarPanel, named statusBarPanel1. The Timer, named time, must be added to the form as a member.
private: Timer^ time; // Call this method from the constructor of the form. void InitializeMyTimer() { // Set the interval for the timer. time->Interval = 250; // Connect the Tick event of the timer to its event handler. time->Tick += gcnew EventHandler( this, &Form1::IncreaseProgressBar ); // Start the timer. time->Start(); } void IncreaseProgressBar( Object^ /*sender*/, EventArgs^ /*e*/ ) { // Increment the value of the ProgressBar a value of one each time. progressBar1->Increment( 1 ); // Display the textual value of the ProgressBar in the StatusBar control's first panel. statusBarPanel1->Text = String::Concat( progressBar1->Value, "% Completed" ); // Determine if we have completed by comparing the value of the Value property to the Maximum value. if ( progressBar1->Value == progressBar1->Maximum ) // Stop the timer. time->Stop(); }
Available since 1.1