TaskbarItemInfo.ProgressState Eigenschaft

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

Eigenschaftswert

Ein Enumerationswert, der angibt, wie die Statusanzeige in der Taskleistenschaltfläche angezeigt wird. Der Standardwert lautet None.

Beispiele

Das folgende Beispiel zeigt, wie die ProgressState Eigenschaft im Code festgelegt wird. Der Zustand wird im Handler eines BackgroundWorker.RunWorkerCompleted Ereignisses festgelegt, um anzugeben, ob die Hintergrundaufgabe vom Benutzer beendet, mit einem Fehler beendet oder normal abgeschlossen wurde. Dieses Beispiel ist Teil eines größeren Beispiels, das für die TaskbarItemInfo Klasse bereitgestellt wird.

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)
    {
        // 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

Hinweise

Sie können den Fortschritt langer Ausgeführter Aufgaben kommunizieren, indem Sie eine Statusanzeige in einer Windows 7-Taskleistenschaltfläche anzeigen. Die Farbe des Indikators wird durch die ProgressState Eigenschaft bestimmt, die einen der TaskbarItemProgressState Enumerationswerte enthält. Wenn dies ProgressState der Wert ist Normal, ist der Indikator grün. Wenn Pausedder Indikator gelb ist. Wenn Error, ist der Indikator rot. Für diese Zustände bestimmt die ProgressValue Eigenschaft, wie viel der Taskleistenschaltfläche durch die Statusanzeige gefüllt wird. ProgressValue wird für andere Werte von ProgressState. Indeterminate zeigt einen pulsierenden grünen Indikator über die gesamte Taskleistenschaltfläche an. Es wird kein Indikator für None.

Die folgende Abbildung zeigt die Statusanzeige der Taskleiste im Normal Zustand.

zu Statusanzeige der Windows-Taskleiste