Eigenschaft · ModelDocExtension
NeedsRebuild2-Eigenschaft (ModelDocExtension)
Liefert, ob das Dokument neu aufgebaut werden muss.
Syntax
Property NeedsRebuild2 As Long ' nur lesennStatus = swModel.Extension.NeedsRebuild2Wert
Der Zustand als Wert aus swModelRebuildStatus_e:
swModelRebuildStatus_FullyRebuilt(0): alles aktuell, kein Neuaufbau nötigswModelRebuildStatus_NonFrozenFeatureNeedsRebuild(1): Features müssen neu aufgebaut werdenswModelRebuildStatus_FrozenFeatureNeedsRebuild(2): nur eingefrorene Features oberhalb der Einfrieren-Leiste müssten neu aufgebaut werden
Beispiel
' Baut das aktive Dokument nur neu auf, wenn es nötig ist, und meldet das Ergebnis.
' Vorbedingung: Ein Teil oder eine Baugruppe ist geöffnet.
' Ergebnis: Meldung, ob neu aufgebaut wurde.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.Extension.NeedsRebuild2 = swModelRebuildStatus_NonFrozenFeatureNeedsRebuild Then
swModel.EditRebuild3
swApp.SendMsgToUser2 "Neu aufgebaut.", swMbInformation, swMbOk
Else
swApp.SendMsgToUser2 "Kein Neuaufbau nötig.", swMbInformation, swMbOk
End If
End SubBemerkungen
Ein Neuaufbau kostet bei großen Modellen Zeit. Mit NeedsRebuild2 spart sich ein Makro den Aufruf von ModelDoc2.EditRebuild3, wenn ohnehin alles aktuell ist, etwa vor dem Speichern oder Exportieren vieler Dateien.
Eingefrorene Features liegen oberhalb der Einfrieren-Leiste im FeatureManager. SOLIDWORKS baut sie beim normalen Neuaufbau absichtlich nicht neu auf. Den Wert 2 lässt das Beispiel deshalb unberücksichtigt.
Der Vorgänger ModelDocExtension.NeedsRebuild ist veraltet.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2012
Englisches Original: IModelDocExtension::NeedsRebuild2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.