TaskbarItemInfo.ProgressState Özellik

Tanım

Ad Alanı:

System.Windows.Shell

Bütünleştirilmiş Kod:

PresentationFramework.dll

Görev çubuğu düğmesinde ilerleme göstergesinin nasıl görüntülendiğini gösteren bir değer alır veya ayarlar.

public:
 property System::Windows::Shell::TaskbarItemProgressState ProgressState { System::Windows::Shell::TaskbarItemProgressState get(); void set(System::Windows::Shell::TaskbarItemProgressState value); };

public System.Windows.Shell.TaskbarItemProgressState ProgressState { get; set; }

member this.ProgressState : System.Windows.Shell.TaskbarItemProgressState with get, set

Public Property ProgressState As TaskbarItemProgressState

Özellik Değeri

TaskbarItemProgressState

Görev çubuğu düğmesinde ilerleme göstergesinin nasıl görüntülendiğini gösteren bir numaralandırma değeri. Varsayılan değer: None.

Örnekler

Aşağıdaki örnekte kodda özelliğinin ProgressState nasıl ayarlanacağı gösterilmektedir. Durum, arka plan görevinin BackgroundWorker.RunWorkerCompleted kullanıcı tarafından durdurulduğunu, hatayla sona erdiğini veya normal şekilde tamamlandığını belirtmek için bir 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_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{
    // When the task ends, change the ProgressState and Overlay
    // of the taskbar item to indicate a stopped task.
    if (e.Cancelled == true)
    {
        // The task was stopped by the user. Show the progress indicator
        // in the paused state.
        this.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Paused;
    }
    else if (e.Error != null)
    {
        // The task ended with an error. Show the progress indicator
        // in the error state.
        this.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Error;
    }
    else
    {
        // The task completed normally. Remove the progress indicator.
        this.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.None;
    }
    // In all cases, show the 'Stopped' overlay.
    this.taskBarItemInfo1.Overlay = (DrawingImage)this.FindResource("StopImage");
}

Private Sub bw_RunWorkerCompleted(ByVal sender As Object, ByVal e As RunWorkerCompletedEventArgs)
    ' When the task ends, change the ProgressState and Overlay
    ' of the taskbar item to indicate a stopped task.
    If e.Cancelled = True Then
        ' The task was stopped by the user. Show the progress indicator
        ' in the paused state.
        Me.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Paused
    ElseIf e.Error IsNot Nothing Then
        ' The task ended with an error. Show the progress indicator
        ' in the error state.
        Me.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Error
    Else
        ' The task completed normally. Remove the progress indicator.
        Me.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.None
        ' In all cases, show the 'Stopped' overlay.
        Me.taskBarItemInfo1.Overlay = Me.FindResource("StopImage")
    End If
End Sub

Açıklamalar

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 olduğundaNormal, gösterge yeşildir. olduğunda Pausedgösterge sarıdır. olduğunda Errorgösterge kırmızıdır. Bu durumlar için, ProgressValue görev çubuğu düğmesinin ne kadarının ilerleme göstergesi tarafından doldurulduğunu özelliği belirler. ProgressValue diğer 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 görev çubuğu ilerleme durumu göstergesi gösterilmektedir Normal .

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