TaskbarItemInfo.ProgressValue Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Shell
Assembly:
PresentationFramework.dll

Ottiene o imposta un valore che indica il riempimento 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 il riempimento dell'indicatore di stato nel pulsante della barra delle applicazioni. Il valore predefinito è 0.

Esempio

Nell'esempio riportato di seguito viene illustrato come impostare la proprietà ProgressValue nel codice. Il valore viene impostato nel gestore di un BackgroundWorker.ProgressChanged evento per indicare lo stato corrente dell'attività in background. Questo esempio fa parte di un esempio più grande 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 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 ProgressState è determinato dalla proprietà, che contiene uno dei valori di TaskbarItemProgressState enumerazione. Se la proprietà è Normal, Pausedo Error, la ProgressValueProgressState proprietà determina la piena dell'indicatore di stato. ProgressValue viene ignorato per alcuni valori di ProgressState. Indeterminate mostra un indicatore verde pulsante sull'intera barra delle applicazioni. Non viene visualizzato alcun indicatore per None.

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

Esempio di informazioni sull'elemento della barra delle applicazioni dell'elemento della barra delle
Indicatore di stato della barra delle applicazioni di Windows

Si applica a