TaskbarItemInfo.ProgressValue Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft dat de voortgangsindicator volledig is op de taakbalkknop.
public:
property double ProgressValue { double get(); void set(double value); };public double ProgressValue { get; set; }member this.ProgressValue : double with get, setPublic Property ProgressValue As DoubleWaarde van eigenschap
Een waarde die aangeeft dat de voortgangsindicator volledig is op de taakbalkknop. De standaardwaarde is 0.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de ProgressValue eigenschap instelt in code. De waarde wordt ingesteld in de handler van een BackgroundWorker.ProgressChanged gebeurtenis om de huidige voortgang van de achtergrondtaak aan te geven. Dit voorbeeld maakt deel uit van een groter voorbeeld voor de TaskbarItemInfo klasse.
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
Opmerkingen
De ProgressValue eigenschap wordt weergegeven als een waarde tussen 0,0 en 1,0. Getallen die kleiner en groter zijn, moeten binnen die grenzen liggen. NaN wordt afgetrokken van 0.
U kunt de voortgang van langlopende taken doorgeven door een voortgangsindicator weer te geven in een Windows 7 taakbalkknop. De kleur van de indicator wordt bepaald door de ProgressState eigenschap, die een van de TaskbarItemProgressState opsommingswaarden bevat. Als de ProgressState eigenschap Normal, Pausedof Error, de ProgressValue eigenschap bepaalt de volheid van de voortgangsindicator. ProgressValue wordt genegeerd voor sommige waarden van ProgressState. Indeterminate toont een knipperende groene indicator op de hele taakbalkknop. Er wordt geen indicator weergegeven voor None.
In de volgende afbeelding ziet u de voortgangsindicator van de taakbalk met een ProgressValue percentage van 82 procent.
Windows Taskbar Progress Indicator
