ProgressBar.Value Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ProgressBar.cs

Získá nebo nastaví aktuální pozici indikátoru průběhu.

public:
 property int Value { int get(); void set(int value); };

[System.ComponentModel.Bindable(true)]
public int Value { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.Value : int with get, set

Public Property Value As Integer

Hodnota vlastnosti

Int32

Pozice v rozsahu indikátoru průběhu. Výchozí hodnota je 0.

Atributy

BindableAttribute

Výjimky

ArgumentException

Zadaná hodnota je větší než hodnota Maximum vlastnosti.

nebo

Zadaná hodnota je menší než hodnota Minimum vlastnosti.

Příklady

Následující příklad kódu ukazuje, jak použít metodu IncrementValue a vlastnost zvýšit hodnotu v ProgressBarTick případě události Timer. Příklad také zobrazí Value vlastnost v objektu StatusBarPanel pro poskytnutí textové reprezentace objektu ProgressBar. Tento příklad vyžaduje, abyste měli ProgressBar ovládací prvek s názvem progressBar1a StatusBar ovládací prvek, který obsahuje pojmenovaný StatusBarPanelstatusBarPanel1. Název Timer, 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

Minimální a maximální hodnoty Value vlastnosti jsou určeny vlastnostmi Minimum a Maximum vlastnostmi. Tato vlastnost umožňuje zvýšit nebo zrušit hodnotu indikátoru průběhu přímo. Chcete-li provést konzistentní zvýšení hodnoty ProgressBar ovládacího prvku, můžete použít Step vlastnost s metodou PerformStep . Pokud chcete zvýšit hodnotu indikátoru průběhu různými částkami, použijte metodu Increment .

Viz také

• Maximum
• Minimum