TaskbarItemInfo.ProgressValue Vlastnost

Definice

Obor názvů:

System.Windows.Shell

Sestavení:

PresentationFramework.dll

Získá nebo nastaví hodnotu, která označuje plnost indikátoru průběhu na hlavním panelu tlačítko.

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

Hodnota vlastnosti

Double

Hodnota, která označuje plné znění indikátoru průběhu na tlačítku hlavního panelu. Výchozí hodnota je 0.

Příklady

Následující příklad ukazuje, jak nastavit ProgressValue vlastnost v kódu. Hodnota je nastavena v obslužné rutině BackgroundWorker.ProgressChanged události, která označuje aktuální průběh úlohy na pozadí. Tento příklad je součástí většího příkladu poskytnutého TaskbarItemInfo pro třídu.

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

Poznámky

Vlastnost ProgressValue je reprezentována jako hodnota mezi 0,0 a 1,0. Čísla menší a větší jsou v těchto mezích přetěžována. NaN je přetěžován na 0.

Průběh dlouhotrvajících úkolů můžete sdělit zobrazením indikátoru průběhu na tlačítku hlavního panelu Windows 7. Barva ukazatele je určena ProgressState vlastností, která obsahuje jednu z hodnot výčtu TaskbarItemProgressState . ProgressState Pokud je Normalvlastnost , Pausednebo Error, ProgressValue vlastnost určuje plnou hodnotu indikátoru průběhu. ProgressValue je ignorován pro některé hodnoty ProgressState. Indeterminate zobrazuje pulzující zelený indikátor na celém tlačítku hlavního panelu. Není zobrazen žádný ukazatel pro None.

Následující obrázek znázorňuje indikátor průběhu hlavního panelu s 82 procenty ProgressValue .

Indikátor průběhu hlavního panelu Windows