SolidWorksMakroprogrammierung

Objekt · SldWorks

Body-Objekt

Veraltetes Objekt für einen Körper. An seine Stelle tritt Body2, das fast alle Befehle unter demselben Namen hat.

Deklaration Dim x As SldWorks.Body · in der englischen .NET-Hilfe: IBody

Beschreibung

Body ist veraltet und durch Body2 ersetzt. Für jeden Befehl nennt die Hilfe einen Nachfolger an Body2, meist unter demselben Namen. In neuen Makros nimmst du deshalb Body2.

Zugriff

  • EnumBodies.Next: der nächste Körper einer Aufzählung (veraltet)
  • C++-Varianten wie IGetBody an Face, Feature und Component sowie viele I…-Methoden von Modeler und PartDoc (veraltet)

In VBA liefern PartDoc.GetBodies2, Component2.GetBodies3 und Face2.GetBody einen Body2.

Beispiel

' Gibt für jeden Volumenkörper des aktiven Teils Namen, Zahl der Flächen und Kanten und die Ausmaße aus.
' Vorbedingung: Ein Teil mit mindestens einem Volumenkörper ist offen.
' Ergebnis:     Die Werte stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPart As SldWorks.PartDoc
    Dim vKoerper As Variant
    Dim swBody As SldWorks.Body2                          ' statt SldWorks.Body
    Dim vBox As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocPART Then Exit Sub
    Set swPart = swModel

    vKoerper = swPart.GetBodies2(swSolidBody, True)
    If Not IsArray(vKoerper) Then Exit Sub
    For i = 0 To UBound(vKoerper)
        Set swBody = vKoerper(i)
        Debug.Print swBody.Name
        Debug.Print "  Flächen: " & swBody.GetFaceCount & ", Kanten: " & swBody.GetEdgeCount
        vBox = swBody.GetBodyBox                              ' xmin, ymin, zmin, xmax, ymax, zmax
        Debug.Print "  Ausmaße: " & Format((vBox(3) - vBox(0)) * 1000, "0.0") & " x " & _
                    Format((vBox(4) - vBox(1)) * 1000, "0.0") & " x " & _
                    Format((vBox(5) - vBox(2)) * 1000, "0.0") & " mm"
    Next i
End Sub

Bemerkungen

Ersatz: 43 Befehle heißen an Body2 genauso, etwa Body2.GetFirstFace, Body2.GetBodyBox oder Body2.GetMassProperties. Bei den übrigen nimmst du diese Befehle:

Nachfolger der Nachfolger: Bei Copy, DeleteBlends, DeleteFaces, GetIntersectionEdges und MatchedBoolean nennt die Hilfe einen Befehl an Body2, der inzwischen selbst veraltet ist. Die Liste oben nennt den heute gültigen Befehl. Seine Parameter können sich vom alten Befehl unterscheiden, prüf sie auf der Seite des Befehls.

Umstellen: Meist reicht es, Variablen von SldWorks.Body auf SldWorks.Body2 umzustellen und die Befehle aus der Liste zu ersetzen. Alte Makros laufen oft noch: In SOLIDWORKS 2024 kennt die Typbibliothek SldWorks.Body weiterhin, ein Körper aus PartDoc.GetBodies2 ließ sich per Set einer Variablen vom Typ Body zuweisen, und Name und GetFaceCount lieferten dieselben Werte wie bei Body2.

Getestet: Das Beispiel lief in SOLIDWORKS 2024 an einem abgewickelten Blechteil aus 2 mm Blech. Es gab den Körper „Abwicklung“ mit 6 Flächen, 12 Kanten und den Ausmaßen 76,1 x 2,0 x 40,0 mm aus.

Eigenschaften und Methoden

Eigenschaften 2, davon 0 beschrieben, 2 veraltet

NameBeschreibung
MaterialPropertyValuesveraltet ersetzt durch Body2.MaterialPropertyValues2
Visibleveraltet ersetzt durch Body2.Visible

Methoden 62, davon 0 beschrieben, 62 veraltet

