SolidWorksMakroprogrammierung

Objekt · SldWorks

SimulationGravityFeatureData-Objekt

Die Definition der Schwerkraft in einer Bewegungsstudie: Richtung über eine Achse oder ein Element und ihre Stärke.

Deklaration Dim x As SldWorks.SimulationGravityFeatureData · in der englischen .NET-Hilfe: ISimulationGravityFeatureData

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.CreateDefinition mit swFmAEMGravity: eine neue Definition, aus der MotionStudy.CreateFeature die Schwerkraft anlegt. Die Bewegungsstudie muss dabei aktiv sein.
  • Feature.GetDefinition: bei der Schwerkraft aus MotionStudy.GetMotionFeatures. Das Hilfebeispiel „Get Motion Study“ erkennt sie am Typnamen AEMGravity aus Feature.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 Sub

Bemerkungen

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

NameBeschreibung
AxisLiest oder setzt die Achse des Koordinatensystems, entlang der die Schwerkraft wirkt.
DirectionReferenceLiest oder setzt das Element, das die Richtung der Schwerkraft festlegt.
ReverseDirectionLiest oder setzt, ob die Richtung der Schwerkraft umgekehrt ist.
StrengthLiest 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.