TaskbarItemInfo.ProgressState Eigenschap

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

Waarde van eigenschap

Een opsommingswaarde die aangeeft hoe de voortgangsindicator wordt weergegeven in de taakbalkknop. De standaardwaarde is None.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de ProgressState eigenschap instelt in code. De status wordt ingesteld in de handler van een BackgroundWorker.RunWorkerCompleted gebeurtenis om aan te geven of de achtergrondtaak door de gebruiker is gestopt, is beëindigd met een fout of normaal is voltooid. Dit voorbeeld maakt deel uit van een groter voorbeeld voor de TaskbarItemInfo klasse.

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

Opmerkingen

U kunt de voortgang van langlopende taken doorgeven door een voortgangsindicator weer te geven in een Windows 7 taakbalkknop. De kleur van de indicator wordt bepaald door de ProgressState eigenschap, die een van de TaskbarItemProgressState opsommingswaarden bevat. Wanneer dit ProgressState het is Normal, is de indicator groen. Wanneer Paused, is de indicator geel. Wanneer Error, is de indicator rood. Voor deze statussen bepaalt de ProgressValue eigenschap hoeveel van de taakbalkknop wordt ingevuld door de voortgangsindicator. ProgressValue wordt genegeerd voor andere waarden van ProgressState. Indeterminate toont een knipperende groene indicator op de hele taakbalkknop. Er wordt geen indicator weergegeven voor None.

In de volgende afbeelding ziet u de voortgangsindicator van de taakbalk in de Normal status.

Windows Taskbar Progress Indicator