SolidWorksMakroprogrammierung

Eigenschaft · ModelDocExtension

NeedsRebuild2-Eigenschaft (ModelDocExtension)

Liefert, ob das Dokument neu aufgebaut werden muss.

Syntax

Property NeedsRebuild2 As Long    ' nur lesen
nStatus = swModel.Extension.NeedsRebuild2

Wert

Der Zustand als Wert aus swModelRebuildStatus_e:

  • swModelRebuildStatus_FullyRebuilt (0): alles aktuell, kein Neuaufbau nötig
  • swModelRebuildStatus_NonFrozenFeatureNeedsRebuild (1): Features müssen neu aufgebaut werden
  • swModelRebuildStatus_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 Sub

Bemerkungen

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.