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.
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
FeatureManager.CreateDefinitionmitswFmSweep(Aufsatz),swFmSweepCut(Schnitt) oderswFmRefSurface(Oberfläche): eine neue Definition mit Standardwerten fürFeatureManager.CreateFeatureFeature.GetDefinition: bei einem Feature mit dem TypnamenSweep,SweepCutoderSweepRefSurface
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 SubBemerkungen
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, mit2048. - 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 duSweepFeatureData.PathAlignmentTypeaufswTangencyDirectionVectorundSweepFeatureData.TwistControlTypeaufswTwistControlFollowPath.
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
| Name | Beschreibung |
|---|---|
| AdvancedSmoothing | Liest oder setzt, ob die Austragung erweitert geglättet wird. |
| AlignWithEndFaces | Liest oder setzt, ob die Austragung an den Endflächen ausgerichtet wird. |
| AssemblyFeatureScope | Liest oder setzt, ob ein ausgetragener Schnitt in einer Baugruppe nur ausgewählte Komponenten schneidet. |
| AutoSelect | Liest oder setzt, ob die Austragung in einem Mehrkörperteil automatisch alle Körper beeinflusst. |
| AutoSelectComponents | Liest oder setzt, ob ein ausgetragener Schnitt in einer Baugruppe die betroffenen Komponenten automatisch wählt. |
| CircularProfile | Liest oder setzt, ob die Austragung ein Kreisprofil statt einer Skizze oder eines Werkzeugkörpers nutzt. |
| CircularProfileDiameter | Liest oder setzt den Durchmesser des Kreisprofils der Austragung. |
| D1ReverseTwistDir | Liest oder setzt, ob die Verdrehung der Austragung in Richtung 1 umgekehrt wird. |
| D2ReverseTwistDir | Liest oder setzt, ob die Verdrehung der Austragung in Richtung 2 umgekehrt wird. |
| Direction | Liest oder setzt, in welche Richtung die Austragung entlang des Pfads läuft: Richtung 1, Richtung 2 oder beide. |
| EndDirectionVector | veraltet |
| EndTangencyType | Liest oder setzt die Tangente am Ende des Pfads der Austragung. |
| FeatureScope | Liest oder setzt, ob die Austragung in einem Mehrkörperteil nur bestimmte Körper beeinflusst. |
| FeatureScopeBodies | Liest oder setzt die Volumenkörper, die die Austragung in einem Mehrkörperteil beeinflusst. |
| GuideCurves | Liest oder setzt die Leitkurven der Austragung. |
| MaintainTangency | Liest oder setzt, ob die Austragung tangentiale Flächen zusammenführt. |
| Merge | Liest oder setzt, ob ein ausgetragener Aufsatz in einem Mehrkörperteil mit den Körpern verschmilzt. |
| MergeSmoothFaces | Liest oder setzt, ob eine Austragung mit Leitkurven glatte Flächen zusammenführt. |
| Path | Liest oder setzt den Pfad der Austragung. |
| PathAlignmentType | Liest oder setzt, wie das Profil der Austragung am Pfad ausgerichtet wird. |
| Profile | Liest oder setzt das Skizzenprofil oder den Werkzeugkörper der Austragung. |
| PropagateFeatureToParts | Liest oder setzt, ob ein ausgetragener Schnitt in einer Baugruppe in alle betroffenen Teile übernommen wird. |
| StartDirectionVector | veraltet |
| StartTangencyType | Liest oder setzt die Tangente am Anfang des Pfads der Austragung. |
| SweepType | Liefert, ob die Austragung ein Aufsatz, ein Schnitt oder eine Oberfläche ist. |
| TangentPropagation | Liest oder setzt, ob sich die Austragung bis zur nächsten tangentialen Kante fortsetzt. |
| ThinFeature | Liest oder setzt, ob die Austragung als Dünnwand-Feature entsteht. |
| ThinWallType | Liest oder setzt, in welche Richtung die Wand einer Dünnwand-Austragung aufgetragen wird. |
| TwistControlType | Liest oder setzt, wie das Profil der Austragung entlang des Pfads ausgerichtet und verdreht wird. |
Methoden 18, davon 18 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Austragung zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetCutSweepOption | Liefert die Art des Profils eines ausgetragenen Schnitts: Skizzenprofil oder Werkzeugkörper. |
| GetD2TwistAngle | Liefert den Verdrehwinkel einer Austragung in zwei Richtungen für Richtung 2. |
| GetFeatureScopeBodiesCount | Liefert die Zahl der Volumenkörper, die die Austragung in einem Mehrkörperteil beeinflusst. |
| GetGuideCurvesCount | Liefert die Zahl der Leitkurven der Austragung. |
| GetGuideCurvesType | Liefert die Art jeder Leitkurve der Austragung. |
| GetPathAlignmentDirectionVector | Liefert das Objekt, das den Richtungsvektor für die Ausrichtung des Profils festlegt, und seine Art. |
| GetPathType | Liefert die Art des Pfads der Austragung. |
| GetProfileType | Liefert die Art des Profils der Austragung. |
| GetTwistAngle | Liefert den Verdrehwinkel der Austragung, bei zwei Richtungen den für Richtung 1. |
| GetWallThickness | Liefert die Wandstärke einer Dünnwand-Austragung in Richtung 1 oder 2. |
| IsBossFeature | Liefert, ob die Austragung ein Aufsatz ist. |
| IsThinFeature | Liefert, ob die Austragung ein Dünnwand-Feature ist. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Austragung nicht geändert hast. |
| SetD2TwistAngle | Setzt den Verdrehwinkel einer Austragung in zwei Richtungen für Richtung 2. |
| SetPathAlignmentDirectionVector | Setzt das Objekt, das den Richtungsvektor für die Ausrichtung des Profils festlegt. |
| SetTwistAngle | Setzt den Verdrehwinkel der Austragung, bei zwei Richtungen den für Richtung 1. |
| SetWallThickness | Setzt 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.