SolidWorksMakroprogrammierung

Objekt · SldWorks

MidSurface-Objekt

Veraltetes Objekt für ein Mittelflächen-Feature. MidSurface3 tritt an seine Stelle.

Deklaration Dim x As SldWorks.MidSurface · in der englischen .NET-Hilfe: IMidSurface

Beschreibung

MidSurface ist mit allen Befehlen veraltet. Die Objektseite der Hilfe nennt MidSurface3 als Nachfolger, die einzelnen Befehle verweisen dagegen auf die gleichnamigen Befehle von MidSurface2, das selbst veraltet und durch MidSurface3 ersetzt ist. Für neue Makros nimmst du MidSurface3. Das Objekt stand für ein Mittelflächen-Feature: die Flächen der Mittelfläche, die parallelen Flächenpaare des Körpers mit ihrem Abstand und die Referenzflächen. Seit wann es veraltet ist, sagt die Hilfe nicht, vermutlich seit SOLIDWORKS 2001Plus, seit es MidSurface2 gibt.

Zugriff

Einen Zugriff auf das alte Objekt nennt die Hilfe nicht mehr. In der alten Hilfe entsteht die Mittelfläche mit ModelDoc::InsertMidSurfaceExt, heute ModelDoc2.InsertMidSurfaceExt und ebenfalls veraltet. Heute liefern Feature.GetSpecificFeature2 bei einer Mittelfläche (Typname MidRefSurface) und FeatureManager.InsertMidSurface ein MidSurface3.

Beispiel

' Gibt für die ausgewählte Mittelfläche jede Referenzfläche mit der Zahl ihrer
' Flächen und Kanten aus.
' Vorbedingung: Ein Teil mit einer Mittelfläche ist offen, die Mittelfläche ist im
'               FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swMitte As SldWorks.MidSurface3                     ' statt MidSurface
    Dim swBlatt As SldWorks.Body2
    Dim n As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "MidRefSurface" Then Exit Sub
    Set swMitte = swFeat.GetSpecificFeature2

    Debug.Print swFeat.Name & ": " & swMitte.GetNeutralSheetCount & " Referenzfläche(n)"   ' wie früher
    Set swBlatt = swMitte.GetFirstNeutralSheet
    Do While Not swBlatt Is Nothing
        n = n + 1
        Debug.Print "  Referenzfläche " & n & ": " & swBlatt.GetFaceCount & " Flächen, " & _
                    swBlatt.GetEdgeCount & " Kanten"
        Set swBlatt = swMitte.GetNextNeutralSheet
    Loop
End Sub

Bemerkungen

Ersatz: Jeder Befehl hat einen gleichnamigen Nachfolger an MidSurface2, der seinerseits durch den gleichnamigen Befehl von MidSurface3 ersetzt ist, etwa MidSurface3.GetFirstNeutralSheet oder MidSurface3.GetFirstFace. Die VBA-Deklarationen sind bei allen drei Objekten gleich.

Aus der alten Hilfe: Die alte Hilfe nennt MidSurface2 als Nachfolger des ganzen Objekts. Sie beschreibt zehn der zwölf Befehle, GetFirstFaceArray und GetNextFaceArray fehlen dort. Den Abstand der Flächenpaare gibt sie in Meter an. GetFirstFacePair und GetNextFacePair arbeiten wie GetFirstFace und GetNextFace, nur ohne die neutrale Fläche.

Neu in den Nachfolgern: MidSurface3 hat zusätzlich MidSurface3.GetFaces, das alle Flächen der Mittelfläche als Array liefert.

Eigenschaften und Methoden

Methoden 12, davon 0 beschrieben, 12 veraltet

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

Siehe auch

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

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