SolidWorksMakroprogrammierung

Objekt · SldWorks

EnumFaces2-Objekt

Eine Aufzählung der Flächen (Face2) eines Körpers, die du mit Next Fläche für Fläche durchgehst.

Deklaration Dim x As SldWorks.EnumFaces2 · in der englischen .NET-Hilfe: IEnumFaces2

Beschreibung

EnumFaces2 gibt Zugriff auf eine Aufzählung von Flächen (Face2). Eine Aufzählung gibt dir die Elemente nicht als Array, sondern eins nach dem anderen. Die Befehle gibt es seit SOLIDWORKS 2001Plus.

EnumFaces2 ist nur für In-Process-DLLs gedacht. In VBA-Makros nimmst du meist besser Body2.GetFaces, das gleich ein Array liefert, oder die Schleife mit Body2.GetFirstFace und Face2.GetNextFace.

Alle Flächen holen: Du rufst EnumFaces2.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 EnumFaces2.Reset fängst du wieder von vorn an.

Zugriff

Beispiel

' Zählt je Volumenkörper des aktiven Teils die Flächen und addiert ihre Größe.
' Vorbedingung: Ein Teil ist offen.
' Ergebnis:     Je Körper stehen Zahl und Gesamtgröße der Flächen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPart As SldWorks.PartDoc
    Dim swBody As SldWorks.Body2
    Dim swEnum As SldWorks.EnumFaces2
    Dim swFace As SldWorks.Face2
    Dim vKoerper As Variant
    Dim nGeholt As Long, n As Long, i As Long
    Dim dFlaeche As Double

    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)
        Set swEnum = swBody.EnumFaces
        n = 0: dFlaeche = 0
        Do
            Set swFace = Nothing
            swEnum.Next 1, swFace, nGeholt
            If swFace Is Nothing Then Exit Do
            n = n + 1
            dFlaeche = dFlaeche + swFace.GetArea
        Loop
        Debug.Print swBody.Name & ": " & n & " Flächen, " & Format(dFlaeche * 1000000, "0.00") & " mm²"
    Next i
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 Face2, deshalb holst du vermutlich immer genau 1 Element. PceltFetched ist kleiner als Celt, wenn weniger Flächen ü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.

OLE-Automation: Nach Body2.EnumFaces nehmen OLE-Automation-Programme Body2.GetFirstFace und Face2.GetNextFace. Den Flächeninhalt gibt Face2.GetArea in Quadratmetern zurück, das Beispiel rechnet in mm² um.

Eigenschaften und Methoden

Methoden 4, davon 4 beschrieben

NameBeschreibung
CloneErstellt eine Kopie der Aufzählung der Flächen.
NextHolt die nächste Fläche aus der Aufzählung.
ResetSetzt die Aufzählung an den Anfang zurück, sodass Next wieder die erste Fläche liefert.
SkipÜberspringt die angegebene Zahl von Flächen in der Aufzählung.

Siehe auch

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

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