ProgressBar.Increment(Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wechselt die aktuelle Position der Statusanzeige um den angegebenen Betrag.
public:
void Increment(int value);public void Increment(int value);member this.Increment : int -> unitPublic Sub Increment (value As Integer)Parameter
- value
- Int32
Der Betrag, um den die aktuelle Position der Statusanzeige erhöht werden soll.
Ausnahmen
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die Increment Methode und die Value Eigenschaft verwendet werden, um den Wert eines ProgressBar Inkrements für ein Tick Ereignis Timerzu erhöhen. Das Beispiel zeigt auch die Value Eigenschaft in einer StatusBarPanel , um eine textbezogene Darstellung der ProgressBar. In diesem Beispiel müssen Sie über ein ProgressBar Steuerelement, einen Namen progressBar1und ein StatusBar Steuerelement verfügen, das einen StatusBarPanel, benannten Namen statusBarPanel1enthält. Der TimerBenannte timemuss dem Formular als Mitglied hinzugefügt werden.
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();
}
private Timer time = new Timer();
// Call this method from the constructor of the form.
private void InitializeMyTimer()
{
// Set the interval for the timer.
time.Interval = 250;
// Connect the Tick event of the timer to its event handler.
time.Tick += new EventHandler(IncreaseProgressBar);
// Start the timer.
time.Start();
}
private 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 = progressBar1.Value.ToString() + "% 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();
}
Private time As New Timer()
' Call this method from the constructor of the form.
Private Sub InitializeMyTimer()
' Set the interval for the timer.
time.Interval = 250
' Connect the Tick event of the timer to its event handler.
AddHandler time.Tick, AddressOf IncreaseProgressBar
' Start the timer.
time.Start()
End Sub
Private Sub IncreaseProgressBar(ByVal sender As Object, ByVal e As EventArgs)
' 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 = ProgressBar1.Value.ToString() + "% Completed"
' Determine if we have completed by comparing the value of the Value property to the Maximum value.
If ProgressBar1.Value = ProgressBar1.Maximum Then
' Stop the timer.
time.Stop()
End If
End Sub
Hinweise
Mit der Increment Methode können Sie den Wert der Statusleiste um einen bestimmten Betrag erhöhen. Diese Methode zum Erhöhen der Statusanzeige ähnelt der Verwendung der Step Eigenschaft mit der PerformStep Methode. Die Value Eigenschaft gibt die aktuelle Position der ProgressBar. Wenn die Value Eigenschaft nach dem Aufrufen der Increment Methode größer als der Wert der Maximum Eigenschaft ist, verbleibt die Value Eigenschaft am Wert der Maximum Eigenschaft. Wenn die Methode nach dem Aufrufen der Increment Methode mit einem negativen Wert, der value im Parameter angegeben ist, Value kleiner als der Wert der Minimum Eigenschaft ist, verbleibt die Value Eigenschaft am Wert der Minimum Eigenschaft.
Da ein ProgressBar Objekt, dessen Format so festgelegt Marquee ist, dass eine fortlaufende Bildlaufleiste anstelle des ValueObjekts angezeigt wird, ist das Aufrufen Increment unnötig und löst eine InvalidOperationException.
