SolidWorksMakroprogrammierung

Objekt · SldWorks

SurfExtrudeFeatureData-Objekt

Die Definition einer linear ausgetragenen Oberfläche: Richtungen, Endbedingungen, Tiefen, Formschrägen und Abschlüsse.

Deklaration Dim x As SldWorks.SurfExtrudeFeatureData · in der englischen .NET-Hilfe: ISurfExtrudeFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
BothDirectionsLiest oder setzt, ob die Oberfläche in beide Richtungen ausgetragen wird.
D1CapEndLiest oder setzt, ob das Ende der Oberfläche in Richtung 1 mit einer Fläche geschlossen wird.
D1DraftAngleLiest oder setzt den Winkel der Formschräge in Richtung 1.
D1DraftOnLiest oder setzt, ob die Oberfläche in Richtung 1 eine Formschräge bekommt.
D1DraftOutwardLiest oder setzt, ob die Formschräge in Richtung 1 nach außen oder nach innen geht.
D2CapEndLiest oder setzt, ob das Ende der Oberfläche in Richtung 2 mit einer Fläche geschlossen wird.
D2DraftAngleLiest oder setzt den Winkel der Formschräge in Richtung 2.
D2DraftOnLiest oder setzt, ob die Oberfläche in Richtung 2 eine Formschräge bekommt.
D2DraftOutwardLiest oder setzt, ob die Formschräge in Richtung 2 nach außen oder nach innen geht.
DeleteOriginalFaceLiest oder setzt, ob die Ausgangsflächen der ausgetragenen Oberfläche gelöscht werden.
KnitResultLiest oder setzt, ob die Körper zusammengefügt werden, die beim Löschen der Ausgangsflächen entstehen.
ReverseDirectionLiest oder setzt, ob die Oberfläche in die Gegenrichtung ausgetragen wird.

Methoden 14, davon 14 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die ausgetragene Oberfläche zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetDepthLiefert die Tiefe der ausgetragenen Oberfläche in Vorwärts- oder Gegenrichtung.
GetEndConditionLiefert die Endbedingung der ausgetragenen Oberfläche in Vorwärts- oder Gegenrichtung.
GetFaceLiefert die Fläche der Endbedingung in Vorwärts- oder Gegenrichtung.
GetReverseOffsetLiefert, ob der Abstand der Endbedingung in Vorwärts- oder Gegenrichtung umgekehrt ist.
GetTranslateSurfaceLiefert, ob die Referenzfläche der Endbedingung in Vorwärts- oder Gegenrichtung verschoben wird.
GetVertexLiefert den Eckpunkt der Endbedingung in Vorwärts- oder Gegenrichtung.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die ausgetragene Oberfläche nicht geändert hast.
SetDepthSetzt die Tiefe der ausgetragenen Oberfläche in Vorwärts- oder Gegenrichtung.
SetEndConditionSetzt die Endbedingung der ausgetragenen Oberfläche in Vorwärts- oder Gegenrichtung.
SetFaceSetzt die Fläche der Endbedingung in Vorwärts- oder Gegenrichtung.
SetReverseOffsetSetzt, ob der Abstand der Endbedingung in Vorwärts- oder Gegenrichtung umgekehrt wird.
SetTranslateSurfaceSetzt, ob die Referenzfläche der Endbedingung in Vorwärts- oder Gegenrichtung verschoben wird.
SetVertexSetzt 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.