NameBeschreibung
AddProfileArcveraltet ersetzt durch Body2.AddProfileArc
AddProfileBsplineveraltet ersetzt durch Body2.AddProfileBspline
AddProfileLineveraltet ersetzt durch Body2.AddProfileLine
AddPropertyExtensionveraltet ersetzt durch Body2.AddPropertyExtension2
AddVertexPointveraltet ersetzt durch Body2.AddVertexPoint
Checkveraltet ersetzt durch Body2.Check3
Copyveraltet ersetzt durch Body2.Copy2
CreateBaseFeatureveraltet ersetzt durch Body2.CreateBaseFeature
CreateBlendSurfaceveraltet ersetzt durch Body2.CreateBlendSurface
CreateBodyFromFacesveraltet ersetzt durch Body2.CreateBodyFromFaces
CreateBodyFromSurfacesveraltet ersetzt durch Body2.CreateBodyFromSurfaces
CreateBoundedSurfaceveraltet ersetzt durch Body2.CreateBoundedSurface
CreateBsplineSurfaceveraltet ersetzt durch Body2.CreateBsplineSurface
CreateExtrusionSurfaceveraltet ersetzt durch Body2.CreateExtrusionSurface
CreateNewSurfaceveraltet ersetzt durch Body2.CreateNewSurface
CreateOffsetSurfaceveraltet ersetzt durch Body2.CreateOffsetSurface
CreatePlanarSurfaceveraltet ersetzt durch Body2.CreatePlanarSurface
CreateRevolutionSurfaceveraltet ersetzt durch Body2.CreateRevolutionSurface
CreateTempBodyFromSurfacesveraltet ersetzt durch Body2.CreateTempBodyFromSurfaces
CreateTrimmedSurfaceveraltet ersetzt durch Body2.CreateTrimmedSurface
DeleteBlendsveraltet ersetzt durch Body2.DeleteBlends3
DeleteBlends2veraltet ersetzt durch Body2.DeleteBlends3
DeleteFacesveraltet ersetzt durch Body2.DeleteFaces5
DeleteFaces2veraltet ersetzt durch Body2.DeleteFaces5
Displayveraltet ersetzt durch Body2.Display3
DisplayWireFrameXORveraltet ersetzt durch Body2.DisplayWireFrameXOR
DraftBodyveraltet ersetzt durch Body2.DraftBody2
EnumFacesveraltet ersetzt durch Body2.EnumFaces
GetBodyBoxveraltet ersetzt durch Body2.GetBodyBox
GetEdgeCountveraltet ersetzt durch Body2.GetEdgeCount
GetExcessBodyArrayveraltet ersetzt durch Body2.GetExcessBodyArray
GetExtremePointveraltet ersetzt durch Body2.GetExtremePoint
GetFaceCountveraltet ersetzt durch Body2.GetFaceCount
GetFirstFaceveraltet ersetzt durch Body2.GetFirstFace
GetFirstSelectedFaceveraltet ersetzt durch Body2.GetFirstSelectedFace
GetIgesErrorCodeveraltet ersetzt durch Body2.GetIgesErrorCode
GetIgesErrorCountveraltet ersetzt durch Body2.GetIgesErrorCount
GetIntersectionEdgesveraltet ersetzt durch Body2.GetIntersectionEdges2
GetMassPropertiesveraltet ersetzt durch Body2.GetMassProperties
GetMaterialIdNameveraltet ersetzt durch Body2.GetMaterialIdName2
GetMaterialUserNameveraltet ersetzt durch Body2.GetMaterialUserName2
GetNextSelectedFaceveraltet ersetzt durch Body2.GetNextSelectedFace
GetProcessedBodyveraltet ersetzt durch Body2.GetProcessedBody2
GetProcessedBodyWithSelFaceveraltet ersetzt durch Body2.GetProcessedBodyWithSelFace
GetPropertyExtensionveraltet ersetzt durch Body2.GetPropertyExtension2
GetSelectedFaceCountveraltet ersetzt durch Body2.GetSelectedFaceCount
GetSheetBodyveraltet ersetzt durch Body2.GetSheetBody
GetTessellationveraltet ersetzt durch Body2.GetTessellation
GetTypeveraltet ersetzt durch Body2.GetType
Hideveraltet ersetzt durch Body2.Hide
MatchedBooleanveraltet ersetzt durch Body2.MatchedBoolean4
Operationsveraltet ersetzt durch Body2.Operations2
Operations2veraltet ersetzt durch Body2.Operations2
RemoveFacesFromSheetveraltet ersetzt durch Body2.RemoveFacesFromSheet
RemoveRedundantTopologyveraltet ersetzt durch Body2.RemoveRedundantTopology
ResetPropertyExtensionveraltet ersetzt durch Body2.ResetPropertyExtension2
Saveveraltet ersetzt durch Body2.Save
SetCurrentSurfaceveraltet ersetzt durch Body2.SetCurrentSurface
SetIgesInfoveraltet ersetzt durch Body2.SetIgesInfo
SetMaterialIdNameveraltet ersetzt durch Body2.SetMaterialIdName2
SetMaterialUserNameveraltet ersetzt durch Body2.SetMaterialUserName2
SetXformveraltet ersetzt durch Body2.ApplyTransform

Nicht aufgeführt sind 56 C++-Varianten (Namen mit I davor, zum Beispiel IAddProfileArc). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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