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.
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
Feature.GetDefinition: aus einem Abschaltflächen-Feature
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Edges | Liest oder setzt die Kanten, die die geschlossenen Schleifen der Abschaltflächen bilden. |
| Knit | Liest oder setzt, ob die Flächen der Abschaltflächen vernäht werden. |
| LoopEdges | Liefert die Kanten einer Schleife der Abschaltflächen. |
| LoopPatchType | Liest oder setzt, wie eine Schleife der Abschaltflächen geschlossen wird: gar nicht, mit Kontakt oder tangential. |
Methoden 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Abschaltflächen zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| FlipFaceTangentTo | Schließt die Öffnung einer Schleife tangential an die gegenüberliegende angrenzende Fläche. |
| GetEdgeCount | Liefert die Zahl aller Kanten in den Schleifen der Abschaltflächen. |
| GetFaceTangentTo | Liefert die angrenzende Fläche, an die eine Schleife tangential geschlossen wird. |
| GetLoopCount | Liefert die Zahl der geschlossenen Schleifen der Abschaltflächen. |
| GetLoopEdgeCount | Liefert die Zahl der Kanten in einer Schleife der Abschaltflächen. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Abschaltflächen nicht geändert hast. |
| SetAllPatchTypes | Stellt für alle Schleifen der Abschaltflächen ein, wie sie geschlossen werden. |
| Status | Liefert, 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.