TaskbarItemInfo.ProgressState Property

Definition

Obtient ou définit une valeur qui indique comment l'indicateur de progression est affiché dans le bouton de la barre des tâches.Gets or sets a value that indicates how the progress indicator is displayed in the taskbar button.

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

Property Value

TaskbarItemProgressState

Valeur d'énumération qui indique comment l'indicateur de progression est affiché dans le bouton de la barre des tâches.An enumeration value that indicates how the progress indicator is displayed in the taskbar button. Par défaut, il s’agit de None.The default is None.

Examples

L'exemple suivant montre comment définir la propriété ProgressState dans le code.The following example shows how to set the ProgressState property in code. L’État est défini dans le gestionnaire d’un événement BackgroundWorker.RunWorkerCompleted pour indiquer si la tâche en arrière-plan a été arrêtée par l’utilisateur, s’est terminée par une erreur ou s’est terminée normalement.The state is set in the handler of a BackgroundWorker.RunWorkerCompleted event to indicate whether the background task was stopped by the user, ended with an error, or completed normally. Cet exemple fait partie d’un exemple plus complet fourni pour la classe TaskbarItemInfo.This example is part of a larger example provided for the TaskbarItemInfo class.

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

Remarks

Vous pouvez communiquer la progression des tâches de longue durée en affichant un indicateur de progression dans un Windows 7Windows 7 bouton de la barre des tâches.You can communicate the progress of long-running tasks by displaying a progress indicator in a Windows 7Windows 7 taskbar button. La couleur de l’indicateur est déterminée par la propriété ProgressState, qui contient l’une des TaskbarItemProgressState valeurs d’énumération.The color of the indicator is determined by the ProgressState property, which contains one of the TaskbarItemProgressState enumeration values. Lorsque le ProgressState est Normal, l’indicateur est vert.When the ProgressState is Normal, the indicator is green. Lorsque Paused, l’indicateur est jaune.When Paused, the indicator is yellow. Lorsque Error, l’indicateur est rouge.When Error, the indicator is red. Pour ces États, la propriété ProgressValue détermine la quantité de bouton de la barre des tâches qui est remplie par l’indicateur de progression.For these states, the ProgressValue property determines how much of the taskbar button is filled by the progress indicator. ProgressValue est ignorée pour les autres valeurs de ProgressState.ProgressValue is ignored for other values of ProgressState. Indeterminate affiche un indicateur vert clignotant sur tout le bouton de la barre des tâches.Indeterminate shows a pulsing green indicator across the entire taskbar button. Aucun indicateur n’est affiché pour None.No indicator is shown for None.

L’illustration suivante montre l’indicateur de progression de la barre des tâches dans l’État Normal.The following illustration shows the taskbar progress indicator in the Normal state.

Exemple d’informations d’élément de barre des tâchesTaskbar Item Info Sample
Indicateur de progression de la barre des tâches WindowsWindows Taskbar Progress Indicator

Applies to