Objekt · SldWorks
BoundaryBossFeatureData-Objekt
Die Feature-Daten eines Begrenzungsfeatures als Aufsatz oder Basis: Kurven in zwei Richtungen, Tangentialität, Einfluss, Formschräge, dünne Wand und Feature-Bereich.
Beschreibung
BoundaryBossFeatureData gibt Zugriff auf ein Begrenzungsfeature, das als Aufsatz oder Basis Material hinzufügt (Typname NetBlend). Ein Begrenzungsfeature spannt einen Körper zwischen Kurven in Richtung 1 und optional in Richtung 2 auf. Die Kurven können Skizzenkurven, Flächen oder Kanten sein. Du liest die Daten mit Feature.GetDefinition und übernimmst Änderungen mit Feature.ModifyDefinition. Alle Befehle gibt es seit SOLIDWORKS 2016.
Zugriff
Feature.GetDefinition: aus einem Feature mit dem TypnamenNetBlend
Neu anlegen kannst du ein Begrenzungsfeature mit FeatureManager.InsertNetBlend2, vorher legst du mit FeatureManager.SetNetBlendCurveData und FeatureManager.SetNetBlendDirectionData die Daten der Kurven und Richtungen fest.
Beispiel
' Gibt für jede Kurve in Richtung 1 Tangentialität, Tangentenlänge und Formschräge aus
' und macht danach die Formschräge der ersten Kurve um 1 Grad steiler.
' Vorbedingung: Ein Teil mit einem Begrenzungsfeature ist offen, das Feature ist im FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, die erste Kurve hat eine steilere Formschräge.
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 swBegrenzung As SldWorks.BoundaryBossFeatureData
Dim nTang As Long
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 <> "NetBlend" Then Exit Sub
swModel.ClearSelection2 True
Set swBegrenzung = swFeat.GetDefinition
If False = swBegrenzung.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swFeat.Name & ", dünnwandig: " & swBegrenzung.IsThinFeature
For i = 0 To swBegrenzung.GetCurvesCount(swBoundaryBossDirection_First) - 1
nTang = swBegrenzung.GetGuideTangencyType(swBoundaryBossDirection_First, i)
Debug.Print " Kurve " & i + 1 & ": Tangentialität " & nTang ' Wert aus swBoundaryBossTangencyType_e
If nTang <> swBoundaryBossTangency_None Then
Debug.Print " Tangentenlänge " & swBegrenzung.GetTangentLength(swBoundaryBossDirection_First, i)
End If
Debug.Print " Formschräge " & Format(swBegrenzung.GetDraftAngle(swBoundaryBossDirection_First, i) * 57.2957795, "0.00") & " Grad"
Next i
swBegrenzung.SetDraftAngle swBoundaryBossDirection_First, 0, _
swBegrenzung.GetDraftAngle(swBoundaryBossDirection_First, 0) + 1 / 57.2957795
If False = swFeat.ModifyDefinition(swBegrenzung, swModel, Nothing) Then Debug.Print "Nicht geändert"
End SubBemerkungen
Ändern: Du rufst erst BoundaryBossFeatureData.AccessSelections auf. Das setzt das Modell vor das Feature zurück. Dann änderst du die Werte und übernimmst sie mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit BoundaryBossFeatureData.ReleaseSelectionAccess auf. Fast jede Seite der Hilfe zu BoundaryBossFeatureData verweist auf diesen Ablauf.
Richtung und Kurve: Die meisten Methoden erwarten eine Richtung aus swBoundaryBossDirection_e und den Index der Kurve. Den gültigen Bereich liefert BoundaryBossFeatureData.GetCurvesCount. Das Hilfebeispiel „Insert Boundary Feature“ zählt die erste Kurve als 0.
Was wann gilt: Viele Werte gelten nur unter Bedingungen. Ausrichtung und ein Griff für alles (BoundaryBossFeatureData.SetAlignmentType, BoundaryBossFeatureData.SetTangentApplyToAll) gibt es nur bei Begrenzungsfeatures in einer Richtung. Den Einfluss (BoundaryBossFeatureData.SetTangentInfluence) gibt es nur mit Kurven in beiden Richtungen. Der Richtungsvektor gilt nur bei der Tangentialität swBoundaryBossTangency_DirectionVector. Der Feature-Bereich und das Verschmelzen (BoundaryBossFeatureData.MergeResult) gelten nur, wenn die Kurven Flächen oder Kanten sind.
Einheiten: Die Hilfe nennt keine. Die Formschräge ist vermutlich wie sonst in der API im Bogenmaß, das Hilfebeispiel setzt 0,015. Die Tangentenlänge ist ein Faktor ohne Einheit, ihr Standardwert ist 1. Die Wandstärke ist in Metern.
Lesen: Die Werte liest du nach BoundaryBossFeatureData.AccessSelections. Ohne AccessSelections lieferten alle Kurvenwerte in SOLIDWORKS 2024 nur 0 oder False.
FeatureManager.InsertNetBlend2 legt das Begrenzungsfeature an, liefert aber Nothing. Bei der Tangentialität swBoundaryBossTangency_None wirkt eine Formschräge nicht, auch wenn Feature.ModifyDefinition True liefert.
Eigenschaften und Methoden
Eigenschaften 14, davon 14 beschrieben
| Name | Beschreibung |
|---|---|
| AutoSelect | Liest oder setzt, ob das Begrenzungsfeature in einem Mehrkörperteil automatisch alle Körper beeinflusst oder nur bestimmte. |
| D1CurveInfluence | Liest oder setzt, wie weit der Einfluss der Kurven in Richtung 1 reicht, etwa bis zur nächsten Kurve oder global. |
| D1Curves | Liest oder setzt die Kurven in Richtung 1: Skizzenkurven, Flächen oder Kanten, in der Reihenfolge der Auswahl. |
| D2CurveInfluence | Liest oder setzt, wie weit der Einfluss der Kurven in Richtung 2 reicht, etwa bis zur nächsten Kurve oder global. |
| D2Curves | Liest oder setzt die Kurven in Richtung 2: Skizzenkurven, Flächen oder Kanten, in der Reihenfolge der Auswahl. |
| FeatureScope | Liest oder setzt, ob das Begrenzungsfeature in einem Mehrkörperteil nur bestimmte Körper beeinflusst. |
| FeatureScopeBodies | Liest oder setzt die Körper, die das Begrenzungsfeature in einem Mehrkörperteil beeinflusst. |
| FeatureScopeBodiesCount | Liefert die Zahl der Körper, die das Begrenzungsfeature in einem Mehrkörperteil beeinflusst. |
| MergeResult | Liest oder setzt, ob alle Elemente des Begrenzungsfeatures zu einem Körper verschmolzen werden. |
| MergeTangentFaces | Liest oder setzt, ob Flächen des Begrenzungsfeatures tangential verschmelzen, wo die Abschnitte der Begrenzung tangential sind. |
| ThinFeatureReversed | Liefert, ob die Richtung des dünnwandigen Begrenzungsfeatures umgekehrt ist. |
| ThinFeatureThickness | Liest oder setzt die Wandstärke des dünnwandigen Begrenzungsfeatures. |
| ThinFeatureType | Liest oder setzt, wie die Wand des dünnwandigen Begrenzungsfeatures aufgetragen wird: in eine Richtung, mittig oder in zwei Richtungen. |
| TrimByD1 | Liest oder setzt, ob die Flächen in Richtung 1 beschnitten werden, wenn die Kurven keine geschlossene Begrenzung bilden. |
Methoden 22, davon 22 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Begrenzungsfeature zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetAlignmentType | Liefert, wie eine Kurve des Begrenzungsfeatures ausgerichtet ist, etwa am nächsten Profil. |
| GetCurvesCount | Liefert die Zahl der Kurven in einer Richtung des Begrenzungsfeatures. |
| GetDirectionVector | Liefert das Element, das als Richtungsvektor für eine Kurve des Begrenzungsfeatures dient. |
| GetDraftAngle | Liefert den Formschrägenwinkel einer Kurve des Begrenzungsfeatures. |
| GetDraftAngleReverseDirection | Liefert, ob die Formschräge einer Kurve des Begrenzungsfeatures umgekehrt ist. |
| GetGuideTangencyType | Liefert die Tangentialität einer Kurve des Begrenzungsfeatures, etwa keine, normal zum Profil oder Richtungsvektor. |
| GetTangentApplyToAll | Liefert, ob für eine Kurve des Begrenzungsfeatures ein einziger Griff alle Bedingungen des Profils steuert. |
| GetTangentDirectionReversed | Liefert, ob die Richtung zu den angrenzenden tangentialen Flächen für eine Kurve des Begrenzungsfeatures umgekehrt ist. |
| GetTangentInfluence | Liefert den Einfluss einer Kurve des Begrenzungsfeatures auf die nächste Kurve, als Anteil von 0 bis 1. |
| GetTangentLength | Liefert die Tangentenlänge einer Kurve des Begrenzungsfeatures, die steuert, wie stark die Tangentialbedingung wirkt. |
| IsThinFeature | Liefert, ob das Begrenzungsfeature dünnwandig ist. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Begrenzungsfeature nicht geändert hast. |
| SetAlignmentType | Legt fest, wie eine Kurve des Begrenzungsfeatures ausgerichtet ist, etwa am nächsten Profil oder an der Normalen des Profils. |
| SetDirectionVector | Legt das Element fest, das als Richtungsvektor für eine Kurve des Begrenzungsfeatures dient. |
| SetDraftAngle | Setzt den Formschrägenwinkel einer Kurve des Begrenzungsfeatures. |
| SetDraftAngleReverseDirection | Legt fest, ob die Formschräge einer Kurve des Begrenzungsfeatures umgekehrt ist. |
| SetGuideTangencyType | Setzt die Tangentialität einer Kurve des Begrenzungsfeatures, etwa keine, normal zum Profil oder tangential zur Fläche. |
| SetTangentApplyToAll | Legt fest, ob für eine Kurve des Begrenzungsfeatures ein einziger Griff alle Bedingungen des Profils steuert. |
| SetTangentDirectionReversed | Legt fest, ob die Richtung zu den angrenzenden tangentialen Flächen für eine Kurve des Begrenzungsfeatures umgekehrt ist. |
| SetTangentInfluence | Setzt den Einfluss einer Kurve des Begrenzungsfeatures auf die nächste Kurve, als Anteil von 0 bis 1. |
| SetTangentLength | Setzt die Tangentenlänge einer Kurve des Begrenzungsfeatures, die steuert, wie stark die Tangentialbedingung wirkt. |
Siehe auch
Englisches Original: IBoundaryBossFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.