SolidWorksMakroprogrammierung

Methode · MassProperty

SetOverrideMassValue-Methode (MassProperty)

Überschreibt die Masse des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen.

Syntax

Function SetOverrideMassValue( _
   ByVal Value As Double, _
   ByVal Config_option As Long, _
   ByVal Config_names As Variant _
) As Boolean
bOk = swMass.SetOverrideMassValue(2.5, swThisConfiguration, Empty)

Parameter

ValueDoubleByVal
Die Masse. Ein Wert größer 0 überschreibt die Masse, bei einem Wert kleiner 0 wird sie berechnet.
Config_optionLongByVal
Für welche Konfigurationen, als Wert aus swInConfigurationOpts_e.
Config_namesVariantByVal
Array mit den Namen der Konfigurationen, nur bei swSpecifyConfiguration. Sonst übergibst du Empty.

Rückgabewert

True, wenn die Masse überschrieben wurde, sonst False.

Beispiel

' swMass sind die Masseneigenschaften (MassProperty), etwa aus ModelDocExtension.CreateMassProperty.
swMass.OverrideMass = True
swMass.SetOverrideMassValue 2.5, swThisConfiguration, Empty      ' kg
swMass.SetOverrideMassValue -1, swThisConfiguration, Empty       ' wieder berechnen

Bemerkungen

Wenn du gerade eine Unterkomponente bearbeitest, überschreibst du die Masse dieser Komponente, nicht des obersten Modells. Die Einheit nennt die Hilfe nicht; es sind Kilogramm (2,5 ergab 2,5 kg in einem MMGS-Teil). Was ein Wert von genau 0 bewirkt, sagt sie nicht. Bei MassProperty2 nimmst du MassPropertyOverrideOptions.SetOverrideMassValue.

Ein Wert kleiner 0 hebt die Überschreibung nicht auf: Neue Masseneigenschaften liefern danach weiter die überschriebene Masse, und MassProperty.UserAssigned bleibt True.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2013

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

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