ProgressBar.Increment(Int32) Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Posune aktuální pozici indikátoru průběhu o zadanou hodnotu.

public:
 void Increment(int value);

public void Increment (int value);

member this.Increment : int -> unit

Public Sub Increment (value As Integer)

Parametry

value: Int32

Částka, o kterou chcete zvýšit aktuální pozici indikátoru průběhu.

Výjimky

InvalidOperationException

Vlastnost Style je nastavena na hodnotu Marquee

Příklady

Následující příklad kódu ukazuje, jak použít metodu Increment Value a vlastnost ke zvýšení hodnoty objektu ProgressBar Tick v případě Timer. V příkladu Value se také zobrazí vlastnost v objektu , která StatusBarPanel poskytuje textové vyjádření objektu ProgressBar. Tento příklad vyžaduje, abyste měli ProgressBar ovládací prvek s názvem progressBar1a StatusBar ovládací prvek, který obsahuje StatusBarPanel, s názvem statusBarPanel1. Soubor Timers názvem timemusí být přidán do formuláře jako člen.

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

Poznámky

Metoda Increment umožňuje zvýšit hodnotu indikátoru průběhu o určitou hodnotu. Tato metoda zvýšení indikátoru průběhu je podobná použití Step vlastnosti s metodou PerformStep . Vlastnost Value určuje aktuální pozici objektu ProgressBar. Pokud je po volání Increment metody Value vlastnost větší než hodnota Maximum vlastnosti , Value vlastnost zůstane na hodnotě Maximum vlastnosti . Pokud je po volání Increment metody se zápornou hodnotou zadanou v parametru Valuevalue vlastnost menší než hodnota Minimum vlastnosti , Value vlastnost zůstane na hodnotě Minimum vlastnosti .

Vzhledem k tomu, že objekt, ProgressBar jehož styl je nastavený na Marquee , zobrazuje místo objektu Valuenepřetržitý posuvník , je volání Increment zbytečné a vyvolá .InvalidOperationException

Platí pro

Sdílet prostřednictvím