ProgressBar.Increment(Int32) ProgressBar.Increment(Int32) ProgressBar.Increment(Int32) ProgressBar.Increment(Int32) Method

Definizione

Consente di avanzare la posizione corrente dell'indicatore di stato in base al valore specificato.Advances the current position of the progress bar by the specified amount.

public:
 void Increment(int value);
public void Increment (int value);
member this.Increment : int -> unit
Public Sub Increment (value As Integer)

Parametri

value
Int32 Int32 Int32 Int32

Valore di incremento della posizione corrente dell'indicatore di stato.The amount by which to increment the progress bar's current position.

Eccezioni

Esempi

Nell'esempio di codice riportato di seguito viene illustrato Increment come utilizzare il Value metodo e la proprietà per incrementare ProgressBar il Tick valore di un oggetto Timernell'evento di un oggetto.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. Nell'esempio viene inoltre visualizzata Value la proprietà in StatusBarPanel un oggetto per fornire ProgressBaruna rappresentazione testuale di.The example also displays the Value property in a StatusBarPanel to provide a textual representation of the ProgressBar. Per questo esempio è necessario disporre di ProgressBar un controllo, progressBar1denominato, e StatusBar di un controllo che StatusBarPanelcontiene un statusBarPanel1oggetto, denominato.This example requires that you have a ProgressBar control, named progressBar1, and a StatusBar control that contains a StatusBarPanel, named statusBarPanel1. L' Timeroggetto, timedenominato, deve essere aggiunto al form come membro.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();
   }
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

Commenti

Il Increment metodo consente di incrementare il valore dell'indicatore di stato in base a un importo specifico.The Increment method enables you to increment the value of the progress bar by a specific amount. Questo metodo di incremento dell'indicatore di stato è simile all'utilizzo della Step proprietà con il PerformStep metodo.This method of incrementing the progress bar is similar to using the Step property with the PerformStep method. La Value proprietà specifica la posizione corrente dell'oggetto ProgressBar.The Value property specifies the current position of the ProgressBar. Se, dopo aver chiamato Increment il metodo, Value la proprietà è maggiore del valore della Maximum proprietà, Maximum la Value proprietà rimane in corrispondenza del valore della proprietà.If, after calling the Increment method, the Value property is greater than the value of the Maximum property, the Value property remains at the value of the Maximum property. Se, dopo aver chiamato Increment il metodo con un valore negativo specificato value nel parametro, la Value Minimum proprietà è minore del valore della proprietà, la Value proprietà rimane in corrispondenza del valore di Minimumproprietà.If, after calling the Increment method with a negative value specified in the value parameter, the Value property is less than the value of the Minimum property, the Value property remains at the value of the Minimum property.

Poiché un ProgressBar oggetto il cui stile è impostato in modo da visualizzare una barra di scorrimento continua Valueanziché il Increment relativo, la chiamata a Marquee non InvalidOperationExceptionè necessaria e genererà un.Because a ProgressBar object whose style is set to Marquee displays a continuously scrolling bar instead of its Value, calling Increment is unnecessary and will raise an InvalidOperationException.

Si applica a

Vedi anche