TaskbarItemInfo.ProgressValue Properti

Definisi

Ruang nama:

System.Windows.Shell

Rakitan:

PresentationFramework.dll

Mendapatkan atau menetapkan nilai yang menunjukkan kelengkapan indikator kemajuan di tombol taskbar.

public:
 property double ProgressValue { double get(); void set(double value); };

public double ProgressValue { get; set; }

member this.ProgressValue : double with get, set

Public Property ProgressValue As Double

Nilai Properti

Double

Nilai yang menunjukkan kelengkapan indikator kemajuan di tombol taskbar. Defaultnya adalah 0.

Contoh

Contoh berikut menunjukkan cara mengatur properti ProgressValue dalam kode. Nilai diatur dalam penanganan BackgroundWorker.ProgressChanged peristiwa untuk menunjukkan kemajuan tugas latar belakang saat ini. Contoh ini adalah bagian dari contoh yang lebih besar yang disediakan untuk TaskbarItemInfo kelas .

void bw_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
    this.tbCount.Text = e.ProgressPercentage.ToString();
    // Update the value of the task bar progress indicator.
    this.taskBarItemInfo1.ProgressValue = (double)e.ProgressPercentage / 100;
}

Private Sub bw_ProgressChanged(ByVal sender As Object, ByVal e As ProgressChangedEventArgs)
    Me.tbCount.Text = e.ProgressPercentage.ToString()
    ' Update the value of the task bar progress indicator.
    Me.taskBarItemInfo1.ProgressValue = e.ProgressPercentage / 100
End Sub

Keterangan

Properti ProgressValue direpresentasikan sebagai nilai antara 0,0 dan 1,0. Angka yang lebih kecil dan lebih besar dipaksa untuk berada dalam batas-batas tersebut. NaN dipaksa ke 0.

Anda dapat mengomunikasikan kemajuan tugas yang berjalan lama dengan menampilkan indikator kemajuan di tombol taskbar Windows 7. Warna indikator ditentukan oleh ProgressState properti , yang berisi salah TaskbarItemProgressState satu nilai enumerasi. ProgressState Jika properti adalah Normal, Paused, atau Error, ProgressValue properti menentukan kelengkapan indikator kemajuan. ProgressValue diabaikan untuk beberapa nilai ProgressState. Indeterminate memperlihatkan indikator hijau ber denyut di seluruh tombol taskbar. Tidak ada indikator yang ditunjukkan untuk None.

Ilustrasi berikut menunjukkan indikator kemajuan taskbar dengan ProgressValue 82 persen.

Sampel Info
Indikator Kemajuan Bilah Tugas Windows