SolidWorksMakroprogrammierung

Objekt · SldWorks

Body2-Objekt

Steht für einen Körper: Volumen-, Flächen- oder Drahtkörper, entweder Teil des Modells oder temporär nur im Speicher.

Deklaration Dim x As SldWorks.Body2 · in der englischen .NET-Hilfe: IBody2

Beschreibung

Es gibt zwei Arten von Körpern:

Zugriff

Beispiel

' swPart ist das PartDoc.
Dim vKoerper As Variant, vMasse As Variant
Dim i As Long
vKoerper = swPart.GetBodies2(swSolidBody, False)
If IsArray(vKoerper) Then
    For i = 0 To UBound(vKoerper)
        vMasse = vKoerper(i).GetMassProperties(1)
        Debug.Print vKoerper(i).Name & ": " & Format(vMasse(3) * 1000000000#, "0") & " mm³"
    Next i
End If

Bemerkungen

Alle Längen sind in Metern, Flächen in m², Volumen in m³. Das Beispiel rechnet deshalb mit 1000000000 in mm³ um. Die Dichte 1 spielt für das Volumen keine Rolle.

Arrays und Hilfsobjekte: Viele Befehle von Body2 und Modeler erwarten Punkte, Richtungen oder Maße als Array. Übergib sie als Double-Array (Dim d(2) As Double), nicht mit Array(...). Mit Array(...) lieferten sie in SOLIDWORKS 2024 Nothing oder False, Modeler.CreateBodyFromBox3 brach mit Laufzeitfehler 10 ab. Halte außerdem Modeler und MathUtility in eigenen Variablen: Ketten wie Application.SldWorks.GetMathUtility.CreateTransform(...) führten zu Abstürzen.

Eigenschaften und Methoden

Eigenschaften 8, davon 7 beschrieben, 1 veraltet

NameBeschreibung
Check3Prüft einen Körper auf Fehler und liefert die fehlerhaften Elemente.
DisableDisplayLiefert oder setzt, ob ein Körper ausgeblendet ist, aber auswählbar bleibt.
DisableHighlightSchaltet die Hervorhebung eines ausgewählten Körpers im Grafikbereich ab.
IsSafeNicht umgesetzt: liefert immer False.
MaterialPropertyValuesveraltet ersetzt durch Body2.MaterialPropertyValues2
MaterialPropertyValues2Liefert oder setzt Farbe und Lichteigenschaften eines Körpers in der aktiven Konfiguration.
NameLiefert oder ändert den Namen eines Körpers, wie er im Ordner „Volumenkörper“ steht.
VisibleLiefert, ob ein Körper sichtbar oder ausgeblendet ist.

Methoden 136, davon 108 beschrieben, 28 veraltet

NameBeschreibung
AddConstantFilletsRundet Kanten eines Körpers mit festem Radius.
AddProfileArcLegt eine Kreiskurve als Profil für Rotations- oder Extrusionsflächen an.
AddProfileBsplineLegt eine B-Spline-Kurve als Profil für Rotations- oder Extrusionsflächen an.
AddProfileBsplineByPtsLegt eine B-Spline-Kurve durch Punkte als Profil an.
AddProfileLineLegt eine Gerade als Profil für Rotations- oder Extrusionsflächen an.
AddPropertyExtensionveraltet ersetzt durch Body2.AddPropertyExtension2
AddPropertyExtension2Hängt einen eigenen Wert (Zahl oder Text) an einen Körper.
AddVertexPointFügt einem Körper einen Eckpunkt hinzu.
ApplyTransformVerschiebt, dreht oder skaliert einen Körper mit einer Transformation.
Checkveraltet ersetzt durch Body2.Check3
Check2veraltet ersetzt durch Body2.Check3
ConvertToMeshBodyWandelt einen Volumen-, Flächen- oder Grafikkörper in einen Netzkörper (Mesh BREP) um.
Copyveraltet ersetzt durch Body2.Copy2
Copy2Liefert eine Kopie eines Körpers als temporären Körper.
CreateBaseFeatureLegt für einen importierten Körper ein Basis-Feature an.
CreateBlendSurfaceLegt eine Rundungsfläche mit festem Radius zwischen zwei Flächen an (Rolling-Ball).
CreateBodyFromFacesLegt aus Flächen einen temporären Körper an.
CreateBodyFromSurfacesNäht die beschnittenen Flächen eines Körpers im Aufbau zu einem Volumenkörper.
CreateBoundedSurfaceBegrenzt eine zuvor angelegte Basisfläche auf einen UV-Bereich.
CreateBsplineSurfaceLegt eine B-Spline-Fläche an.
CreateExtrusionSurfaceLegt eine unendlich lange Extrusionsfläche aus einer Profilkurve an.
CreateNewSurfaceLegt einen Platzhalter für eine neue Fläche im Körper an, als ersten Schritt beim Aufbau aus beschnittenen Flächen.
CreateOffsetSurfaceLegt eine Fläche mit Abstand zu einer vorhandenen Fläche an.
CreatePlanarSurfaceLegt eine unendliche Ebene als Fläche an.
CreatePlanarTrimSurfaceDLLLegt eine ebene, beschnittene Fläche direkt aus Eckpunkten an.
CreateRevolutionSurfaceLegt eine Rotationsfläche aus einer Profilkurve an.
CreateRuledSurfaceLegt eine Regelfläche zwischen zwei Kurven an.
CreateTempBodyFromSurfacesMacht aus den beschnittenen Flächen eines Körpers im Aufbau einen temporären Körper.
CreateTrimmedSurfaceBeschneidet die zuletzt angelegte Fläche mit den zuvor angelegten Begrenzungskurven.
DeleteBlendsveraltet ersetzt durch Body2.DeleteBlends3
DeleteBlends2veraltet ersetzt durch Body2.DeleteBlends3
DeleteBlends3Entfernt Rundungsflächen aus einem temporären Körper und schließt die Lücken.
DeleteFacesveraltet ersetzt durch Body2.DeleteFaces5
DeleteFaces2veraltet ersetzt durch Body2.DeleteFaces5
DeleteFaces3veraltet ersetzt durch Body2.DeleteFaces5
DeleteFaces4veraltet ersetzt durch Body2.DeleteFaces5
DeleteFaces5Löscht Flächen aus einem temporären Körper und schließt die Lücken.
DeleteFacesMakeSheetBodiesLiefert einen Körper ohne die angegebenen Flächen als Flächenkörper. Der Ausgangskörper bleibt, wie er war.
DeSelectHebt die Auswahl eines Körpers auf.
DiagnoseLiefert die Lücken eines Körpers mit ihren Teilkanten.
Displayveraltet ersetzt durch Body2.Display3
Display2veraltet ersetzt durch Body2.Display3
Display3Zeigt einen temporären Körper im Grafikbereich eines Teils oder einer Komponente.
DisplayWireFrameXORZeigt einen temporären Körper als Drahtmodell im XOR-Modus.
DraftBodyveraltet ersetzt durch Body2.DraftBody2
DraftBody2Gibt Flächen eines temporären Körpers eine Formschräge.
EnumFacesLiefert die Flächen eines Körpers als Aufzählung (EnumFaces2).
ExtendSurfaceVerlängert Kanten eines Flächenkörpers und liefert das Ergebnis als neuen temporären Körper.
FindAttributeSucht an einem Körper ein Attribut mit einer bestimmten Definition.
GetBodyBoxLiefert einen Quader, der den Körper umschließt.
GetCoincidenceTransformveraltet ersetzt durch Body2.GetCoincidenceTransform2
GetCoincidenceTransform2Berechnet die Transformation, die einen anderen Körper genau auf diesen Körper legt.
GetEdgeCountLiefert die Anzahl der Kanten eines Körpers.
GetEdgesLiefert alle Kanten eines Körpers.
GetExcessBodyArrayLiefert die überzähligen Körper nach dem Zusammennähen.
GetExtremePointLiefert den äußersten Punkt eines Körpers in einer Richtung.
GetFaceCountLiefert die Anzahl der Flächen eines Körpers.
GetFacesLiefert alle Flächen eines Körpers als Array.
GetFeatureCountLiefert die Anzahl der Features eines Körpers in einem Mehrkörper-Blechteil.
GetFeaturesLiefert die Features eines Körpers in einem Mehrkörper-Blechteil.
GetFirstFaceLiefert die erste Fläche eines Körpers, als Start für eine Schleife mit Face2.GetNextFace.
GetFirstSelectedFaceLiefert die erste ausgewählte Fläche eines Körpers, gedacht für IGES-Routinen.
GetGraphicsBodyLiefert den Grafikkörper zu einem Körper.
GetIgesErrorCodeLiefert einen Fehlercode aus der IGES-Verarbeitung.
GetIgesErrorCountLiefert die Anzahl der Fehler aus der IGES-Verarbeitung.
GetIntersectionEdgesveraltet ersetzt durch Body2.GetIntersectionEdges2
GetIntersectionEdges2Liefert die Schnittkanten zwischen diesem Körper und einem temporären Werkzeugkörper.
GetMassPropertiesLiefert Schwerpunkt, Volumen, Fläche, Masse und Trägheitsmomente eines Körpers mit vorgegebener Dichte.
GetMaterialIdNameveraltet ersetzt durch Body2.GetMaterialIdName2
GetMaterialIdName2Liefert den Materialnamen eines Körpers.
GetMaterialPropertyNameLiefert Material und Materialdatenbank eines Körpers in einer Konfiguration.
GetMaterialUserNameveraltet ersetzt durch Body2.GetMaterialUserName2
GetMaterialUserName2Liefert den sichtbaren Materialnamen eines Körpers.
GetMeshBodyLiefert den Netzkörper zu einem Körper.
GetMiddleSurfaceLegt eine Mittelfläche in einen Körper und liefert die Flächenpaare und Dicken.
GetNextSelectedFaceLiefert die nächste ausgewählte Fläche eines Körpers, gedacht für IGES-Routinen.
GetOriginalPatternedBodyLiefert zu einem Körper aus einem Muster den Originalkörper und die Lage gegenüber dem Original.
GetProcessedBodyveraltet ersetzt durch Body2.GetProcessedBody2
GetProcessedBody2Liefert eine aufbereitete Kopie eines Körpers, etwa für den Export nach IGES.
GetProcessedBodyWithSelFaceLiefert eine aufbereitete Kopie eines Körpers mit den vorher ausgewählten Flächen.
GetPropertyExtensionveraltet ersetzt durch Body2.GetPropertyExtension2
GetPropertyExtension2Liefert einen mit AddPropertyExtension2 angehängten Wert eines Körpers.
GetSafeBodyNicht umgesetzt: liefert immer Nothing.
GetSelectedFaceCountLiefert die Anzahl der ausgewählten Flächen eines Körpers, gedacht für IGES-Routinen.
GetSelectedFacesLiefert die ausgewählten Flächen eines Körpers, gedacht für IGES-Routinen.
GetSelectionIdLiefert die Auswahl-ID eines Körpers, mit der du ihn über SelectByID2 auswählen kannst.
GetSheetBodyLiefert einen Flächenkörper aus diesem Körper.
GetTessellationLiefert ein Tessellation-Objekt, mit dem du den Körper oder einzelne Flächen in Dreiecke zerlegst.
GetTextureLiefert die Textur eines Körpers in einer Konfiguration.
GetTrackingIDsLiefert die Tracking-IDs eines Körpers zu einer Tracking-Definition.
GetTrackingIDsCountLiefert die Anzahl der Tracking-IDs eines Körpers zu einer Tracking-Definition.
GetTypeLiefert die Art eines Körpers: Volumen, Fläche, Draht und andere.
GetUpdateStampLiefert einen Zähler, der sich ändert, wenn der Körper neu aufgebaut wurde.
GetVertexCountLiefert die Anzahl der Eckpunkte eines Körpers.
GetVerticesLiefert alle Eckpunkte eines Körpers.
HasMaterialPropertyValuesLiefert, ob ein Körper eine eigene Darstellung (Farbe) hat.
HideBeendet die Anzeige eines temporären Körpers, der mit Display3 gezeigt wird.
HideBodyBlendet einen Körper aus oder ein.
IsGraphicsBodyLiefert, ob ein Körper ein Grafikkörper ist, etwa aus einer importierten Netzdatei.
IsMeshBodyLiefert, ob ein Körper ein Netzkörper (Mesh BREP) ist.
IsPatternSeedLiefert, ob dieser Körper das Original eines bestimmten Musterkörpers ist.
IsSheetMetalLiefert, ob ein Körper durch ein Blech-Feature entstanden ist.
IsTemporaryBodyLiefert, ob ein Körper temporär ist, also nur im Speicher existiert und kein Feature hat.
MakeOffsetLegt einen neuen temporären Körper an, der einen Flächenkörper mit Abstand versetzt.
MatchedBooleanveraltet ersetzt durch Body2.MatchedBoolean4
MatchedBoolean2veraltet ersetzt durch Body2.MatchedBoolean4
MatchedBoolean3veraltet ersetzt durch Body2.MatchedBoolean4
MatchedBoolean4Verknüpft Körper boolesch und nutzt dabei Paare von Flächen, die genau übereinstimmen.
MinimumRadiusLiefert den kleinsten Krümmungsradius eines Körpers.
NegateKehrt die Richtung (Orientierung) eines Körpers um.
OffsetPlanarWireBodyVersetzt einen ebenen Drahtkörper in seiner Ebene.
Operationsveraltet ersetzt durch Body2.Operations2
Operations2Verknüpft zwei temporäre Körper: vereinigen, abziehen oder schneiden.
RemoveFacesFromSheetEntfernt Flächen aus einem Flächenkörper.
RemoveMaterialPropertyEntfernt die eigene Darstellung (Farbe) eines Körpers in bestimmten Konfigurationen.
RemoveRedundantTopologyEntfernt überflüssige Topologie, etwa unnötige Kanten zwischen gleichen Flächen.
RemoveTextureEntfernt die Textur eines Körpers in einer Konfiguration.
RemoveTextureByDisplayStateEntfernt die Textur eines Körpers in einem Anzeigezustand.
RemoveTrackingIDEntfernt die Tracking-ID eines Körpers zu einer Tracking-Definition.
ResetEdgeTolerancesSetzt die Toleranzen aller Kanten eines Körpers zurück.
ResetPropertyExtensionveraltet ersetzt durch Body2.ResetPropertyExtension2
ResetPropertyExtension2Löscht alle mit AddPropertyExtension2 angehängten Werte eines Körpers.
SaveSpeichert einen Körper in einen Datenstrom.
Selectveraltet ersetzt durch Body2.Select2
Select2Wählt einen Körper aus, wahlweise mit Markierung.
SetCurrentSurfaceÜbernimmt eine vorhandene Fläche in einen Körper im Aufbau.
SetIgesInfoÜbergibt IGES-Einstellungen an den Geometriekern.
SetMaterialIdNameveraltet ersetzt durch Body2.SetMaterialIdName2
SetMaterialIdName2Setzt den Materialnamen eines Körpers.
SetMaterialPropertyWeist einem Körper ein Material aus einer Materialdatenbank zu.
SetMaterialUserNameveraltet ersetzt durch Body2.SetMaterialUserName2
SetMaterialUserName2Setzt den sichtbaren Materialnamen eines Körpers.
SetTextureWeist einem Körper in einer Konfiguration eine Textur zu.
SetTextureByDisplayStateWeist einem Körper in einem Anzeigezustand eine Textur zu.
SetTrackingIDGibt einem Körper eine eigene Tracking-ID, an der du ihn nach Änderungen wiedererkennst.
SetXformveraltet ersetzt durch Body2.ApplyTransform

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

Siehe auch

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

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