TaskbarItemInfo.ProgressValue Özellik

Tanım

Ad Alanı:

System.Windows.Shell

Bütünleştirilmiş Kod:

PresentationFramework.dll

Görev çubuğu düğmesindeki ilerleme göstergesinin doluluğunu belirten bir değer alır veya ayarlar.

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

Özellik Değeri

Double

Görev çubuğu düğmesindeki ilerleme göstergesinin doluluğunu gösteren değer. Varsayılan değer, 0'dur.

Örnekler

Aşağıdaki örnekte kodda özelliğinin ProgressValue nasıl ayarlanacağı gösterilmektedir. Değer, arka plan görevinin geçerli ilerleme durumunu göstermek için bir BackgroundWorker.ProgressChanged olayın işleyicisinde ayarlanır. Bu örnek, sınıfı için TaskbarItemInfo sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

ProgressValue özelliği 0,0 ile 1,0 arasında bir değer olarak temsil edilir. Küçük ve büyük sayılar bu sınırların içinde olacak şekilde zorunlu olur. NaN 0'a kadar zorunludur.

Windows 7 görev çubuğu düğmesinde ilerleme göstergesini görüntüleyerek uzun süre çalışan görevlerin ilerleme durumunu iletebilirsiniz. Göstergenin rengi, numaralandırma değerlerinden birini TaskbarItemProgressState içeren özelliği tarafından ProgressState belirlenir. ProgressState özelliği Normal, Pausedveya ErrorProgressValue ise, ilerleme göstergesinin tamlığını özelliği belirler. ProgressValue bazı değerleri ProgressStateiçin yoksayılır. Indeterminate görev çubuğu düğmesinin tamamında titreşen yeşil bir gösterge gösterir. için Nonegösterge gösterilmez.

Aşağıdaki çizimde yüzde 82'lik görev ProgressValue çubuğu ilerleme göstergesi gösterilmektedir.

Windows Görev Çubuğu İlerleme Göstergesi