TaskbarItemInfo.ProgressState Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Shell

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia wartość wskazującą sposób wyświetlania wskaźnika postępu na przycisku paska zadań.

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

Wartość właściwości

TaskbarItemProgressState

Wartość wyliczenia wskazująca sposób wyświetlania wskaźnika postępu w przycisku paska zadań. Wartość domyślna to None.

Przykłady

W poniższym przykładzie pokazano, jak ustawić ProgressState właściwość w kodzie. Stan jest ustawiany w procedurze obsługi BackgroundWorker.RunWorkerCompleted zdarzenia, aby wskazać, czy zadanie w tle zostało zatrzymane przez użytkownika, zakończone błędem lub ukończone normalnie. Ten przykład jest częścią większego przykładu udostępnionego TaskbarItemInfo dla klasy.

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

Uwagi

Postęp długotrwałych zadań można przekazać, wyświetlając wskaźnik postępu na pasku zadań systemu Windows 7. Kolor wskaźnika jest określany przez ProgressState właściwość, która zawiera jedną z TaskbarItemProgressState wartości wyliczenia. Gdy wartość ProgressState to Normal, wskaźnik jest zielony. Gdy Pausedwskaźnik jest żółty. Gdy Errorwskaźnik jest czerwony. Dla tych stanów ProgressValue właściwość określa, ile przycisku paska zadań jest wypełniany przez wskaźnik postępu. ProgressValuejest ignorowany dla innych wartości .ProgressState Indeterminate wyświetla pulsujący zielony wskaźnik na całym przycisku paska zadań. Dla funkcji nie jest wyświetlany Noneżaden wskaźnik .

Na poniższej ilustracji przedstawiono wskaźnik postępu paska zadań w Normal stanie.

elementu
Wskaźnik postępu paska zadań systemu Windows