SolidWorksMakroprogrammierung

Objekt · SldWorks

MidSurface3-Objekt

Ein Mittelflächen-Feature: seine Flächen, die Flächenpaare des Körpers, aus denen sie entstanden, mit ihrer Dicke und die Referenzflächen als Flächenkörper.

Deklaration Dim x As SldWorks.MidSurface3 · in der englischen .NET-Hilfe: IMidSurface3

Beschreibung

MidSurface3 gibt Zugriff auf ein Mittelflächen-Feature (midsurface). Nach FeatureManager.InsertMidSurface sucht SOLIDWORKS dafür alle parallelen Flächenpaare eines Volumenkörpers und legt zwischen jedes Paar eine neutrale Referenzfläche. Jede Referenzfläche ist ein Flächenkörper mit Flächen und Kanten. Die Flächen der Mittelfläche nennt die Hilfe neutrale Flächen. Die Befehle gibt es seit SOLIDWORKS 2009. MidSurface3 löst die veralteten Objekte MidSurface2 und MidSurface ab.

Zugriff

Beispiel

' Gibt für die ausgewählte Mittelfläche die Zahl der Flächen, Flächenpaare und
' Referenzflächen aus und für jede Fläche ihren Flächeninhalt und die Dicke.
' 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
    Dim swFlaeche As SldWorks.Face2
    Dim swFlaeche1 As Object, swFlaeche2 As Object
    Dim dDicke As Double
    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.GetFaceCount & " Flächen, " & _
                swMitte.GetFacePairCount & " Flächenpaare, " & _
                swMitte.GetNeutralSheetCount & " Referenzfläche(n)"

    Set swFlaeche = swMitte.GetFirstFace(swFlaeche1, swFlaeche2, dDicke)
    Do While Not swFlaeche Is Nothing
        n = n + 1
        Debug.Print "  Fläche " & n & ": " & Round(swFlaeche.GetArea * 1000000, 1) & " mm², Dicke " & _
                    Round(dDicke * 1000, 3) & " mm"
        Set swFlaeche = swMitte.GetNextFace(swFlaeche1, swFlaeche2, dDicke)
    Loop
End Sub

Bemerkungen

Anlegen: FeatureManager.InsertMidSurface liefert die neue Mittelfläche. Das Hilfebeispiel „Insert MidSurface in Component“ weist sie einer Variablen vom Typ MidSurface3 zu und liest gleich MidSurface3.GetFaceCount. Mit KnitFlag = True werden alle Referenzflächen zu einer zusammengefügt, dann gibt es nur einen Flächenkörper.

Vorhandene Mittelfläche: Das Hilfebeispiel „Get Areas of MidSurface Faces“ wählt das Feature aus, holt es mit SelectionMgr.GetSelectedObject6 und dann mit Feature.GetSpecificFeature2 die Mittelfläche. Das Feature hat den Typnamen MidRefSurface, siehe Tabelle bei Feature.GetTypeName2.

Dicke: Den Abstand der Flächen gibt die Hilfe bei GetFirstFace, GetNextFace, GetFirstFacePair und GetNextFacePair in Meter an. Bei GetFirstFaceArray und GetNextFaceArray nennt sie keine Einheit; es ist ebenfalls Meter.

Ende der Schleifen: Dass GetNextFace und GetNextFacePair nach dem letzten Eintrag Nothing liefern, sagt die Hilfe nicht ausdrücklich. Nur bei MidSurface3.GetNextNeutralSheet nennt sie Nothing, wenn es nur eine Referenzfläche gibt. Die Beispiele gehen bei allen davon aus.

Vorgänger: MidSurface2 und MidSurface sind veraltet. MidSurface3 hat dieselben Befehle mit derselben VBA-Deklaration und zusätzlich MidSurface3.GetFaces.

Eigenschaften und Methoden

Methoden 13, davon 13 beschrieben

NameBeschreibung
EdgeGetFaceLiefert die Fläche des ursprünglichen Körpers, auf der eine Kante der Mittelfläche liegt.
GetFaceCountLiefert die Zahl der Flächen der Mittelfläche.
GetFacePairCountLiefert die Zahl der parallelen Flächenpaare des Körpers, aus denen die Mittelfläche berechnet wurde.
GetFacesLiefert alle Flächen der Mittelfläche als Array.
GetFirstFaceLiefert die erste Fläche der Mittelfläche, dazu die beiden Flächen des Körpers, aus denen sie entstand, und ihren Abstand.
GetFirstFaceArrayLiefert die erste Fläche der Mittelfläche zusammen mit den Flächen des Körpers als Array und die Dicke.
GetFirstFacePairLiefert das erste Flächenpaar des Körpers, aus dem die Mittelfläche entstand, und den Abstand der beiden Flächen.
GetFirstNeutralSheetLiefert die erste Referenzfläche der Mittelfläche als Flächenkörper.
GetNeutralSheetCountLiefert die Zahl der Referenzflächen der Mittelfläche.
GetNextFaceLiefert die nächste Fläche der Mittelfläche, dazu die beiden Flächen des Körpers, aus denen sie entstand, und ihren Abstand.
GetNextFaceArrayLiefert die nächste Fläche der Mittelfläche zusammen mit den Flächen des Körpers als Array und die Dicke.
GetNextFacePairLiefert das nächste Flächenpaar des Körpers, aus dem die Mittelfläche entstand, und den Abstand der beiden Flächen.
GetNextNeutralSheetLiefert die nächste Referenzfläche der Mittelfläche als Flächenkörper.

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

Siehe auch

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

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