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 plnost indikátoru průběhu na tlačítku na hlavním 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 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 vymyšlená tak, aby byla v těchto mezích. NaN je přisouzeno k 0.

Průběh dlouhotrvajících úkolů můžete sdělit zobrazením indikátoru průběhu na tlačítku na hlavním 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 určuje vlastnost plnost ukazatele průběhu. ProgressValue u některých hodnot ProgressStateje ignorován. Indeterminate zobrazuje pulzující zelený indikátor na celém tlačítku na hlavním panelu. Pro Nonese nezobrazuje žádný indikátor .

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

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