SolidWorksMakroprogrammierung

Methode · EquationMgr

Add3-Methode (EquationMgr)

Fügt eine Gleichung oder eine globale Variable an einem Index ein, für alle oder bestimmte Konfigurationen.

Syntax

Function Add3( _
   ByVal Index As Long, _
   ByVal Equation As String, _
   ByVal Solve As Boolean, _
   ByVal WhichConfigurations As Long, _
   ByVal ConfigNames As Variant _
) As Long
nIndex = swGleichungen.Add3(-1, """D1@Boss-Extrude1"" = 0.05in", True, swAllConfiguration, Empty)

Parameter

IndexLongByVal
Index der neuen Gleichung, ab 0. -1 hängt sie ans Ende der Liste.
EquationStringByVal
Der Text der Gleichung wie bei EquationMgr.Add2.
SolveBooleanByVal
True: die Gleichung sofort lösen. False: später lösen, etwa mit EquationMgr.EvaluateAll.
WhichConfigurationsLongByVal
Für welche Konfigurationen, ein Wert aus swInConfigurationOpts_e.
ConfigNamesVariantByVal
Array mit den Namen der Konfigurationen. Gilt nur bei swSpecifyConfiguration, dann muss die aktive Konfiguration mit im Array stehen. Sonst übergibst du Empty.

Rückgabewert

Der Index der neuen Gleichung, oder -1 bei einem Fehler.

Beispiel

' swGleichungen sind die Gleichungen eines Teils mit mehreren Konfigurationen (EquationMgr), etwa aus ModelDoc2.GetEquationMgr.
' „Lang“ ist die aktive Konfiguration.
Dim sKonfig(1) As String
Dim nIndex As Long
sKonfig(0) = "Lang"
sKonfig(1) = "Kurz"
nIndex = swGleichungen.Add3(-1, """D1@Boss-Extrude1"" = 0.05in", True, swSpecifyConfiguration, sKonfig)
If nIndex = -1 Then Debug.Print "Nicht angelegt"

Bemerkungen

Add3 geht nur bei Teilen mit mehreren Konfigurationen, die in SOLIDWORKS 2014 oder später erstellt wurden. Ohne mehrere Konfigurationen nimmst du EquationMgr.Add2, das etwas schneller ist. An anderer Stelle spricht die Hilfe von „models“ und nennt auch Baugruppenkomponenten: Für eine Gleichung direkt im Modell einer Komponente rufst du vorher AssemblyDoc.EditPart2 auf.

Weitere Regeln:

  • Globale Variablen und Gleichungen, die andere Bemaßungen nutzen („component equation“), brauchen swAllConfiguration.
  • Eine globale Variable, die es schon gibt, ergibt einen Fehler.
  • Eine Bemaßungsgleichung, deren linke Seite es schon gibt, darfst du nur anlegen, wenn die vorhandene unterdrückt ist. Das Anlegen hebt die Unterdrückung auf.
  • Mit Solve = False erscheint die Gleichung erst nach EquationMgr.EvaluateAll oder ModelDoc2.EditRebuild3 im FeatureManager.
  • Ändern kannst du die Gleichung mit EquationMgr.SetEquationAndConfigurationOption.
  • Füge keine Gleichung ein, während du die Gleichungen in einer Schleife durchläufst, SOLIDWORKS kann sonst abstürzen.

Das Hilfebeispiel „Add and Modify Equations“ legt mit swAllConfiguration und Empty die globale Variable "A" = 2in an Index 0 und "D1@Boss-Extrude1" = 0.05in an Index 1 an und ändert die zweite dann auf 0.07in.

Mit Index -1 hängt Add3 die Gleichung nicht unbedingt ans Ende: Sie kann auch an Index 0 vor den vorhandenen Einträgen landen. Lies den tatsächlichen Platz deshalb mit EquationMgr.Equation nach.

Siehe auch

In den Videos

Verfügbarkeit

SOLIDWORKS 2014

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

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