SolidWorksMakroprogrammierung

Methode · ModelDoc2

ForceRebuild3-Methode (ModelDoc2)

Baut alle Features der aktiven Konfiguration neu auf, auch die, die sich nicht geändert haben (wie Strg+Q).

Syntax

Function ForceRebuild3( _
   ByVal TopOnly As Boolean _
) As Boolean
bErfolg = swModel.ForceRebuild3(False)

Parameter

TopOnlyBooleanByVal
Nur für Baugruppen von Bedeutung. True baut nur die Baugruppe selbst neu auf, False auch alle Unterbaugruppen.

Rückgabewert

True, wenn alle Features neu aufgebaut wurden, sonst False.

Beispiel

' Baut das aktive Dokument mit allen Unterbaugruppen komplett neu auf.
' Vorbedingung: Ein Teil oder eine Baugruppe ist geöffnet.
' Ergebnis:     Meldung, ob der Neuaufbau geklappt hat, und wie lange er gedauert hat.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim dStart As Double

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    dStart = Timer
    If swModel.ForceRebuild3(False) Then
        swApp.SendMsgToUser2 "Neu aufgebaut in " & Format(Timer - dStart, "0.0") & " s.", swMbInformation, swMbOk
    Else
        swApp.SendMsgToUser2 "Neuaufbau nicht vollständig, bitte Fehler im FeatureManager prüfen.", swMbWarning, swMbOk
    End If
End Sub

Bemerkungen

ForceRebuild3 entspricht Strg+Q in SOLIDWORKS: Jedes Feature wird neu berechnet. Das dauert bei großen Modellen spürbar. ModelDoc2.EditRebuild3 entspricht Strg+B und baut nur auf, was sich geändert hat. Nach einer Maßänderung reicht das fast immer.

ForceRebuild3 baut nur die aktive Konfiguration neu auf. Für alle Konfigurationen gibt es ModelDocExtension.ForceRebuildAll, oder du schaltest mit ModelDoc2.ShowConfiguration2 nacheinander durch. Ein Beispiel dafür steht dort.

Siehe auch

In den Videos

Verfügbarkeit

SOLIDWORKS 2001Plus

Englisches Original: IModelDoc2::ForceRebuild3 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.