SolidWorksMakroprogrammierung

Objekt · SldWorks

ShutOffSurfaceFeatureData-Objekt

Die Feature-Daten von Abschaltflächen im Formenbau: die Kanten der geschlossenen Schleifen, die Art, wie jede Öffnung geschlossen wird, und ob die Flächen vernäht werden.

Deklaration Dim x As SldWorks.ShutOffSurfaceFeatureData · in der englischen .NET-Hilfe: IShutOffSurfaceFeatureData

Beschreibung

ShutOffSurfaceFeatureData gibt Zugriff auf ein Abschaltflächen-Feature (shut-off surface). Im Formenbau schließen Abschaltflächen die Durchbrüche eines Formteils. Jede Öffnung wird durch eine geschlossene Schleife aus Kanten beschrieben und mit einer Fläche (patch) geschlossen: gar nicht, mit Kontakt oder tangential an eine angrenzende Fläche. Die Befehle gibt es seit SOLIDWORKS 2005.

Zugriff

Neu anlegen kannst du Abschaltflächen mit FeatureManager.InsertMoldShutOffSurface.

Beispiel

' Gibt Status, Vernähen und die Schleifen der ausgewählten Abschaltflächen aus
' und stellt danach alle Schleifen auf Kontakt.
' Vorbedingung: Ein Formteil ist offen, ein Abschaltflächen-Feature ist im FeatureManager ausgewählt.
' Ergebnis:     Alle Öffnungen sind mit Kontakt geschlossen, die Werte stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDef As Object
    Dim swDaten As SldWorks.ShutOffSurfaceFeatureData
    Dim i 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
    Set swDef = swFeat.GetDefinition
    If Not TypeOf swDef Is SldWorks.ShutOffSurfaceFeatureData Then Exit Sub
    Set swDaten = swDef

    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": Status " & swDaten.Status & ", vernäht: " & swDaten.Knit & _
                ", " & swDaten.GetEdgeCount & " Kanten in " & swDaten.GetLoopCount & " Schleife(n)"
    For i = 0 To swDaten.GetLoopCount - 1
        Debug.Print "  Schleife " & i & ": " & swDaten.GetLoopEdgeCount(i) & " Kanten, Art " & swDaten.LoopPatchType(i)
    Next i

    swDaten.SetAllPatchTypes swPatchTypeContact
    If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Hilfebeispiel: „Get Shut-Off Surface Data“ liest nach ShutOffSurfaceFeatureData.AccessSelections Status, Vernähen, Kanten und Schleifen aus, wählt die Kanten jeder Schleife aus und schaltet bei tangentialem Schließen mit ShutOffSurfaceFeatureData.FlipFaceTangentTo auf die gegenüberliegende Fläche und zurück. Danach ruft es Feature.ModifyDefinition auf.

Ändern: Nach ShutOffSurfaceFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du ShutOffSurfaceFeatureData.ReleaseSelectionAccess auf.

Status: Die Werte aus swShutOffSurfaceFeatureStatus_e heißen STATUS_SHUTOFF_COMPLETE, STATUS_SHUTOFF_INCOMPLETE und STATUS_SHUTOFF_REDUNDANT, sie beginnen also nicht wie sonst mit sw.

Eigenschaften und Methoden

Eigenschaften 4, davon 4 beschrieben

NameBeschreibung
EdgesLiest oder setzt die Kanten, die die geschlossenen Schleifen der Abschaltflächen bilden.
KnitLiest oder setzt, ob die Flächen der Abschaltflächen vernäht werden.
LoopEdgesLiefert die Kanten einer Schleife der Abschaltflächen.
LoopPatchTypeLiest oder setzt, wie eine Schleife der Abschaltflächen geschlossen wird: gar nicht, mit Kontakt oder tangential.

Methoden 9, davon 9 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Abschaltflächen zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
FlipFaceTangentToSchließt die Öffnung einer Schleife tangential an die gegenüberliegende angrenzende Fläche.
GetEdgeCountLiefert die Zahl aller Kanten in den Schleifen der Abschaltflächen.
GetFaceTangentToLiefert die angrenzende Fläche, an die eine Schleife tangential geschlossen wird.
GetLoopCountLiefert die Zahl der geschlossenen Schleifen der Abschaltflächen.
GetLoopEdgeCountLiefert die Zahl der Kanten in einer Schleife der Abschaltflächen.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Abschaltflächen nicht geändert hast.
SetAllPatchTypesStellt für alle Schleifen der Abschaltflächen ein, wie sie geschlossen werden.
StatusLiefert, ob die Abschaltflächen vollständig, unvollständig oder überzählig sind.

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

Siehe auch

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

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