ProgressBar.Increment(Int32) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Avanza la posición actual de la barra de progreso en la cantidad especificada.

public:
 void Increment(int value);

public void Increment (int value);

member this.Increment : int -> unit

Public Sub Increment (value As Integer)

Parámetros

value

Int32

Cantidad que se incrementa la posición actual de la barra de progreso.

Excepciones

InvalidOperationException

La propiedad Style está establecida en Marquee.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el Increment método y la Value propiedad para incrementar el valor de en ProgressBar el Tick caso de .Timer En el ejemplo también se muestra la Value propiedad en para StatusBarPanel proporcionar una representación textual de ProgressBar. En este ejemplo se requiere que tenga un ProgressBar control, denominado progressBar1, y un StatusBar control que contenga un StatusBarPanel, denominado statusBarPanel1. El Timer, denominado time, se debe agregar al formulario como miembro.

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

Comentarios

El Increment método permite incrementar el valor de la barra de progreso en una cantidad específica. Este método para incrementar la barra de progreso es similar al uso de la Step propiedad con el PerformStep método . La Value propiedad especifica la posición actual de .ProgressBar Si, después de llamar al Increment método , la Value propiedad es mayor que el valor de la Maximum propiedad , la Value propiedad permanece en el valor de la Maximum propiedad . Si, después de llamar al Increment método con un valor negativo especificado en el value parámetro , la Value propiedad es menor que el valor de la Minimum propiedad , la Value propiedad permanece en el valor de la Minimum propiedad .

Dado que un ProgressBar objeto cuyo estilo se establece en Marquee muestra una barra de desplazamiento continua en lugar de su Value, la llamada a Increment no es necesaria y generará una InvalidOperationExceptionexcepción .

Consulte también

• Maximum
• Minimum
• Value
• Step
• PerformStep()