SolidWorksMakroprogrammierung

Objekt · SldWorks

EnumBodies2-Objekt

Eine Aufzählung von Körpern (Body2), etwa aus einem Teil oder einer Komponente, die du mit Next Körper für Körper durchgehst.

Deklaration Dim x As SldWorks.EnumBodies2 · in der englischen .NET-Hilfe: IEnumBodies2

Beschreibung

EnumBodies2 gibt Zugriff auf eine Aufzählung von Körpern (Body2). Eine Aufzählung gibt dir die Elemente nicht als Array, sondern eins nach dem anderen. Die Befehle gibt es seit SOLIDWORKS 2001Plus.

EnumBodies2 ist nur für In-Process-DLLs gedacht. In VBA-Makros nimmst du meist besser PartDoc.GetBodies2 oder Component2.GetBodies3, das gleich ein Array liefert.

Alle Körper holen: Du rufst EnumBodies2.Next in einer Schleife mit 1 auf. Vor jedem Aufruf setzt du die Variable für das Element auf Nothing. Ist sie danach noch Nothing, ist die Aufzählung zu Ende. Mit EnumBodies2.Reset fängst du wieder von vorn an.

Zugriff

Die Hilfe nennt außerdem Body2.IOperations2 und Body2.IMatchedBoolean3, die Varianten für C++, sowie Component2.EnumBodies2, das veraltet ist und durch Component2.EnumBodies3 ersetzt wurde.

Beispiel

' Geht alle sichtbaren Volumenkörper des aktiven Teils durch.
' Vorbedingung: Ein Teil ist offen.
' Ergebnis:     Name und Zahl der Flächen jedes Körpers stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPart As SldWorks.PartDoc
    Dim swEnum As SldWorks.EnumBodies2
    Dim swBody As SldWorks.Body2
    Dim nGeholt 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
    Set swEnum = swPart.EnumBodies3(swSolidBody, True)
    If swEnum Is Nothing Then Exit Sub

    Do
        Set swBody = Nothing
        swEnum.Next 1, swBody, nGeholt
        If swBody Is Nothing Then Exit Do
        Debug.Print swBody.Name & ": " & swBody.GetFaceCount & " Flächen"
    Loop
End Sub

Bemerkungen

Next in VBA: Next gibt in Rgelt ein Array mit Celt Elementen zurück. Die VBA-Syntax deklariert Rgelt aber als einzelnes Body2, deshalb holst du vermutlich immer genau 1 Element. PceltFetched ist kleiner als Celt, wenn weniger Körper übrig sind, oder NULL, wenn keine mehr da sind. Welchen Wert die Variable dann in VBA hat, sagt die Hilfe nicht. Die Schleife prüft deshalb das Element selbst.

Rückgabe: In VBA sind alle vier Befehle Funktionen mit einem HResult. Was der Wert bedeutet, sagt die Hilfe nicht. Du rufst sie ohne Klammern auf und lässt den Wert weg.

Referenzflächen: Bei PartDoc.EnumRelatedBodies2 enthält die Aufzählung nur die Körper der Referenzflächen, nicht den Körper des Teils. Jede Referenzfläche hat zwei Körper, einen für die Vorderseite und einen für die Rückseite.

Hilfebeispiel: Das einzige Beispiel, „Enumerate Bodies (C++)“, ist noch für die alten Aufzählungen geschrieben. Es geht mit Next die Körper der Referenzflächen eines Teils durch und darin deren Flächen.

Eigenschaften und Methoden

Methoden 4, davon 4 beschrieben

NameBeschreibung
CloneErstellt eine Kopie der Aufzählung der Körper.
NextHolt den nächsten Körper aus der Aufzählung.
ResetSetzt die Aufzählung an den Anfang zurück, sodass Next wieder den ersten Körper liefert.
SkipÜberspringt die angegebene Zahl von Körpern in der Aufzählung.

Siehe auch

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

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