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.
Beschreibung
Es gibt zwei Arten von Körpern:
- Körper des Modells: Sie entstehen durch Features und stehen im Ordner „Volumenkörper“ oder „Flächenkörper“. Du holst sie etwa mit
PartDoc.GetBodies2. - Temporäre Körper: Sie existieren nur im Speicher, etwa aus
Modeler.CreateBodyFromBox3oderBody2.Copy2. Mit ihnen rechnest du, zeigst sie mitBody2.Display3an oder machst mitPartDoc.CreateFeatureFromBody3ein Feature daraus.
Zugriff
PartDoc.GetBodies2: die Körper eines TeilsComponent2.GetBodies3: die Körper einer Komponente in der BaugruppeFace2.GetBody: der Körper einer FlächeModeler.CreateBodyFromBox3und weitere Befehle desModeler: temporäre Körper
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 IfBemerkungen
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
| Name | Beschreibung |
|---|---|
| Check3 | Prüft einen Körper auf Fehler und liefert die fehlerhaften Elemente. |
| DisableDisplay | Liefert oder setzt, ob ein Körper ausgeblendet ist, aber auswählbar bleibt. |
| DisableHighlight | Schaltet die Hervorhebung eines ausgewählten Körpers im Grafikbereich ab. |
| IsSafe | Nicht umgesetzt: liefert immer False. |
| MaterialPropertyValues | veraltet ersetzt durch Body2.MaterialPropertyValues2 |
| MaterialPropertyValues2 | Liefert oder setzt Farbe und Lichteigenschaften eines Körpers in der aktiven Konfiguration. |
| Name | Liefert oder ändert den Namen eines Körpers, wie er im Ordner „Volumenkörper“ steht. |
| Visible | Liefert, ob ein Körper sichtbar oder ausgeblendet ist. |
Methoden 136, davon 108 beschrieben, 28 veraltet
| Name | Beschreibung |
|---|---|
| AddConstantFillets | Rundet Kanten eines Körpers mit festem Radius. |
| AddProfileArc | Legt eine Kreiskurve als Profil für Rotations- oder Extrusionsflächen an. |
| AddProfileBspline | Legt eine B-Spline-Kurve als Profil für Rotations- oder Extrusionsflächen an. |
| AddProfileBsplineByPts | Legt eine B-Spline-Kurve durch Punkte als Profil an. |
| AddProfileLine | Legt eine Gerade als Profil für Rotations- oder Extrusionsflächen an. |
| AddPropertyExtension | veraltet ersetzt durch Body2.AddPropertyExtension2 |
| AddPropertyExtension2 | Hängt einen eigenen Wert (Zahl oder Text) an einen Körper. |
| AddVertexPoint | Fügt einem Körper einen Eckpunkt hinzu. |
| ApplyTransform | Verschiebt, dreht oder skaliert einen Körper mit einer Transformation. |
| Check | veraltet ersetzt durch Body2.Check3 |
| Check2 | veraltet ersetzt durch Body2.Check3 |
| ConvertToMeshBody | Wandelt einen Volumen-, Flächen- oder Grafikkörper in einen Netzkörper (Mesh BREP) um. |
| Copy | veraltet ersetzt durch Body2.Copy2 |
| Copy2 | Liefert eine Kopie eines Körpers als temporären Körper. |
| CreateBaseFeature | Legt für einen importierten Körper ein Basis-Feature an. |
| CreateBlendSurface | Legt eine Rundungsfläche mit festem Radius zwischen zwei Flächen an (Rolling-Ball). |
| CreateBodyFromFaces | Legt aus Flächen einen temporären Körper an. |
| CreateBodyFromSurfaces | Näht die beschnittenen Flächen eines Körpers im Aufbau zu einem Volumenkörper. |
| CreateBoundedSurface | Begrenzt eine zuvor angelegte Basisfläche auf einen UV-Bereich. |
| CreateBsplineSurface | Legt eine B-Spline-Fläche an. |
| CreateExtrusionSurface | Legt eine unendlich lange Extrusionsfläche aus einer Profilkurve an. |
| CreateNewSurface | Legt einen Platzhalter für eine neue Fläche im Körper an, als ersten Schritt beim Aufbau aus beschnittenen Flächen. |
| CreateOffsetSurface | Legt eine Fläche mit Abstand zu einer vorhandenen Fläche an. |
| CreatePlanarSurface | Legt eine unendliche Ebene als Fläche an. |
| CreatePlanarTrimSurfaceDLL | Legt eine ebene, beschnittene Fläche direkt aus Eckpunkten an. |
| CreateRevolutionSurface | Legt eine Rotationsfläche aus einer Profilkurve an. |
| CreateRuledSurface | Legt eine Regelfläche zwischen zwei Kurven an. |
| CreateTempBodyFromSurfaces | Macht aus den beschnittenen Flächen eines Körpers im Aufbau einen temporären Körper. |
| CreateTrimmedSurface | Beschneidet die zuletzt angelegte Fläche mit den zuvor angelegten Begrenzungskurven. |
| DeleteBlends | veraltet ersetzt durch Body2.DeleteBlends3 |
| DeleteBlends2 | veraltet ersetzt durch Body2.DeleteBlends3 |
| DeleteBlends3 | Entfernt Rundungsflächen aus einem temporären Körper und schließt die Lücken. |
| DeleteFaces | veraltet ersetzt durch Body2.DeleteFaces5 |
| DeleteFaces2 | veraltet ersetzt durch Body2.DeleteFaces5 |
| DeleteFaces3 | veraltet ersetzt durch Body2.DeleteFaces5 |
| DeleteFaces4 | veraltet ersetzt durch Body2.DeleteFaces5 |
| DeleteFaces5 | Löscht Flächen aus einem temporären Körper und schließt die Lücken. |
| DeleteFacesMakeSheetBodies | Liefert einen Körper ohne die angegebenen Flächen als Flächenkörper. Der Ausgangskörper bleibt, wie er war. |
| DeSelect | Hebt die Auswahl eines Körpers auf. |
| Diagnose | Liefert die Lücken eines Körpers mit ihren Teilkanten. |
| Display | veraltet ersetzt durch Body2.Display3 |
| Display2 | veraltet ersetzt durch Body2.Display3 |
| Display3 | Zeigt einen temporären Körper im Grafikbereich eines Teils oder einer Komponente. |
| DisplayWireFrameXOR | Zeigt einen temporären Körper als Drahtmodell im XOR-Modus. |
| DraftBody | veraltet ersetzt durch Body2.DraftBody2 |
| DraftBody2 | Gibt Flächen eines temporären Körpers eine Formschräge. |
| EnumFaces | Liefert die Flächen eines Körpers als Aufzählung (EnumFaces2). |
| ExtendSurface | Verlängert Kanten eines Flächenkörpers und liefert das Ergebnis als neuen temporären Körper. |
| FindAttribute | Sucht an einem Körper ein Attribut mit einer bestimmten Definition. |
| GetBodyBox | Liefert einen Quader, der den Körper umschließt. |
| GetCoincidenceTransform | veraltet ersetzt durch Body2.GetCoincidenceTransform2 |
| GetCoincidenceTransform2 | Berechnet die Transformation, die einen anderen Körper genau auf diesen Körper legt. |
| GetEdgeCount | Liefert die Anzahl der Kanten eines Körpers. |
| GetEdges | Liefert alle Kanten eines Körpers. |
| GetExcessBodyArray | Liefert die überzähligen Körper nach dem Zusammennähen. |
| GetExtremePoint | Liefert den äußersten Punkt eines Körpers in einer Richtung. |
| GetFaceCount | Liefert die Anzahl der Flächen eines Körpers. |
| GetFaces | Liefert alle Flächen eines Körpers als Array. |
| GetFeatureCount | Liefert die Anzahl der Features eines Körpers in einem Mehrkörper-Blechteil. |
| GetFeatures | Liefert die Features eines Körpers in einem Mehrkörper-Blechteil. |
| GetFirstFace | Liefert die erste Fläche eines Körpers, als Start für eine Schleife mit Face2.GetNextFace. |
| GetFirstSelectedFace | Liefert die erste ausgewählte Fläche eines Körpers, gedacht für IGES-Routinen. |
| GetGraphicsBody | Liefert den Grafikkörper zu einem Körper. |
| GetIgesErrorCode | Liefert einen Fehlercode aus der IGES-Verarbeitung. |
| GetIgesErrorCount | Liefert die Anzahl der Fehler aus der IGES-Verarbeitung. |
| GetIntersectionEdges | veraltet ersetzt durch Body2.GetIntersectionEdges2 |
| GetIntersectionEdges2 | Liefert die Schnittkanten zwischen diesem Körper und einem temporären Werkzeugkörper. |
| GetMassProperties | Liefert Schwerpunkt, Volumen, Fläche, Masse und Trägheitsmomente eines Körpers mit vorgegebener Dichte. |
| GetMaterialIdName | veraltet ersetzt durch Body2.GetMaterialIdName2 |
| GetMaterialIdName2 | Liefert den Materialnamen eines Körpers. |
| GetMaterialPropertyName | Liefert Material und Materialdatenbank eines Körpers in einer Konfiguration. |
| GetMaterialUserName | veraltet ersetzt durch Body2.GetMaterialUserName2 |
| GetMaterialUserName2 | Liefert den sichtbaren Materialnamen eines Körpers. |
| GetMeshBody | Liefert den Netzkörper zu einem Körper. |
| GetMiddleSurface | Legt eine Mittelfläche in einen Körper und liefert die Flächenpaare und Dicken. |
| GetNextSelectedFace | Liefert die nächste ausgewählte Fläche eines Körpers, gedacht für IGES-Routinen. |
| GetOriginalPatternedBody | Liefert zu einem Körper aus einem Muster den Originalkörper und die Lage gegenüber dem Original. |
| GetProcessedBody | veraltet ersetzt durch Body2.GetProcessedBody2 |
| GetProcessedBody2 | Liefert eine aufbereitete Kopie eines Körpers, etwa für den Export nach IGES. |
| GetProcessedBodyWithSelFace | Liefert eine aufbereitete Kopie eines Körpers mit den vorher ausgewählten Flächen. |
| GetPropertyExtension | veraltet ersetzt durch Body2.GetPropertyExtension2 |
| GetPropertyExtension2 | Liefert einen mit AddPropertyExtension2 angehängten Wert eines Körpers. |
| GetSafeBody | Nicht umgesetzt: liefert immer Nothing. |
| GetSelectedFaceCount | Liefert die Anzahl der ausgewählten Flächen eines Körpers, gedacht für IGES-Routinen. |
| GetSelectedFaces | Liefert die ausgewählten Flächen eines Körpers, gedacht für IGES-Routinen. |
| GetSelectionId | Liefert die Auswahl-ID eines Körpers, mit der du ihn über SelectByID2 auswählen kannst. |
| GetSheetBody | Liefert einen Flächenkörper aus diesem Körper. |
| GetTessellation | Liefert ein Tessellation-Objekt, mit dem du den Körper oder einzelne Flächen in Dreiecke zerlegst. |
| GetTexture | Liefert die Textur eines Körpers in einer Konfiguration. |
| GetTrackingIDs | Liefert die Tracking-IDs eines Körpers zu einer Tracking-Definition. |
| GetTrackingIDsCount | Liefert die Anzahl der Tracking-IDs eines Körpers zu einer Tracking-Definition. |
| GetType | Liefert die Art eines Körpers: Volumen, Fläche, Draht und andere. |
| GetUpdateStamp | Liefert einen Zähler, der sich ändert, wenn der Körper neu aufgebaut wurde. |
| GetVertexCount | Liefert die Anzahl der Eckpunkte eines Körpers. |
| GetVertices | Liefert alle Eckpunkte eines Körpers. |
| HasMaterialPropertyValues | Liefert, ob ein Körper eine eigene Darstellung (Farbe) hat. |
| Hide | Beendet die Anzeige eines temporären Körpers, der mit Display3 gezeigt wird. |
| HideBody | Blendet einen Körper aus oder ein. |
| IsGraphicsBody | Liefert, ob ein Körper ein Grafikkörper ist, etwa aus einer importierten Netzdatei. |
| IsMeshBody | Liefert, ob ein Körper ein Netzkörper (Mesh BREP) ist. |
| IsPatternSeed | Liefert, ob dieser Körper das Original eines bestimmten Musterkörpers ist. |
| IsSheetMetal | Liefert, ob ein Körper durch ein Blech-Feature entstanden ist. |
| IsTemporaryBody | Liefert, ob ein Körper temporär ist, also nur im Speicher existiert und kein Feature hat. |
| MakeOffset | Legt einen neuen temporären Körper an, der einen Flächenkörper mit Abstand versetzt. |
| MatchedBoolean | veraltet ersetzt durch Body2.MatchedBoolean4 |
| MatchedBoolean2 | veraltet ersetzt durch Body2.MatchedBoolean4 |
| MatchedBoolean3 | veraltet ersetzt durch Body2.MatchedBoolean4 |
| MatchedBoolean4 | Verknüpft Körper boolesch und nutzt dabei Paare von Flächen, die genau übereinstimmen. |
| MinimumRadius | Liefert den kleinsten Krümmungsradius eines Körpers. |
| Negate | Kehrt die Richtung (Orientierung) eines Körpers um. |
| OffsetPlanarWireBody | Versetzt einen ebenen Drahtkörper in seiner Ebene. |
| Operations | veraltet ersetzt durch Body2.Operations2 |
| Operations2 | Verknüpft zwei temporäre Körper: vereinigen, abziehen oder schneiden. |
| RemoveFacesFromSheet | Entfernt Flächen aus einem Flächenkörper. |
| RemoveMaterialProperty | Entfernt die eigene Darstellung (Farbe) eines Körpers in bestimmten Konfigurationen. |
| RemoveRedundantTopology | Entfernt überflüssige Topologie, etwa unnötige Kanten zwischen gleichen Flächen. |
| RemoveTexture | Entfernt die Textur eines Körpers in einer Konfiguration. |
| RemoveTextureByDisplayState | Entfernt die Textur eines Körpers in einem Anzeigezustand. |
| RemoveTrackingID | Entfernt die Tracking-ID eines Körpers zu einer Tracking-Definition. |
| ResetEdgeTolerances | Setzt die Toleranzen aller Kanten eines Körpers zurück. |
| ResetPropertyExtension | veraltet ersetzt durch Body2.ResetPropertyExtension2 |
| ResetPropertyExtension2 | Löscht alle mit AddPropertyExtension2 angehängten Werte eines Körpers. |
| Save | Speichert einen Körper in einen Datenstrom. |
| Select | veraltet ersetzt durch Body2.Select2 |
| Select2 | Wä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. |
| SetMaterialIdName | veraltet ersetzt durch Body2.SetMaterialIdName2 |
| SetMaterialIdName2 | Setzt den Materialnamen eines Körpers. |
| SetMaterialProperty | Weist einem Körper ein Material aus einer Materialdatenbank zu. |
| SetMaterialUserName | veraltet ersetzt durch Body2.SetMaterialUserName2 |
| SetMaterialUserName2 | Setzt den sichtbaren Materialnamen eines Körpers. |
| SetTexture | Weist einem Körper in einer Konfiguration eine Textur zu. |
| SetTextureByDisplayState | Weist einem Körper in einem Anzeigezustand eine Textur zu. |
| SetTrackingID | Gibt einem Körper eine eigene Tracking-ID, an der du ihn nach Änderungen wiedererkennst. |
| SetXform | veraltet 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.