Objekt · SldWorks
MassPropertyOverrideOptions-Objekt
Die Werte, mit denen MassProperty2 die berechneten Masseneigenschaften überschreibt: Masse, Schwerpunkt, Trägheitsmomente, Hauptträgheitsachsen und Hauptträgheitsmomente.
Beschreibung
MassPropertyOverrideOptions gibt Zugriff auf die Optionen zum Überschreiben der Masseneigenschaften. Statt der berechneten Werte gelten dann deine: etwa die Masse aus dem Datenblatt eines Kaufteils oder ein Zuschlag für Kleinteile. Für Einzelheiten verweist die Hilfe auf das Thema „Mass Properties Dialog Box“ in der Hilfe zur Oberfläche. Die Befehle gibt es seit SOLIDWORKS 2020.
So überschreibst du einen Wert:
- Die Überschreibungen holst du mit
MassProperty2.GetOverrideOptions. - Du setzt eine der Override-Eigenschaften auf
Trueund übergibst den Wert mit der passenden Set-Methode. MassProperty2.SetOverrideOptionsübernimmt die Überschreibungen für eine, alle oder bestimmte Konfigurationen.- Nach
MassProperty2.RecalculateliefertMassProperty2die neuen Werte.
Zugriff
MassProperty2.GetOverrideOptions: die Überschreibungen der Masseneigenschaften, die du mitModelDocExtension.CreateMassProperty2holst
Beispiel
' Überschreibt die Masse des aktiven Teils oder der Baugruppe in der aktiven
' Konfiguration mit der berechneten Masse plus 10 %, etwa als Zuschlag für Kleinteile.
' Vorbedingung: Ein Teil mit Volumenkörper oder eine Baugruppe ist offen.
' Ergebnis: Die Masse ist überschrieben, beide Werte stehen im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swMass As SldWorks.MassProperty2
Dim swOptionen As SldWorks.MassPropertyOverrideOptions
Dim dMasse As Double
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType = swDocDRAWING Then Exit Sub
swModel.ClearSelection2 True ' ohne Auswahl gilt das ganze Modell
Set swMass = swModel.Extension.CreateMassProperty2
If swMass Is Nothing Then Exit Sub
Set swOptionen = swMass.GetOverrideOptions
If swOptionen.OverrideMass Then
Debug.Print "Die Masse ist schon überschrieben: " & swOptionen.GetOverrideMassValue
Exit Sub
End If
dMasse = swMass.Mass * 1.1
Debug.Print "Berechnet: " & Format(swMass.Mass, "0.000") & " kg"
swOptionen.OverrideMass = True
If False = swOptionen.SetOverrideMassValue(dMasse) Then Exit Sub
If False = swMass.SetOverrideOptions(swOptionen, swThisConfiguration, Empty) Then Exit Sub
swMass.Recalculate
Debug.Print "Überschrieben: " & Format(swMass.Mass, "0.000") & " kg"
End SubBemerkungen
Hilfebeispiel: „Get and Override Mass Properties“ öffnet die Baugruppe 98food processor.sldasm. Es setzt die Masse auf 100 und die Trägheitsmomente mit SetOverrideMomentsOfInertiaValue 0, comArr, "" auf neun eigene Werte. Dann gibt es die Werte in den Einheiten des Dokuments aus, übergibt die Überschreibungen mit MassProperty2.SetOverrideOptions für die aktive Konfiguration, ruft MassProperty2.Recalculate auf und gibt die Werte noch einmal aus.
Ein Körper oder eine Komponente: Die Überschreibungen gibt es immer nur für einen ausgewählten Körper oder eine ausgewählte Komponente. Die einzelnen Befehle sprechen vom Modell, das gerade bearbeitet wird. Das Hilfebeispiel wählt nichts aus und überschreibt die Werte der ganzen Baugruppe. Das Beispiel oben hebt die Auswahl deshalb auf.
Trägheit: Das Programmierhandbuch (Thema „Mass Properties“, zum älteren MassProperty) nennt wie im Dialog „Override Mass Properties“ zwei Gruppen von Trägheitswerten, die sich überschreiben lassen: die Hauptträgheitsachsen mit den Hauptträgheitsmomenten und ein Bezugssystem mit den Trägheitsmomenten. Eine eigene Override-Eigenschaft für die Hauptträgheitsachsen gibt es nicht. Die Hilfe zu MassProperty2.PrincipalAxesOfInertia und MassProperty2.PrincipalMomentsOfInertia nennt MassPropertyOverrideOptions.OverrideMomentsOfInertia, vermutlich gilt diese Eigenschaft also für beide Gruppen.
Ohne eigene Seite: Neun der dreizehn Befehle haben in der .NET-Hilfe keine eigene Seite, nur eine Zeile in der Liste der Befehle und die VBA-Syntax. Ihre Parameter und Rückgaben beschreibt die Hilfe nicht. Die Seiten hier deuten sie nach den gleichnamigen Befehlen des älteren MassProperty, die beschrieben sind. Dort gibst du bei jedem Befehl die Konfigurationen mit an, hier einmal bei MassProperty2.SetOverrideOptions.
Einheiten: Die Hilfe nennt für keinen der Werte eine Einheit. Es gelten die Systemeinheiten wie bei MassProperty2: Kilogramm, Meter und kg·m².
Aufheben: Wie du eine Überschreibung zurücknimmst, sagt die Hilfe nicht. Vermutlich setzt du die Override-Eigenschaft auf False und übergibst die Überschreibungen erneut mit MassProperty2.SetOverrideOptions.
Eigenschaften und Methoden
Eigenschaften 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| OverrideCenterOfMass | Liest oder setzt, ob der berechnete Schwerpunkt des Modells, das gerade bearbeitet wird, überschrieben wird. |
| OverrideMass | Liest oder setzt, ob die berechnete Masse des Modells, das gerade bearbeitet wird, überschrieben wird. |
| OverrideMomentsOfInertia | Liest oder setzt, ob die berechneten Trägheitsmomente des Modells, das gerade bearbeitet wird, überschrieben werden. |
Methoden 10, davon 10 beschrieben
| Name | Beschreibung |
|---|---|
| GetOverrideCenterOfMassValue | Liefert den Schwerpunkt, mit dem der berechnete überschrieben wird, und den Namen seines Koordinatensystems. |
| GetOverrideMassValue | Liefert die Masse, mit der die berechnete überschrieben wird. |
| GetOverrideMomentsOfInertiaValue | Liefert die Trägheitsmomente, mit denen die berechneten überschrieben werden, und Angaben zu ihrem Bezugssystem. |
| GetOverridePrincipalAxesOrientation | Liefert die Richtung einer Hauptträgheitsachse, mit der die berechnete überschrieben wird. |
| GetOverridePrincipalMomentsOfInertia | Liefert die Hauptträgheitsmomente, mit denen die berechneten überschrieben werden. |
| SetOverrideCenterOfMassValue | Überschreibt den berechneten Schwerpunkt des Modells, das gerade bearbeitet wird. |
| SetOverrideMassValue | Überschreibt die berechnete Masse des Modells, das gerade bearbeitet wird. |
| SetOverrideMomentsOfInertiaValue | Überschreibt die berechneten Trägheitsmomente des Modells, das gerade bearbeitet wird. |
| SetOverridePrincipalAxesOrientation | Überschreibt die Richtung einer Hauptträgheitsachse des Modells, das gerade bearbeitet wird. |
| SetOverridePrincipalMomentsOfInertia | Überschreibt die berechneten Hauptträgheitsmomente des Modells, das gerade bearbeitet wird. |
Siehe auch
Englisches Original: IMassPropertyOverrideOptions in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.