SolidWorksMakroprogrammierung

Objekt · SldWorks

EnumFaces-Objekt

Veraltetes Objekt für eine Aufzählung der Flächen eines Körpers. EnumFaces2 tritt an seine Stelle.

Deklaration Dim x As SldWorks.EnumFaces · in der englischen .NET-Hilfe: IEnumFaces

Beschreibung

EnumFaces ist mit allen Befehlen veraltet und durch EnumFaces2 ersetzt. Das Objekt gab Zugriff auf eine Aufzählung von Flächen (Face), die du mit Next eine nach der anderen holtest. Seit wann es veraltet ist, sagt die Hilfe nicht.

Zugriff

Die alten Zugriffe sind ebenfalls veraltet. Ihre Nachfolger liefern ein EnumFaces2:

Beispiel

' Zählt die Flächen des ersten Volumenkörpers im aktiven Teil.
' Vorbedingung: Ein Teil mit einem Volumenkörper ist offen.
' Ergebnis:     Die Zahl der Flächen steht 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                 ' statt EnumFaces
    Dim swFace As SldWorks.Face2
    Dim vKoerper As Variant
    Dim nGeholt As Long, n 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
    Set swBody = vKoerper(0)
    Set swEnum = swBody.EnumFaces                       ' früher Body.EnumFaces

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

Bemerkungen

Ersatz: Jeder Befehl hat einen gleichnamigen Nachfolger an EnumFaces2: EnumFaces2.Clone, EnumFaces2.Next, EnumFaces2.Reset und EnumFaces2.Skip. EnumFaces2.Next liefert Face2 statt Face.

Aus der alten Hilfe: Eine Syntax für OLE-Automation, also auch für VBA, gab es bei keinem der vier Befehle („Not available“), die alte Hilfe zeigt nur die COM-Syntax. Alle vier gaben bei Erfolg S_OK zurück. Next holte celt Flächen und gab die Zahl der geholten zurück. Die konnte kleiner als celt oder NULL sein, wenn keine mehr da waren.

Eigenschaften und Methoden

Methoden 4, davon 0 beschrieben, 4 veraltet

NameBeschreibung
Cloneveraltet ersetzt durch EnumFaces2.Clone
Nextveraltet ersetzt durch EnumFaces2.Next
Resetveraltet ersetzt durch EnumFaces2.Reset
Skipveraltet ersetzt durch EnumFaces2.Skip

Siehe auch

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

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