SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.LoftFeatureData · in der englischen .NET-Hilfe: ILoftFeatureData

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 Typnamen Blend (Aufsatz oder Basis) oder BlendCut (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 Sub

Bemerkungen

Ä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

NameBeschreibung
AdvancedSmoothingLiest oder setzt, ob bei der Ausformung das erweiterte Glätten eingeschaltet ist.
AutoSelectLiest oder setzt, ob die Ausformung in einem Mehrkörperteil automatisch alle Körper beeinflusst.
CenterlineLiest oder setzt die Mittellinie der Ausformung.
CloseLiest oder setzt, ob die Ausformung geschlossen ist.
EndConstraintApplyToAllLiefert, ob für das Ende der Ausformung eine Bedingung festgelegt ist.
EndConstraintDraftAngleLiest oder setzt die Formschräge der Bedingung am Ende der Ausformung.
EndConstraintDraftAngleDirectionLiest oder setzt, ob die Formschräge der Bedingung am Ende der Ausformung umgekehrt ist.
EndDirectionVectorLiest oder setzt den Richtungsvektor, in dem die Ausformung endet.
EndTangencyTypeLiest oder setzt die Tangentialität am Ende der Ausformung.
EndTangentLengthLiest oder setzt die Tangentenlänge am Ende der Ausformung.
FeatureScopeLiest oder setzt, ob die Ausformung in einem Mehrkörperteil nur bestimmte Körper beeinflusst.
FeatureScopeBodiesLiest oder setzt die Volumenkörper, die die Ausformung in einem Mehrkörperteil beeinflusst.
GuideCurveInfluenceLiest oder setzt, wie weit die Leitkurven der Ausformung wirken.
GuideCurvesLiest oder setzt die Leitkurven der Ausformung.
MaintainTangencyLiest oder setzt, ob die Ausformung die Tangentialität der Profile erhält.
MergeLiest oder setzt, ob die Ausformung in einem Mehrkörperteil mit den vorhandenen Körpern verschmilzt.
NumberOfSectionsLiest oder setzt die Zahl der Schnitte der Ausformung.
PickPointsLiest oder setzt die Auswahlpunkte der Ausformung.
ProfilesLiest oder setzt die Profile der Ausformung.
ReverseEndTangentDirectionLiest oder setzt, ob die Tangentenrichtung am Ende der Ausformung umgekehrt ist.
ReverseStartTangentDirectionLiest oder setzt, ob die Tangentenrichtung am Anfang der Ausformung umgekehrt ist.
StartConstraintApplyToAllLiefert, ob für den Anfang der Ausformung eine Bedingung festgelegt ist.
StartConstraintDraftAngleLiest oder setzt die Formschräge der Bedingung am Anfang der Ausformung.
StartConstraintDraftAngleDirectionLiest oder setzt, ob die Formschräge der Bedingung am Anfang der Ausformung umgekehrt ist.
StartDirectionVectorLiest oder setzt den Richtungsvektor, in dem die Ausformung beginnt.
StartTangencyTypeLiest oder setzt die Tangentialität am Anfang der Ausformung.
StartTangentLengthLiest oder setzt die Tangentenlänge am Anfang der Ausformung.
ThinWallTypeLiest oder setzt, in welche Richtung die Wand einer dünnwandigen Ausformung aufgetragen wird.

Methoden 12, davon 12 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Ausformung zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetFeatureScopeBodiesCountLiefert die Zahl der Volumenkörper, die die Ausformung in einem Mehrkörperteil beeinflusst.
GetGuideCurvesCountLiefert die Zahl der Leitkurven der Ausformung.
GetGuideCurvesTypeLiefert die Art jeder Leitkurve der Ausformung.
GetGuideTangencyTypeLiefert die Tangentialität, mit der die Ausformung an eine Leitkurve anschließt.
GetProfileCountLiefert die Zahl der Profile der Ausformung.
GetWallThicknessLiefert die Wandstärke einer dünnwandigen Ausformung in Vorwärts- oder Gegenrichtung.
IsBossFeatureLiefert, ob die Ausformung ein Aufsatz ist.
IsThinFeatureLiefert, ob die Ausformung dünnwandig ist.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Ausformung nicht geändert hast.
SetGuideTangencyTypeSetzt die Tangentialität, mit der die Ausformung an eine Leitkurve anschließt.
SetWallThicknessSetzt 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.