SolidWorksMakroprogrammierung

Objekt · SldWorks

SweepFeatureData-Objekt

Die Definition einer Austragung (ausgetragener Aufsatz, Schnitt oder Oberfläche): Profil, Pfad, Leitkurven, Ausrichtung, Verdrehung, Dünnwand und betroffene Körper.

Deklaration Dim x As SldWorks.SweepFeatureData · in der englischen .NET-Hilfe: ISweepFeatureData

Beschreibung

SweepFeatureData gibt Zugriff auf eine Austragung: einen ausgetragenen Aufsatz, einen ausgetragenen Schnitt oder eine ausgetragene Oberfläche. Ein Profil wird entlang eines Pfads geführt, auf Wunsch mit Leitkurven. Das Profil ist eine Skizze, ein Kreisprofil mit Durchmesser oder bei Schnitten ein Werkzeugkörper. Wie sich das Profil entlang des Pfads ausrichtet und verdreht, legen SweepFeatureData.TwistControlType und SweepFeatureData.PathAlignmentType fest. Die Grundbefehle gibt es seit SOLIDWORKS 2001Plus, Kreisprofil und Richtung seit 2017, Verdrehung in zwei Richtungen und Dünnwand-Anlage seit 2018.

Veraltet sind SweepFeatureData.StartDirectionVector und SweepFeatureData.EndDirectionVector, einen Nachfolger nennt die Hilfe nicht.

Zugriff

Beispiel

' Legt aus drei vorhandenen Skizzen einen ausgetragenen Aufsatz an und gibt die
' Leitkurven aus, wie im Hilfebeispiel „Insert Swept-boss Feature“.
' Vorbedingung: Ein Teil ist offen. Skizze1 ist das geschlossene Profil, Skizze2
'               der Pfad, Skizze3 eine Leitkurve, die das Profil berührt (in einer englischen
'               SOLIDWORKS-Oberfläche heißen sie Sketch1 bis Sketch3).
' Ergebnis:     Ein neuer ausgetragener Aufsatz, die Leitkurven stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swExt As SldWorks.ModelDocExtension
    Dim swDaten As SldWorks.SweepFeatureData
    Dim swFeat As SldWorks.Feature
    Dim vArten As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swExt = swModel.Extension

    swModel.ClearSelection2 True
    swExt.SelectByID2 "Skizze1", "SKETCH", 0, 0, 0, False, 1, Nothing, 0   ' Profil
    swExt.SelectByID2 "Skizze2", "SKETCH", 0, 0, 0, True, 4, Nothing, 0    ' Pfad
    swExt.SelectByID2 "Skizze3", "SKETCH", 0, 0, 0, True, 2, Nothing, 0    ' Leitkurve

    Set swDaten = swModel.FeatureManager.CreateDefinition(swFmSweep)
    swDaten.TwistControlType = swTwistControlFollowPath
    swDaten.PathAlignmentType = swTangencyNone
    swDaten.Merge = True
    Set swFeat = swModel.FeatureManager.CreateFeature(swDaten)
    If swFeat Is Nothing Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": " & swDaten.GetGuideCurvesCount & " Leitkurve(n)"
    vArten = swDaten.GetGuideCurvesType
    If Not IsEmpty(vArten) Then
        For i = 0 To UBound(vArten)
            Debug.Print "  Art " & vArten(i)                    ' swSelectType_e
        Next i
    End If
    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Anlegen: Wie im Hilfethema „Sweep Features and SweepFeatureData Objects“ beschrieben, wählst du vor FeatureManager.CreateDefinition aus:

  • Skizzenprofil (Fläche, Kante oder Kurve) mit der Markierung 1. Bei einem Aufsatz muss es geschlossen sein.
  • Kreisprofil: eine Skizzenlinie, Kante oder Kurve mit der Markierung 4. Einen eigenen Pfad gibt es dann nicht.
  • Werkzeugkörper (nur bei Schnitten) mit 1, den Körper, der geschnitten wird, mit 2048.
  • Pfad mit der Markierung 4. Sein Anfang muss auf der Ebene des Profils liegen; reicht er auf beide Seiten des Profils, geht eine Austragung in zwei Richtungen (SweepFeatureData.Direction).
  • Leitkurven mit der Markierung 2, nur bei Skizzenprofilen und nicht bei zwei Richtungen.
  • Richtungsvektor mit der Markierung 128. Dann setzt du SweepFeatureData.PathAlignmentType auf swTangencyDirectionVector und SweepFeatureData.TwistControlType auf swTwistControlFollowPath.

Danach setzt du die Werte und rufst FeatureManager.CreateFeature auf. Eine Dünnwand-Austragung geht nur beim Anlegen: SweepFeatureData.ThinFeature, SweepFeatureData.ThinWallType und SweepFeatureData.SetWallThickness vor CreateFeature.

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

Einheiten: Verdrehwinkel sind Bogenmaß. Für Durchmesser und Wandstärke nennt die Hilfe keine Einheit; es sind Meter (0.008 ergab ein Kreisprofil Ø 8 mm, 0.001 eine Wand von 1 mm).

Beispiel: Die Hilfe hat viele weitere VBA-Beispiele, etwa „Insert Swept-cut Feature Using Tool Body“, „Insert Swept-cut Feature with Bidirectional Twist“ und „Insert Swept-cut Thin-walled Feature“.

