SolidWorksMakroprogrammierung

Objekt · SldWorks

MassPropertyOverrideOptions-Objekt

Die Werte, mit denen MassProperty2 die berechneten Masseneigenschaften überschreibt: Masse, Schwerpunkt, Trägheitsmomente, Hauptträgheitsachsen und Hauptträgheitsmomente.

Deklaration Dim x As SldWorks.MassPropertyOverrideOptions · in der englischen .NET-Hilfe: IMassPropertyOverrideOptions

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:

Zugriff

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 Sub

Bemerkungen

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

NameBeschreibung
OverrideCenterOfMassLiest oder setzt, ob der berechnete Schwerpunkt des Modells, das gerade bearbeitet wird, überschrieben wird.
OverrideMassLiest oder setzt, ob die berechnete Masse des Modells, das gerade bearbeitet wird, überschrieben wird.
OverrideMomentsOfInertiaLiest oder setzt, ob die berechneten Trägheitsmomente des Modells, das gerade bearbeitet wird, überschrieben werden.

Methoden 10, davon 10 beschrieben

NameBeschreibung
GetOverrideCenterOfMassValueLiefert den Schwerpunkt, mit dem der berechnete überschrieben wird, und den Namen seines Koordinatensystems.
GetOverrideMassValueLiefert die Masse, mit der die berechnete überschrieben wird.
GetOverrideMomentsOfInertiaValueLiefert die Trägheitsmomente, mit denen die berechneten überschrieben werden, und Angaben zu ihrem Bezugssystem.
GetOverridePrincipalAxesOrientationLiefert die Richtung einer Hauptträgheitsachse, mit der die berechnete überschrieben wird.
GetOverridePrincipalMomentsOfInertiaLiefert 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.