ProgressBar.Value Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan atau mengatur posisi bilah kemajuan saat ini.

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

Nilai Properti

Int32

Posisi dalam rentang bilah kemajuan. Defaultnya adalah 0.

Atribut

BindableAttribute

Pengecualian

ArgumentException

Nilai yang ditentukan lebih besar dari nilai Maximum properti .

-atau-

Nilai yang ditentukan kurang dari nilai Minimum properti .

Contoh

Contoh kode berikut menunjukkan cara menggunakan Increment metode dan Value properti untuk menaikkan nilai jika ProgressBarTick terjadi Timer. Contoh ini juga menampilkan Value properti dalam StatusBarPanel untuk memberikan representasi tekstual dari ProgressBar. Contoh ini mengharuskan Anda memiliki ProgressBar kontrol, bernama progressBar1, dan StatusBar kontrol yang berisi StatusBarPanel, bernama statusBarPanel1. Timer, bernama time, harus ditambahkan ke formulir sebagai anggota.

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

Keterangan

Nilai minimum dan maksimum Value properti ditentukan oleh Minimum properti dan Maximum . Properti ini memungkinkan Anda untuk menaikkan atau mengurangi nilai bilah kemajuan secara langsung. Untuk melakukan peningkatan yang konsisten dalam nilai ProgressBar kontrol, Anda dapat menggunakan Step properti dengan PerformStep metode . Untuk meningkatkan nilai bilah kemajuan dengan jumlah yang bervariasi, gunakan Increment metode .

Lihat juga

• Maximum
• Minimum