TaskbarItemInfo.ProgressState Propriété

Définition

Espace de noms:

System.Windows.Shell

Assembly:

PresentationFramework.dll

Obtient ou définit une valeur qui indique comment l'indicateur de progression est affiché dans le bouton de la barre des tâches.

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

Valeur de propriété

TaskbarItemProgressState

Valeur d'énumération qui indique comment l'indicateur de progression est affiché dans le bouton de la barre des tâches. La valeur par défaut est None.

Exemples

L'exemple suivant montre comment définir la propriété ProgressState dans le code. L’état est défini dans le gestionnaire d’un BackgroundWorker.RunWorkerCompleted événement pour indiquer si la tâche en arrière-plan a été arrêtée par l’utilisateur, terminée par une erreur ou terminée normalement. Cet exemple fait partie d’un exemple plus grand fourni pour la TaskbarItemInfo classe .

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

Remarques

Vous pouvez communiquer la progression des tâches de longue durée en affichant un indicateur de progression dans un bouton de barre des tâches Windows 7. La couleur de l’indicateur est déterminée par la ProgressState propriété, qui contient l’une des valeurs d’énumération TaskbarItemProgressState . Lorsque a la ProgressState valeur Normal, l’indicateur est vert. Quand Paused, l’indicateur est jaune. Quand Error, l’indicateur est rouge. Pour ces états, la propriété détermine la ProgressValue quantité de bouton de la barre des tâches remplie par l’indicateur de progression. ProgressValue est ignoré pour les autres valeurs de ProgressState. Indeterminate affiche un indicateur vert pulsant sur l’ensemble du bouton de la barre des tâches. Aucun indicateur n’est affiché pour None.

L’illustration suivante montre l’indicateur de progression de la barre des tâches dans l’état Normal .

Indicateur de progression de la barre des tâches Windows