Objekt · SldWorks
LoftFeatureData-Objekt
Die Feature-Daten einer Ausformung (Loft) als Aufsatz oder Schnitt: Profile, Leitkurven, Mittellinie, Tangentialität und Bedingungen an Anfang und Ende, dünne Wand und Feature-Bereich.
Beschreibung
LoftFeatureData gibt Zugriff auf eine Ausformung (Loft). Eine Ausformung verbindet Profile zu einem Körper, wahlweise geführt von Leitkurven oder einer Mittellinie. Sie fügt als Aufsatz oder Basis Material hinzu (Typname Blend) oder schneidet es als Schnitt weg (Typname BlendCut). Du liest die Daten mit Feature.GetDefinition und übernimmst Änderungen mit Feature.ModifyDefinition. Die meisten Befehle gibt es seit SOLIDWORKS 2001Plus, die für Feature-Bereich, Verschmelzen und die Zahl der Schnitte seit 2003, die Bedingungen an Anfang und Ende und den Einfluss der Leitkurven seit 2005, die Auswahlpunkte seit 2010.
Zugriff
Feature.GetDefinition: aus einem Feature mit dem TypnamenBlend(Aufsatz oder Basis) oderBlendCut(Schnitt)
Neu anlegen kannst du eine Ausformung mit FeatureManager.InsertProtrusionBlend2 (Aufsatz) oder FeatureManager.InsertCutBlend (Schnitt). In der Liste der Datenobjekte von FeatureManager.CreateDefinition steht die Ausformung nicht.
Beispiel
' Gibt Art, Profile und Leitkurven mit ihrer Tangentialität aus und lässt die
' Leitkurven danach über die ganze Ausformung wirken.
' Vorbedingung: Ein Teil mit einer Ausformung ist offen, die Ausformung ist im
' FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, die Ausformung ist geändert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swFeat As SldWorks.Feature
Dim swDaten As SldWorks.LoftFeatureData
Dim swProfil As SldWorks.Feature
Dim vProfile As Variant
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelBODYFEATURES Then Exit Sub
Set swFeat = swSelMgr.GetSelectedObject6(1, -1)
If swFeat.GetTypeName2 <> "Blend" And swFeat.GetTypeName2 <> "BlendCut" Then Exit Sub
swModel.ClearSelection2 True
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swFeat.Name & ", Aufsatz: " & swDaten.IsBossFeature & ", geschlossen: " & swDaten.Close
vProfile = swDaten.Profiles
If Not IsEmpty(vProfile) Then
For i = 0 To UBound(vProfile)
Set swProfil = vProfile(i)
Debug.Print " Profil " & i + 1 & ": " & swProfil.Name
Next i
End If
For i = 0 To swDaten.GetGuideCurvesCount - 1
' Wert aus swTangencyType_e
Debug.Print " Leitkurve " & i + 1 & ": Tangentialität " & swDaten.GetGuideTangencyType(i)
Next i
If swDaten.GetGuideCurvesCount = 0 Then
swDaten.ReleaseSelectionAccess
Exit Sub
End If
swDaten.GuideCurveInfluence = swGuideCurveInfluenceNextGlobal
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End SubBemerkungen
Ändern: Rufe erst LoftFeatureData.AccessSelections auf. Das setzt das Modell vor das Feature zurück. Dann liest oder änderst du die Auswahlen und übernimmst Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit LoftFeatureData.ReleaseSelectionAccess auf. Bei Profilen, Leitkurven, Mittellinie, Richtungsvektoren und Feature-Bereich verweist die Hilfe ausdrücklich auf diesen Ablauf („Accessing Selections that Define Features“).
Profile und Leitkurven: Jedes Profil aus LoftFeatureData.Profiles ist ein Feature. Die Sketch dazu holst du mit Feature.GetSpecificFeature2. Beim Anlegen mit FeatureManager.InsertProtrusionBlend2 wählst du die Profile mit der Markierung 1 aus, die Leitkurven mit 2, die Mittellinie mit 4. Die Leitkurven zählt das Hilfebeispiel „Get Guide Curves in Loft Feature“ ab 0.
Bedingungen an Anfang und Ende: Die Formschräge der Bedingungen (LoftFeatureData.StartConstraintDraftAngle und die übrigen Constraint-Eigenschaften) gilt nur, wenn LoftFeatureData.StartConstraintApplyToAll und LoftFeatureData.EndConstraintApplyToAll True sind. Diese beiden kannst du nur lesen.
Einheiten: Die Hilfe nennt keine. Wandstärken sind Meter (2-mm-Wand ergab rund 15 700 mm³), Auswahlpunkte ebenso, Formschrägen vermutlich Bogenmaß wie sonst in der API. Ob die Tangentenlängen eine Länge oder ein Faktor sind, ist offen. FeatureManager.InsertProtrusionBlend2 setzt sie im Hilfebeispiel auf 1.
Mittellinie: LoftFeatureData.Centerline liefert ein ICenterLine. Das ist in der Hilfe sonst die Mittellinie einer Zeichnung (CenterLine). Vermutlich kommt bei einer Ausformung eher die Skizze oder Kurve der Mittellinie zurück. Die Hilfe zeigt das an keinem Beispiel.
Eigenschaften und Methoden
Eigenschaften 28, davon 28 beschrieben
| Name | Beschreibung |
|---|---|
| AdvancedSmoothing | Liest oder setzt, ob bei der Ausformung das erweiterte Glätten eingeschaltet ist. |
| AutoSelect | Liest oder setzt, ob die Ausformung in einem Mehrkörperteil automatisch alle Körper beeinflusst. |
| Centerline | Liest oder setzt die Mittellinie der Ausformung. |
| Close | Liest oder setzt, ob die Ausformung geschlossen ist. |
| EndConstraintApplyToAll | Liefert, ob für das Ende der Ausformung eine Bedingung festgelegt ist. |
| EndConstraintDraftAngle | Liest oder setzt die Formschräge der Bedingung am Ende der Ausformung. |
| EndConstraintDraftAngleDirection | Liest oder setzt, ob die Formschräge der Bedingung am Ende der Ausformung umgekehrt ist. |
| EndDirectionVector | Liest oder setzt den Richtungsvektor, in dem die Ausformung endet. |
| EndTangencyType | Liest oder setzt die Tangentialität am Ende der Ausformung. |
| EndTangentLength | Liest oder setzt die Tangentenlänge am Ende der Ausformung. |
| FeatureScope | Liest oder setzt, ob die Ausformung in einem Mehrkörperteil nur bestimmte Körper beeinflusst. |
| FeatureScopeBodies | Liest oder setzt die Volumenkörper, die die Ausformung in einem Mehrkörperteil beeinflusst. |
| GuideCurveInfluence | Liest oder setzt, wie weit die Leitkurven der Ausformung wirken. |
| GuideCurves | Liest oder setzt die Leitkurven der Ausformung. |
| MaintainTangency | Liest oder setzt, ob die Ausformung die Tangentialität der Profile erhält. |
| Merge | Liest oder setzt, ob die Ausformung in einem Mehrkörperteil mit den vorhandenen Körpern verschmilzt. |
| NumberOfSections | Liest oder setzt die Zahl der Schnitte der Ausformung. |
| PickPoints | Liest oder setzt die Auswahlpunkte der Ausformung. |
| Profiles | Liest oder setzt die Profile der Ausformung. |
| ReverseEndTangentDirection | Liest oder setzt, ob die Tangentenrichtung am Ende der Ausformung umgekehrt ist. |
| ReverseStartTangentDirection | Liest oder setzt, ob die Tangentenrichtung am Anfang der Ausformung umgekehrt ist. |
| StartConstraintApplyToAll | Liefert, ob für den Anfang der Ausformung eine Bedingung festgelegt ist. |
| StartConstraintDraftAngle | Liest oder setzt die Formschräge der Bedingung am Anfang der Ausformung. |
| StartConstraintDraftAngleDirection | Liest oder setzt, ob die Formschräge der Bedingung am Anfang der Ausformung umgekehrt ist. |
| StartDirectionVector | Liest oder setzt den Richtungsvektor, in dem die Ausformung beginnt. |
| StartTangencyType | Liest oder setzt die Tangentialität am Anfang der Ausformung. |
| StartTangentLength | Liest oder setzt die Tangentenlänge am Anfang der Ausformung. |
| ThinWallType | Liest oder setzt, in welche Richtung die Wand einer dünnwandigen Ausformung aufgetragen wird. |
Methoden 12, davon 12 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Ausformung zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetFeatureScopeBodiesCount | Liefert die Zahl der Volumenkörper, die die Ausformung in einem Mehrkörperteil beeinflusst. |
| GetGuideCurvesCount | Liefert die Zahl der Leitkurven der Ausformung. |
| GetGuideCurvesType | Liefert die Art jeder Leitkurve der Ausformung. |
| GetGuideTangencyType | Liefert die Tangentialität, mit der die Ausformung an eine Leitkurve anschließt. |
| GetProfileCount | Liefert die Zahl der Profile der Ausformung. |
| GetWallThickness | Liefert die Wandstärke einer dünnwandigen Ausformung in Vorwärts- oder Gegenrichtung. |
| IsBossFeature | Liefert, ob die Ausformung ein Aufsatz ist. |
| IsThinFeature | Liefert, ob die Ausformung dünnwandig ist. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Ausformung nicht geändert hast. |
| SetGuideTangencyType | Setzt die Tangentialität, mit der die Ausformung an eine Leitkurve anschließt. |
| SetWallThickness | Setzt die Wandstärke einer dünnwandigen Ausformung in Vorwärts- oder Gegenrichtung. |
Nicht aufgeführt sind 8 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ILoftFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.