SolidWorksMakroprogrammierung

Objekt · SldWorks

MotionPlotFeatureData-Objekt

Die Daten eines Diagramms in einer Bewegungsstudie: seine x- und y-Achsen und seine Sichtbarkeit.

Deklaration Dim x As SldWorks.MotionPlotFeatureData · in der englischen .NET-Hilfe: IMotionPlotFeatureData

Beschreibung

MotionPlotFeatureData gibt Zugriff auf die Daten eines Diagramms (Plot) in einer Bewegungsstudie. Ein Diagramm zeigt die Ergebnisse einer berechneten Studie, etwa die Verschiebung oder Geschwindigkeit einer Fläche über der Zeit. Was es zeigt, steht in den Daten seiner Achsen (MotionPlotAxisFeatureData). Die Befehle gibt es seit SOLIDWORKS 2011.

Zugriff

  • CosmosMotionStudyResults.CreatePlotFeatureData: neue Daten für ein Diagramm, das CosmosMotionStudyResults.InsertPlotFeature mit den Daten seiner Achsen anlegt. Die Ergebnisse liefert MotionStudy.GetResults mit dem Studientyp Motion-Analyse (4), die Bewegungsstudie bekommst du über ModelDocExtension.GetMotionStudyManager.
  • Feature.GetDefinition: bei einem vorhandenen Diagramm mit dem Typnamen SimPlotFeature, etwa aus CosmosMotionStudyResults.GetPlotFeatures

Beispiel

' Gibt für jedes Diagramm der Bewegungsstudie "Motion Study 1" den Namen, die Sichtbarkeit
' und die Ergebnisgröße jeder Achse aus.
' Vorbedingung: Eine Baugruppe mit dieser Bewegungsstudie (Motion-Analyse) und mindestens
'               einem Diagramm ist offen, das Zusatzprogramm SOLIDWORKS Motion ist geladen.
'               Unter Extras > Verweise ist „SOLIDWORKS <Version> MotionStudy Type Library“
'               ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster (Strg+G), die Baugruppe bleibt unverändert.
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 swErgebnisse As SwMotionStudy.CosmosMotionStudyResults
    Dim swFeat As SldWorks.Feature
    Dim swAchsFeat As SldWorks.Feature
    Dim swDef As Object
    Dim swDiagramm As SldWorks.MotionPlotFeatureData
    Dim swAchse As SldWorks.MotionPlotAxisFeatureData
    Dim vDiagramme As Variant, vYAchsen As Variant
    Dim i As Long, j 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
    Set swStudie = swMM.GetMotionStudy("Motion Study 1")
    If swStudie Is Nothing Then Exit Sub
    If False = swStudie.IsActive Then swStudie.Activate
    Set swErgebnisse = swStudie.GetResults(4)                 ' 4 = Motion-Analyse
    If swErgebnisse Is Nothing Then Exit Sub

    vDiagramme = swErgebnisse.GetPlotFeatures
    If Not IsArray(vDiagramme) Then Exit Sub
    For i = 0 To UBound(vDiagramme)
        Set swFeat = vDiagramme(i)
        Set swDef = swFeat.GetDefinition
        If TypeOf swDef Is SldWorks.MotionPlotFeatureData Then
            Set swDiagramm = swDef
            Debug.Print swFeat.Name & ", sichtbar: " & swDiagramm.Visibility

            Set swAchsFeat = swDiagramm.GetXAxis
            If Not swAchsFeat Is Nothing Then
                Set swAchse = swAchsFeat.GetDefinition
                Debug.Print "  x-Achse: Größe " & swAchse.Type          ' swMotionPlotAxisType_e
            End If

            vYAchsen = swDiagramm.GetYAxis
            If IsArray(vYAchsen) Then
                For j = 0 To UBound(vYAchsen)
                    Set swAchsFeat = vYAchsen(j)
                    Set swAchse = swAchsFeat.GetDefinition
                    Debug.Print "  y-Achse: Größe " & swAchse.Type & ", Komponente " & swAchse.Component
                Next j
            End If
        End If
    Next i
End Sub

Bemerkungen

Anlegen: Du berechnest die Bewegungsstudie, holst ihre Ergebnisse und legst die Daten für das Diagramm und seine Achsen an. An den y-Achsen setzt du Ergebnisgröße, Komponente und Elemente. Dann liest CosmosMotionStudyResults.GetValues die Werte, und CosmosMotionStudyResults.InsertPlotFeature fügt das Diagramm ein. Das zeigt das Beispiel auf der Seite MotionPlotAxisFeatureData nach dem Hilfebeispiel „Create Plots and Get Values“. Die Befehle von MotionPlotFeatureData selbst ruft dieses Hilfebeispiel nicht auf, ein anderes gibt es nicht.

Vorhandene Diagramme: In der Tabelle der Typnamen zu Feature.GetTypeName2 hat ein Diagramm den Typnamen SimPlotFeature, seine Definition ist ein MotionPlotFeatureData. Seine Achsen haben die Typnamen SimPlotXAxisFeature und SimPlotYAxisFeature, ihre Definition ist ein MotionPlotAxisFeatureData. Das Beispiel oben stützt sich auf diese Tabelle. Ob du Änderungen mit Feature.ModifyDefinition zurückschreibst, sagt die Hilfe nicht.

Bibliothek: MotionStudyManager, MotionStudy und CosmosMotionStudyResults stammen aus der MotionStudy Type Library, nicht aus der SldWorks-Bibliothek. Diese Seiten beschreiben sie nicht. Die Zahl der Diagramme liefert dort CosmosMotionStudyResults.GetPlotCount.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
VisibilityLiest oder setzt, ob die Daten des Diagramms sichtbar sind, vermutlich also, ob das Diagramm angezeigt wird.

Methoden 3, davon 3 beschrieben

NameBeschreibung
AddYAxisFügt einem Diagramm die Daten einer weiteren y-Achse hinzu.
GetXAxisLiefert das Feature der x-Achse eines Diagramms.
GetYAxisLiefert die Features der y-Achsen eines Diagramms.

Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetYAxis). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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