SolidWorksMakroprogrammierung

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 Long
nStatus = 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.End

Bemerkungen

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.