SolidWorksMakroprogrammierung

Objekt · SldWorks

SimulationSpringFeatureData-Objekt

Die Daten einer Feder in einer Bewegungsstudie: Endpunkte, Federkonstante, freie Länge, Windungen und ein optionaler Dämpfer.

Deklaration Dim x As SldWorks.SimulationSpringFeatureData · in der englischen .NET-Hilfe: ISimulationSpringFeatureData

Beschreibung

SimulationSpringFeatureData gibt Zugriff auf die Daten einer Feder in einer Bewegungsstudie (SOLIDWORKS Motion). Die Feder liegt zwischen zwei Endpunkten und übt eine Kraft auf die Komponenten aus, wenn ihre Länge von der freien Länge abweicht. Auf Wunsch hat sie einen Dämpfer. Die Befehle gibt es seit SOLIDWORKS 2009.

Zugriff

Beispiel

' Fügt in die Bewegungsstudie "Motion Study 1" eine lineare Feder zwischen den beiden
' ausgewählten Flächen ein. Werte wie im Hilfebeispiel "Add Spring to Motion Study".
' Vorbedingung: Eine Baugruppe mit dieser Bewegungsstudie ist offen, zwei Flächen
'               verschiedener Komponenten sind ausgewählt, SOLIDWORKS Motion ist geladen.
' Ergebnis:     Die Bewegungsstudie hat eine Feder mehr, ihr Name steht im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swFlaeche1 As SldWorks.Face2
    Dim swFlaeche2 As SldWorks.Face2
    Dim swStudienMgr As Object                   ' MotionStudyManager
    Dim swStudie As Object                       ' MotionStudy
    Dim swFeder As SldWorks.SimulationSpringFeatureData
    Dim swFeat As SldWorks.Feature

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectCount2(-1) <> 2 Then Exit Sub
    Set swFlaeche1 = swSelMgr.GetSelectedObject6(1, -1)
    Set swFlaeche2 = swSelMgr.GetSelectedObject6(2, -1)

    Set swStudienMgr = swModel.Extension.GetMotionStudyManager
    If swStudienMgr Is Nothing Then Exit Sub
    Set swStudie = swStudienMgr.GetMotionStudy("Motion Study 1")
    If swStudie Is Nothing Then Exit Sub
    swStudie.Activate                            ' die Studie muss aktiv sein

    Set swFeder = swStudie.CreateDefinition(swFmAEMLinearMotionSpring)
    If swFeder Is Nothing Then Exit Sub
    swFeder.SetEndPoints swFlaeche1, swFlaeche2
    swFeder.CoilDiameter = 0.0102
    swFeder.NumberOfCoils = 3
    swFeder.WireDiameter = 0.00152
    swFeder.FreeLength = 0.02

    Set swFeat = swStudie.CreateFeature(swFeder)
    If swFeat Is Nothing Then
        Debug.Print "Feder nicht angelegt"
    Else
        Debug.Print "Neue Feder: " & swFeat.Name
    End If
End Sub

Bemerkungen

Anlegen: Die Bewegungsstudie muss aktiv sein, wenn du die Definition mit MotionStudy.CreateDefinition erzeugst und die Feder mit MotionStudy.CreateFeature anlegst, sonst liefert CreateDefinition Nothing. Die Bewegungsstudie und ihr Manager stammen aus der eigenen Typbibliothek SOLIDWORKS MotionStudy. Das Beispiel oben deklariert sie deshalb als Object.

Feature-Typ: Die Tabelle der Typnamen bei Feature.GetTypeName2 nennt für dieses Objekt keinen Typnamen. AEMLinearSpring gehört dort zu SimulationLinearSpringFeatureData, AEMTorsionalSpring zu keinem Datenobjekt. Ob ein Feature eine solche Feder ist, prüfst du deshalb am sichersten mit TypeOf auf das Ergebnis von Feature.GetDefinition.

Motor und Feder: Die Bewegung durch Motoren hat Vorrang vor der durch Federn. Zieht ein Motor eine Komponente nach links und eine Feder nach rechts, bewegt sie sich nach links, und der Motor braucht mehr Leistung.

Einheiten: Die Hilfe nennt keine. Das Hilfebeispiel setzt Durchmesser und freie Länge mit Werten wie 0.0102 und 0.02, also vermutlich Meter. Für Federkonstante, Dämpfungskonstante und den freien Winkel sagt sie nichts.

Art der Feder: SimulationSpringFeatureData.Type liefert einen Wert aus swSpringType_e. Ob die Feder linear oder eine Torsionsfeder ist, legst du beim Anlegen mit dem Wert aus swFeatureNameID_e fest. Die Enumeration swSimulationSpringType_e nennt die Hilfe bei keinem Befehl dieses Objekts.

Das Beispiel sucht die Studie „Motion Study 1“, in der deutschen Fassung heißt sie „Bewegungsstudie 1“. Mit CreateFeature, CreateDefinition(swFmAEMLinearMotionSpring) und SimulationSpringFeatureData.SetEndPoints entstand keine Feder.

Eigenschaften und Methoden

Eigenschaften 15, davon 15 beschrieben

NameBeschreibung
BaseComponentLiest oder setzt die Basiskomponente der Feder.
CoilDiameterLiest oder setzt den Windungsdurchmesser der Feder.
DampingConstantLiest oder setzt die Dämpfungskonstante des Dämpfers der Feder.
ExponentOfDamperForceExpressionLiest oder setzt den Exponenten im Ausdruck für die Dämpferkraft der Feder.
ExponentOfSpringForceExpressionLiest oder setzt den Exponenten im Ausdruck für die Federkraft.
FreeAngleLiest oder setzt den freien Winkel im Ausdruck für die Federkraft.
FreeLengthLiest oder setzt die freie Länge der Feder, bei der sie keine Kraft ausübt.
HasDamperLiest oder setzt, ob die Feder einen Dämpfer hat.
LoadReferencesLiest oder setzt die tragenden Flächen der Feder.
NumberOfCoilsLiest oder setzt die Zahl der Windungen der Feder.
ReverseDirectionLiest oder setzt, ob die Richtung der Feder umgekehrt ist.
SpringConstantLiest oder setzt die Federkonstante, also die Stärke der Feder.
TypeLiefert die Art der Feder als Wert aus swSpringType_e.
UpdateToModelChangesLiest oder setzt, ob sich die freie Länge an Modelländerungen anpasst, solange der PropertyManager offen ist.
WireDiameterLiest oder setzt den Drahtdurchmesser der Feder.

Methoden 2, davon 2 beschrieben

NameBeschreibung
GetEndPointsLiefert die beiden Endpunkte der Feder und ihre Art.
SetEndPointsSetzt die beiden Endpunkte der Feder.

Siehe auch

Englisches Original: ISimulationSpringFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.