Objekt · SldWorks
MotionPlotFeatureData-Objekt
Die Daten eines Diagramms in einer Bewegungsstudie: seine x- und y-Achsen und seine Sichtbarkeit.
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, dasCosmosMotionStudyResults.InsertPlotFeaturemit den Daten seiner Achsen anlegt. Die Ergebnisse liefertMotionStudy.GetResultsmit dem Studientyp Motion-Analyse (4), die Bewegungsstudie bekommst du überModelDocExtension.GetMotionStudyManager.Feature.GetDefinition: bei einem vorhandenen Diagramm mit dem TypnamenSimPlotFeature, etwa ausCosmosMotionStudyResults.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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Visibility | Liest oder setzt, ob die Daten des Diagramms sichtbar sind, vermutlich also, ob das Diagramm angezeigt wird. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| AddYAxis | Fügt einem Diagramm die Daten einer weiteren y-Achse hinzu. |
| GetXAxis | Liefert das Feature der x-Achse eines Diagramms. |
| GetYAxis | Liefert 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.