TaskbarItemInfo.ProgressState Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Shell

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, wie die Statusanzeige in der Taskleistenschaltfläche angezeigt wird, oder legt ihn fest.

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

TaskbarItemProgressState

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die ProgressState-Eigenschaft im Code festlegen. Der Status 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 von Aufgaben mit langer Ausführungszeit 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 der ProgressState ist Normal, ist der Indikator grün. Wenn Paused, ist der Indikator gelb. Wenn Error, ist der Indikator rot. Für diese Zustände bestimmt die ProgressValue -Eigenschaft, wie viel der Taskleistenschaltfläche vom Statusindikator gefüllt wird. ProgressValue wird für andere Werte von ProgressStateignoriert. Indeterminate zeigt einen pulsierenden grünen Indikator über die gesamte Taskleistenschaltfläche an. Für Nonewird kein Indikator angezeigt.

Die folgende Abbildung zeigt den Statusindikator für den Status der Normal Taskleiste.

Beispiel für Taskleistenelementinformationen: Beispiel für
Statusanzeige der Windows-Taskleiste

Gilt für:

Freigeben über