SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.BoundaryBossFeatureData · in der englischen .NET-Hilfe: IBoundaryBossFeatureData

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

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 Sub

Bemerkungen

Ä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

NameBeschreibung
AutoSelectLiest oder setzt, ob das Begrenzungsfeature in einem Mehrkörperteil automatisch alle Körper beeinflusst oder nur bestimmte.
D1CurveInfluenceLiest oder setzt, wie weit der Einfluss der Kurven in Richtung 1 reicht, etwa bis zur nächsten Kurve oder global.
D1CurvesLiest oder setzt die Kurven in Richtung 1: Skizzenkurven, Flächen oder Kanten, in der Reihenfolge der Auswahl.
D2CurveInfluenceLiest oder setzt, wie weit der Einfluss der Kurven in Richtung 2 reicht, etwa bis zur nächsten Kurve oder global.
D2CurvesLiest oder setzt die Kurven in Richtung 2: Skizzenkurven, Flächen oder Kanten, in der Reihenfolge der Auswahl.
FeatureScopeLiest oder setzt, ob das Begrenzungsfeature in einem Mehrkörperteil nur bestimmte Körper beeinflusst.
FeatureScopeBodiesLiest oder setzt die Körper, die das Begrenzungsfeature in einem Mehrkörperteil beeinflusst.
FeatureScopeBodiesCountLiefert die Zahl der Körper, die das Begrenzungsfeature in einem Mehrkörperteil beeinflusst.
MergeResultLiest oder setzt, ob alle Elemente des Begrenzungsfeatures zu einem Körper verschmolzen werden.
MergeTangentFacesLiest oder setzt, ob Flächen des Begrenzungsfeatures tangential verschmelzen, wo die Abschnitte der Begrenzung tangential sind.
ThinFeatureReversedLiefert, ob die Richtung des dünnwandigen Begrenzungsfeatures umgekehrt ist.
ThinFeatureThicknessLiest oder setzt die Wandstärke des dünnwandigen Begrenzungsfeatures.
ThinFeatureTypeLiest oder setzt, wie die Wand des dünnwandigen Begrenzungsfeatures aufgetragen wird: in eine Richtung, mittig oder in zwei Richtungen.
TrimByD1Liest oder setzt, ob die Flächen in Richtung 1 beschnitten werden, wenn die Kurven keine geschlossene Begrenzung bilden.

Methoden 22, davon 22 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Begrenzungsfeature zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetAlignmentTypeLiefert, wie eine Kurve des Begrenzungsfeatures ausgerichtet ist, etwa am nächsten Profil.
GetCurvesCountLiefert die Zahl der Kurven in einer Richtung des Begrenzungsfeatures.
GetDirectionVectorLiefert das Element, das als Richtungsvektor für eine Kurve des Begrenzungsfeatures dient.
GetDraftAngleLiefert den Formschrägenwinkel einer Kurve des Begrenzungsfeatures.
GetDraftAngleReverseDirectionLiefert, ob die Formschräge einer Kurve des Begrenzungsfeatures umgekehrt ist.
GetGuideTangencyTypeLiefert die Tangentialität einer Kurve des Begrenzungsfeatures, etwa keine, normal zum Profil oder Richtungsvektor.
GetTangentApplyToAllLiefert, ob für eine Kurve des Begrenzungsfeatures ein einziger Griff alle Bedingungen des Profils steuert.
GetTangentDirectionReversedLiefert, ob die Richtung zu den angrenzenden tangentialen Flächen für eine Kurve des Begrenzungsfeatures umgekehrt ist.
GetTangentInfluenceLiefert den Einfluss einer Kurve des Begrenzungsfeatures auf die nächste Kurve, als Anteil von 0 bis 1.
GetTangentLengthLiefert die Tangentenlänge einer Kurve des Begrenzungsfeatures, die steuert, wie stark die Tangentialbedingung wirkt.
IsThinFeatureLiefert, ob das Begrenzungsfeature dünnwandig ist.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Begrenzungsfeature nicht geändert hast.
SetAlignmentTypeLegt fest, wie eine Kurve des Begrenzungsfeatures ausgerichtet ist, etwa am nächsten Profil oder an der Normalen des Profils.
SetDirectionVectorLegt das Element fest, das als Richtungsvektor für eine Kurve des Begrenzungsfeatures dient.
SetDraftAngleSetzt den Formschrägenwinkel einer Kurve des Begrenzungsfeatures.
SetDraftAngleReverseDirectionLegt fest, ob die Formschräge einer Kurve des Begrenzungsfeatures umgekehrt ist.
SetGuideTangencyTypeSetzt die Tangentialität einer Kurve des Begrenzungsfeatures, etwa keine, normal zum Profil oder tangential zur Fläche.
SetTangentApplyToAllLegt fest, ob für eine Kurve des Begrenzungsfeatures ein einziger Griff alle Bedingungen des Profils steuert.
SetTangentDirectionReversedLegt fest, ob die Richtung zu den angrenzenden tangentialen Flächen für eine Kurve des Begrenzungsfeatures umgekehrt ist.
SetTangentInfluenceSetzt den Einfluss einer Kurve des Begrenzungsfeatures auf die nächste Kurve, als Anteil von 0 bis 1.
SetTangentLengthSetzt 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.