Objekt · SldWorks
SurfExtrudeFeatureData-Objekt
Die Definition einer linear ausgetragenen Oberfläche: Richtungen, Endbedingungen, Tiefen, Formschrägen und Abschlüsse.
Beschreibung
SurfExtrudeFeatureData gibt Zugriff auf eine linear ausgetragene Oberfläche. Wie bei einer Extrusion legst du für jede Richtung die Endbedingung und die Tiefe fest, dazu auf Wunsch eine Formschräge und eine Abschlussfläche am Ende. Die Methoden mit dem Parameter Forward oder Fwd lesen und setzen die Werte nach Angabe der Hilfe für die Vorwärtsrichtung (True) oder die Gegenrichtung (False), vermutlich also für Richtung 1 und Richtung 2. Die Grundbefehle gibt es seit SOLIDWORKS 2001Plus SP01, Formschrägen, Abschlüsse und das Löschen der Ausgangsflächen seit SOLIDWORKS 2017.
Zugriff
Feature.GetDefinition: bei einem Feature mit dem TypnamenExtruRefSurface
Beispiel
' Gibt Endbedingungen und Tiefen der ausgewählten linear ausgetragenen Oberfläche
' aus und setzt Richtung 1 auf „Blind“ mit 30 mm Tiefe.
' Vorbedingung: Ein Teil mit einer linear ausgetragenen Oberfläche ist offen, das
' Feature ist im FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, die Oberfläche ist 30 mm tief.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swFeat As SldWorks.Feature
Dim swDaten As SldWorks.SurfExtrudeFeatureData
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 <> "ExtruRefSurface" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swFeat.Name & ": Richtung 1 Endbedingung " & swDaten.GetEndCondition(True) & _
", Tiefe " & swDaten.GetDepth(True) * 1000 & " mm"
If swDaten.BothDirections Then
Debug.Print "Richtung 2: Endbedingung " & swDaten.GetEndCondition(False) & _
", Tiefe " & swDaten.GetDepth(False) * 1000 & " mm"
End If
swDaten.SetEndCondition True, swEndCondBlind
swDaten.SetDepth True, 0.03
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End SubBemerkungen
Anlegen: Die Oberfläche legst du mit FeatureManager.FeatureExtruRefSurface3 an, nachdem du die Skizze oder Fläche ausgewählt hast. So macht es das Hilfebeispiel „Insert Extruded Surface“, das danach alle Werte ausliest.
Ändern: Nach SurfExtrudeFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du SurfExtrudeFeatureData.ReleaseSelectionAccess auf.
Abhängigkeiten: Die Werte für Richtung 2 gelten nur bei SurfExtrudeFeatureData.BothDirections True, Winkel und Richtung einer Formschräge nur bei eingeschalteter Formschräge, SurfExtrudeFeatureData.DeleteOriginalFace und SurfExtrudeFeatureData.KnitResult nur bei BothDirections False.
Einheiten: Tiefen sind Meter, Winkel Bogenmaß (SetDepth 0.02 ergab 20 mm, D1DraftAngle = 5 * PI / 180 eine Formschräge von 5°); die Seiten dieses Objekts nennen keine Einheit. FeatureManager.FeatureExtruRefSurface3 nimmt die Tiefen in Metern und die Winkel im Bogenmaß.
Eigenschaften und Methoden
Eigenschaften 12, davon 12 beschrieben
| Name | Beschreibung |
|---|---|
| BothDirections | Liest oder setzt, ob die Oberfläche in beide Richtungen ausgetragen wird. |
| D1CapEnd | Liest oder setzt, ob das Ende der Oberfläche in Richtung 1 mit einer Fläche geschlossen wird. |
| D1DraftAngle | Liest oder setzt den Winkel der Formschräge in Richtung 1. |
| D1DraftOn | Liest oder setzt, ob die Oberfläche in Richtung 1 eine Formschräge bekommt. |
| D1DraftOutward | Liest oder setzt, ob die Formschräge in Richtung 1 nach außen oder nach innen geht. |
| D2CapEnd | Liest oder setzt, ob das Ende der Oberfläche in Richtung 2 mit einer Fläche geschlossen wird. |
| D2DraftAngle | Liest oder setzt den Winkel der Formschräge in Richtung 2. |
| D2DraftOn | Liest oder setzt, ob die Oberfläche in Richtung 2 eine Formschräge bekommt. |
| D2DraftOutward | Liest oder setzt, ob die Formschräge in Richtung 2 nach außen oder nach innen geht. |
| DeleteOriginalFace | Liest oder setzt, ob die Ausgangsflächen der ausgetragenen Oberfläche gelöscht werden. |
| KnitResult | Liest oder setzt, ob die Körper zusammengefügt werden, die beim Löschen der Ausgangsflächen entstehen. |
| ReverseDirection | Liest oder setzt, ob die Oberfläche in die Gegenrichtung ausgetragen wird. |
Methoden 14, davon 14 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die ausgetragene Oberfläche zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetDepth | Liefert die Tiefe der ausgetragenen Oberfläche in Vorwärts- oder Gegenrichtung. |
| GetEndCondition | Liefert die Endbedingung der ausgetragenen Oberfläche in Vorwärts- oder Gegenrichtung. |
| GetFace | Liefert die Fläche der Endbedingung in Vorwärts- oder Gegenrichtung. |
| GetReverseOffset | Liefert, ob der Abstand der Endbedingung in Vorwärts- oder Gegenrichtung umgekehrt ist. |
| GetTranslateSurface | Liefert, ob die Referenzfläche der Endbedingung in Vorwärts- oder Gegenrichtung verschoben wird. |
| GetVertex | Liefert den Eckpunkt der Endbedingung in Vorwärts- oder Gegenrichtung. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die ausgetragene Oberfläche nicht geändert hast. |
| SetDepth | Setzt die Tiefe der ausgetragenen Oberfläche in Vorwärts- oder Gegenrichtung. |
| SetEndCondition | Setzt die Endbedingung der ausgetragenen Oberfläche in Vorwärts- oder Gegenrichtung. |
| SetFace | Setzt die Fläche der Endbedingung in Vorwärts- oder Gegenrichtung. |
| SetReverseOffset | Setzt, ob der Abstand der Endbedingung in Vorwärts- oder Gegenrichtung umgekehrt wird. |
| SetTranslateSurface | Setzt, ob die Referenzfläche der Endbedingung in Vorwärts- oder Gegenrichtung verschoben wird. |
| SetVertex | Setzt den Eckpunkt der Endbedingung in Vorwärts- oder Gegenrichtung. |
Nicht aufgeführt sind 5 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ISurfExtrudeFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.