Methode · UserProgressBar
UpdateProgress-Methode (UserProgressBar)
Setzt den Stand der Fortschrittsanzeige und meldet, ob der Benutzer mit Esc abgebrochen hat.
Syntax
Function UpdateProgress( _
ByVal Position As Long _
) As LongnStatus = swFortschritt.UpdateProgress(nStand)Parameter
PositionLongByVal- Der neue Stand, innerhalb des Bereichs aus
UserProgressBar.Start.
Rückgabewert
Ein Wert aus swUpdateProgressError_e: swUpdateProgressError_Success, …_UserCancel (Esc gedrückt), …_OutOfBounds, …_NotInitialized oder …_UnknownError.
Beispiel
' swFortschritt ist eine Fortschrittsanzeige (UserProgressBar), mit Start(0, 100, ...) gestartet.
Dim i As Long
For i = 1 To 100
' ... ein Arbeitsschritt ...
If swFortschritt.UpdateProgress(i) = swUpdateProgressError_UserCancel Then
MsgBox "Abgebrochen", vbInformation
Exit For
End If
Next i
swFortschritt.EndBemerkungen
Die Hilfe beschreibt die Methode als „erhöht die Anzeige“, der Parameter ist aber der neue Stand, kein Schritt. Das Hilfebeispiel zählt den Stand selbst in Zehnerschritten hoch und übergibt ihn. Liefert die Methode 2 (swUpdateProgressError_UserCancel), zeigt das Beispiel eine Meldung und ruft UserProgressBar.End auf. Was swUpdateProgressError_OutOfBounds und …_NotInitialized genau auslöst, sagt die Hilfe nicht, vermutlich ein Stand außerhalb des Bereichs und ein fehlendes Start.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2007
Englisches Original: IUserProgressBar::UpdateProgress in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.