Eigenschaften und Methoden

Eigenschaften 29, davon 27 beschrieben, 2 veraltet

NameBeschreibung
AdvancedSmoothingLiest oder setzt, ob die Austragung erweitert geglättet wird.
AlignWithEndFacesLiest oder setzt, ob die Austragung an den Endflächen ausgerichtet wird.
AssemblyFeatureScopeLiest oder setzt, ob ein ausgetragener Schnitt in einer Baugruppe nur ausgewählte Komponenten schneidet.
AutoSelectLiest oder setzt, ob die Austragung in einem Mehrkörperteil automatisch alle Körper beeinflusst.
AutoSelectComponentsLiest oder setzt, ob ein ausgetragener Schnitt in einer Baugruppe die betroffenen Komponenten automatisch wählt.
CircularProfileLiest oder setzt, ob die Austragung ein Kreisprofil statt einer Skizze oder eines Werkzeugkörpers nutzt.
CircularProfileDiameterLiest oder setzt den Durchmesser des Kreisprofils der Austragung.
D1ReverseTwistDirLiest oder setzt, ob die Verdrehung der Austragung in Richtung 1 umgekehrt wird.
D2ReverseTwistDirLiest oder setzt, ob die Verdrehung der Austragung in Richtung 2 umgekehrt wird.
DirectionLiest oder setzt, in welche Richtung die Austragung entlang des Pfads läuft: Richtung 1, Richtung 2 oder beide.
EndDirectionVectorveraltet
EndTangencyTypeLiest oder setzt die Tangente am Ende des Pfads der Austragung.
FeatureScopeLiest oder setzt, ob die Austragung in einem Mehrkörperteil nur bestimmte Körper beeinflusst.
FeatureScopeBodiesLiest oder setzt die Volumenkörper, die die Austragung in einem Mehrkörperteil beeinflusst.
GuideCurvesLiest oder setzt die Leitkurven der Austragung.
MaintainTangencyLiest oder setzt, ob die Austragung tangentiale Flächen zusammenführt.
MergeLiest oder setzt, ob ein ausgetragener Aufsatz in einem Mehrkörperteil mit den Körpern verschmilzt.
MergeSmoothFacesLiest oder setzt, ob eine Austragung mit Leitkurven glatte Flächen zusammenführt.
PathLiest oder setzt den Pfad der Austragung.
PathAlignmentTypeLiest oder setzt, wie das Profil der Austragung am Pfad ausgerichtet wird.
ProfileLiest oder setzt das Skizzenprofil oder den Werkzeugkörper der Austragung.
PropagateFeatureToPartsLiest oder setzt, ob ein ausgetragener Schnitt in einer Baugruppe in alle betroffenen Teile übernommen wird.
StartDirectionVectorveraltet
StartTangencyTypeLiest oder setzt die Tangente am Anfang des Pfads der Austragung.
SweepTypeLiefert, ob die Austragung ein Aufsatz, ein Schnitt oder eine Oberfläche ist.
TangentPropagationLiest oder setzt, ob sich die Austragung bis zur nächsten tangentialen Kante fortsetzt.
ThinFeatureLiest oder setzt, ob die Austragung als Dünnwand-Feature entsteht.
ThinWallTypeLiest oder setzt, in welche Richtung die Wand einer Dünnwand-Austragung aufgetragen wird.
TwistControlTypeLiest oder setzt, wie das Profil der Austragung entlang des Pfads ausgerichtet und verdreht wird.

Methoden 18, davon 18 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Austragung zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetCutSweepOptionLiefert die Art des Profils eines ausgetragenen Schnitts: Skizzenprofil oder Werkzeugkörper.
GetD2TwistAngleLiefert den Verdrehwinkel einer Austragung in zwei Richtungen für Richtung 2.
GetFeatureScopeBodiesCountLiefert die Zahl der Volumenkörper, die die Austragung in einem Mehrkörperteil beeinflusst.
GetGuideCurvesCountLiefert die Zahl der Leitkurven der Austragung.
GetGuideCurvesTypeLiefert die Art jeder Leitkurve der Austragung.
GetPathAlignmentDirectionVectorLiefert das Objekt, das den Richtungsvektor für die Ausrichtung des Profils festlegt, und seine Art.
GetPathTypeLiefert die Art des Pfads der Austragung.
GetProfileTypeLiefert die Art des Profils der Austragung.
GetTwistAngleLiefert den Verdrehwinkel der Austragung, bei zwei Richtungen den für Richtung 1.
GetWallThicknessLiefert die Wandstärke einer Dünnwand-Austragung in Richtung 1 oder 2.
IsBossFeatureLiefert, ob die Austragung ein Aufsatz ist.
IsThinFeatureLiefert, ob die Austragung ein Dünnwand-Feature ist.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Austragung nicht geändert hast.
SetD2TwistAngleSetzt den Verdrehwinkel einer Austragung in zwei Richtungen für Richtung 2.
SetPathAlignmentDirectionVectorSetzt das Objekt, das den Richtungsvektor für die Ausrichtung des Profils festlegt.
SetTwistAngleSetzt den Verdrehwinkel der Austragung, bei zwei Richtungen den für Richtung 1.
SetWallThicknessSetzt die Wandstärke einer Dünnwand-Austragung in Richtung 1 oder 2.

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

Siehe auch

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

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