Objekt · SldWorks
SimulationGravityFeatureData-Objekt
Die Definition der Schwerkraft in einer Bewegungsstudie: Richtung über eine Achse oder ein Element und ihre Stärke.
Beschreibung
SimulationGravityFeatureData gibt Zugriff auf die Schwerkraft in einer Bewegungsstudie von SOLIDWORKS Motion. Die Richtung legst du über eine Achse des Koordinatensystems oder über ein Element wie eine Kante, Fläche, Achse oder Ebene fest. Strength, ReverseDirection und DirectionReference gibt es seit SOLIDWORKS 2006, Axis seit 2009.
Zugriff
MotionStudy.CreateDefinitionmitswFmAEMGravity: eine neue Definition, aus derMotionStudy.CreateFeaturedie Schwerkraft anlegt. Die Bewegungsstudie muss dabei aktiv sein.Feature.GetDefinition: bei der Schwerkraft ausMotionStudy.GetMotionFeatures. Das Hilfebeispiel „Get Motion Study“ erkennt sie am TypnamenAEMGravityausFeature.GetTypeName.
Die Bewegungsstudien holst du mit ModelDocExtension.GetMotionStudyManager.
Beispiel
' Gibt die Schwerkraft der ersten Bewegungsstudie aus. Gibt es keine, legt das Makro
' eine in Richtung -Y an.
' Vorbedingung: Eine Baugruppe mit einer Bewegungsstudie ist offen.
' Unter Extras > Verweise ist „SOLIDWORKS <Version> MotionStudy Type Library“ ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, bei Bedarf hat die Studie eine Schwerkraft.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swMM As SwMotionStudy.MotionStudyManager
Dim swStudie As SwMotionStudy.MotionStudy
Dim swFeat As SldWorks.Feature
Dim swDef As Object
Dim swDaten As SldWorks.SimulationGravityFeatureData
Dim vNamen As Variant, vFeatures As Variant
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swMM = swModel.Extension.GetMotionStudyManager
If swMM Is Nothing Then Exit Sub
If swMM.GetMotionStudyCount = 0 Then Exit Sub
vNamen = swMM.GetMotionStudyNames
Set swStudie = swMM.GetMotionStudy(vNamen(0))
If False = swStudie.Activate Then Exit Sub
vFeatures = swStudie.GetMotionFeatures
If IsArray(vFeatures) Then
For i = 0 To UBound(vFeatures)
Set swFeat = vFeatures(i)
Set swDef = swFeat.GetDefinition
If TypeOf swDef Is SldWorks.SimulationGravityFeatureData Then
Set swDaten = swDef
Debug.Print swFeat.Name & ": Achse " & swDaten.Axis & ", Stärke " & swDaten.Strength & _
IIf(swDaten.ReverseDirection, ", umgekehrt", "")
Exit Sub
End If
Next i
End If
Set swDaten = swStudie.CreateDefinition(swFmAEMGravity)
If swDaten Is Nothing Then Exit Sub
swDaten.Axis = swSimulationGravityAxis_Y
swDaten.ReverseDirection = True ' vermutlich -Y
swDaten.Strength = 9.81
Set swFeat = swStudie.CreateFeature(swDaten)
If Not swFeat Is Nothing Then Debug.Print "Angelegt: " & swFeat.Name
End SubBemerkungen
Bewegungsstudien: MotionStudyManager und MotionStudy stammen aus einer eigenen Typbibliothek, der MotionStudy Type Library. Diese Seiten beschreiben sie nicht. Die Bewegungsstudie muss aktiv sein, sonst liefert MotionStudy.CreateDefinition Nothing. Das Hilfebeispiel „Create Simulation Gravity Feature“ setzt ReverseDirection = False, Axis = 0 und Strength = 12.
Ändern: Eine Methode AccessSelections hat das Objekt nicht. Das Hilfebeispiel „Fire Events for External Output Time Step Changes“ setzt bei Kräften und Motoren die Werte und ruft dann Feature.ModifyDefinition mit der Baugruppe und Nothing auf. Vermutlich gilt das auch hier.
Einheiten: Für die Stärke nennt die Hilfe keine Einheit. Ob 9.81 im Beispiel oben Meter je Sekunde zum Quadrat bedeutet oder die Einheiten des Dokuments gelten, sagt die Hilfe nicht.
Eigenschaften und Methoden
Eigenschaften 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| Axis | Liest oder setzt die Achse des Koordinatensystems, entlang der die Schwerkraft wirkt. |
| DirectionReference | Liest oder setzt das Element, das die Richtung der Schwerkraft festlegt. |
| ReverseDirection | Liest oder setzt, ob die Richtung der Schwerkraft umgekehrt ist. |
| Strength | Liest oder setzt die Stärke der Schwerkraft. |
Siehe auch
Englisches Original: ISimulationGravityFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.