TaskbarItemInfo.ProgressValue Proprietà

Definizione

Spazio dei nomi:

System.Windows.Shell

Assembly:

PresentationFramework.dll

Ottiene o imposta un valore che indica l'interezza dell'indicatore di stato nel pulsante della barra delle applicazioni.

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

Valore della proprietà

Double

Valore che indica l'interezza dell'indicatore di stato nel pulsante della barra delle applicazioni. Il valore predefinito è 0.

Esempio

Nell'esempio seguente viene illustrato come impostare la ProgressValue proprietà nel codice. Il valore viene impostato nel gestore di un BackgroundWorker.ProgressChanged evento per indicare lo stato di avanzamento corrente dell'attività in background. Questo esempio fa parte di un esempio più ampio fornito per 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

Commenti

La ProgressValue proprietà è rappresentata come valore compreso tra 0,0 e 1,0. I numeri più piccoli e più grandi sono costretti a trovarsi all'interno di tali limiti. NaN è costretto a 0.

È possibile comunicare lo stato di avanzamento delle attività a esecuzione prolungata visualizzando un indicatore di stato in un pulsante della barra delle applicazioni di Windows 7. Il colore dell'indicatore è determinato dalla ProgressState proprietà , che contiene uno dei TaskbarItemProgressState valori di enumerazione . Se la ProgressState proprietà è Normal, Pausedo Error, la ProgressValue proprietà determina la completezza dell'indicatore di stato. ProgressValue viene ignorato per alcuni valori di ProgressState. Indeterminate mostra un indicatore verde pulsante sull'intero pulsante della barra delle applicazioni. Non viene visualizzato alcun indicatore per None.

La figura seguente mostra l'indicatore di stato della barra delle applicazioni con un valore ProgressValue pari all'82%.

della Indicatore di stato della barra delle applicazioni di Windows