SolidWorksMakroprogrammierung

Objekt · SldWorks

MassProperty-Objekt

Älteres, veraltetes Objekt für die Masseneigenschaften eines Teils, einer Baugruppe oder bestimmter Körper; Nachfolger ist MassProperty2.

Deklaration Dim x As SldWorks.MassProperty · in der englischen .NET-Hilfe: IMassProperty

Beschreibung

MassProperty ist veraltet und durch MassProperty2 ersetzt, das es seit SOLIDWORKS 2020 gibt. Die einzelnen Befehle führt die Hilfe aber ohne diesen Hinweis, und viele ältere Makros und Hilfebeispiele nutzen das Objekt. Es liefert die Masseneigenschaften wie im Dialog „Masseneigenschaften“ und überschreibt sie wie im Dialog „Override Mass Properties“. Es rechnet nur mit Volumenkörpern. Die meisten Befehle gibt es seit SOLIDWORKS 2003 SP02, SetAssignedMassProp und UserAssigned seit SOLIDWORKS 2005, die Befehle zum Überschreiben seit SOLIDWORKS 2013.

Zugriff

In neuen Makros holst du stattdessen mit ModelDocExtension.CreateMassProperty2 ein MassProperty2.

Beispiel

' Berechnet Masse, Volumen und Schwerpunkt der Volumenkörper der ausgewählten
' Komponente, wie das Hilfebeispiel „Get Mass Properties of Multibody Assembly Component“.
' Vorbedingung: Eine Baugruppe ist offen, eine Komponente ist ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swComp As SldWorks.Component2
    Dim swMass As SldWorks.MassProperty
    Dim vKoerper As Variant
    Dim vInfo As Variant
    Dim vPunkt As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY Then Exit Sub
    Set swComp = swModel.SelectionManager.GetSelectedObjectsComponent4(1, -1)
    If swComp Is Nothing Then Exit Sub

    Set swMass = swModel.Extension.CreateMassProperty
    vKoerper = swComp.GetBodies3(swSolidBody, vInfo)
    If Not IsArray(vKoerper) Then Exit Sub
    If False = swMass.AddBodies((vKoerper)) Then        ' doppelte Klammern wie im Hilfebeispiel
        Debug.Print "Körper nicht übernommen"
        Exit Sub
    End If

    vPunkt = swMass.CenterOfMass
    Debug.Print "Komponente:  " & swComp.Name2
    Debug.Print "Masse:       " & Format(swMass.Mass, "0.000") & " kg"
    Debug.Print "Volumen:     " & Format(swMass.Volume * 1000000000#, "0") & " mm³"
    Debug.Print "Schwerpunkt: " & Format(vPunkt(0) * 1000#, "0.00") & ", " & _
                Format(vPunkt(1) * 1000#, "0.00") & ", " & Format(vPunkt(2) * 1000#, "0.00") & " mm"
End Sub

Bemerkungen

MassProperty oder MassProperty2: MassProperty ist veraltet, in Makros für SOLIDWORKS 2020 und neuer nimmst du MassProperty2. Die Unterschiede:

MassProperty brauchst du noch für Makros, die auch vor SOLIDWORKS 2020 laufen sollen, und für temporäre Körper. Ob MassProperty2 temporäre Körper annimmt, sagt die Hilfe nicht.

Koordinatensystem: Bei ModelDocExtension.CreateMassProperty steht: Das Objekt rechnet die Momente um den Ursprung des Dokuments, solange du mit MassProperty.SetCoordinateSystem kein anderes Koordinatensystem festlegst. Übergibst du mit AddBodies die Körper einer Komponente, beziehen sich die Werte auf den Ursprung der Komponente, nicht der Baugruppe.

Aktuelle Werte: Nach ModelDocExtension.CreateMassProperty liefert das Objekt neu berechnete, aktuelle Werte, auch wenn das Modell einen Neuaufbau bräuchte.

Einheiten: MassProperty.UseSystemUnits ist ohne Zuweisung True, die Werte kommen dann in Meter, Bogenmaß und Kilogramm. Das Programmierhandbuch (Thema „Mass Properties“) nennt dagegen Gramm; geliefert wird aber Kilogramm (0,12 für einen Quader mit 120 g, mit UseSystemUnits = False in einem MMGS-Teil 120). Die Hilfebeispiele geben die Masse in kg aus, Volumen und Oberfläche rechnen sie aus m³ und m² in mm³ und mm² um.

Hilfebeispiele: „Insert Coordinate System at Center of Mass“ zeichnet am Schwerpunkt eine 3D-Skizze mit Linien entlang der Hauptträgheitsachsen und fügt daran ein Koordinatensystem ein. „Get Mass Properties of Multibody Assembly Component“ übergibt AddBodies die Körper einer Komponente mit einem Schnitt-Feature der Baugruppe, das die Masseneigenschaften mit beeinflusst. Die Hilfeseiten der Befehle zum Überschreiben verweisen auf „Get and Override Mass Properties“, das inzwischen MassProperty2 verwendet.

Übergibst du mit MassProperty.AddBodies die Körper einer Komponente, liefert nur MassProperty.Mass einen Wert. Volume, SurfaceArea und CenterOfMass liefern 0, Density einen unendlichen Wert.

Eigenschaften und Methoden

Eigenschaften 12, davon 12 beschrieben

NameBeschreibung
CenterOfMassLiefert den Schwerpunkt des Modells oder der mit AddBodies übergebenen Körper.
DensityLiefert die Dichte des Modells oder der mit AddBodies übergebenen Körper.
MassLiefert die Masse des Modells oder der mit AddBodies übergebenen Körper.
OverrideCenterOfMassLiest oder setzt, ob der berechnete Schwerpunkt des Modells überschrieben wird.
OverrideMassLiest oder setzt, ob die berechnete Masse des Modells überschrieben wird.
OverrideMomentsOfInertiaLiest oder setzt, ob die berechneten Trägheitsmomente des Modells überschrieben werden.
PrincipleAxesOfInertiaLiefert die Richtung einer der drei Hauptträgheitsachsen.
PrincipleMomentsOfInertiaLiefert die drei Hauptträgheitsmomente.
SurfaceAreaLiefert die Oberfläche des Modells oder der mit AddBodies übergebenen Körper.
UserAssignedLiefert, ob die Masseneigenschaften des Dokuments vom Benutzer vorgegeben oder berechnet sind.
UseSystemUnitsLiest oder setzt, ob die Masseneigenschaften in Systemeinheiten oder in den Einheiten des Dokuments geliefert werden.
VolumeLiefert das Volumen des Modells oder der mit AddBodies übergebenen Körper.

Methoden 9, davon 9 beschrieben

NameBeschreibung
AddBodiesLegt die Körper fest, mit denen die Masseneigenschaften berechnet werden, auch temporäre Körper.
GetMomentOfInertiaLiefert die Trägheitsmomente bezogen auf den Schwerpunkt oder auf das Koordinatensystem.
SetAssignedMassPropGibt Masse und Schwerpunkt des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen vor.
SetCoordinateSystemLegt das Koordinatensystem fest, um das die Masseneigenschaften berechnet werden.
SetOverrideCenterOfMassValueÜberschreibt den Schwerpunkt des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen.
SetOverrideMassValueÜberschreibt die Masse des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen.
SetOverrideMomentsOfInertiaValueÜberschreibt die Trägheitsmomente des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen.
SetOverridePrincipleAxesOrientationÜberschreibt die Richtung einer Hauptträgheitsachse des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen.
SetOverridePrincipleMomentsOfInertiaÜberschreibt die Hauptträgheitsmomente des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen.

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

Siehe auch

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

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