Partager via


TaskbarItemInfo.ProgressValue Propriété

Définition

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

public:
 property double ProgressValue { double get(); void set(double value); };
public double ProgressValue { get; set; }
member this.ProgressValue : double with get, set
Public Property ProgressValue As Double

Valeur de propriété

Valeur qui indique la plénitude de l'indicateur de progression dans le bouton de la barre des tâches. La valeur par défaut est 0.

Exemples

L'exemple suivant montre comment définir la propriété ProgressValue dans le code. La valeur est définie dans le gestionnaire d’un BackgroundWorker.ProgressChanged événement pour indiquer la progression actuelle de la tâche en arrière-plan. Cet exemple fait partie d’un exemple plus grand fourni pour la TaskbarItemInfo classe .

void bw_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
    this.tbCount.Text = e.ProgressPercentage.ToString();
    // Update the value of the task bar progress indicator.
    this.taskBarItemInfo1.ProgressValue = (double)e.ProgressPercentage / 100;
}
Private Sub bw_ProgressChanged(ByVal sender As Object, ByVal e As ProgressChangedEventArgs)
    Me.tbCount.Text = e.ProgressPercentage.ToString()
    ' Update the value of the task bar progress indicator.
    Me.taskBarItemInfo1.ProgressValue = e.ProgressPercentage / 100
End Sub

Remarques

La ProgressValue propriété est représentée sous la forme d’une valeur comprise entre 0,0 et 1,0. Les nombres plus petits et plus grands sont obligés de se trouver dans ces limites. NaN est de force à 0.

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 . Si la ProgressState propriété est Normal, Pausedou Error, la ProgressValue propriété détermine l’intégralité de l’indicateur de progression. ProgressValue est ignoré pour certaines 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 avec un ProgressValue de 82 %.

Exemple d’informations sur l’élément
Indicateur de progression de la barre des tâches Windows

S’applique à