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 LongnIndex = swGleichungen.Add3(-1, """D1@Boss-Extrude1"" = 0.05in", True, swAllConfiguration, Empty)Parameter
IndexLongByVal- Index der neuen Gleichung, ab 0.
-1hängt sie ans Ende der Liste. EquationStringByVal- Der Text der Gleichung wie bei
EquationMgr.Add2. SolveBooleanByValTrue: die Gleichung sofort lösen.False: später lösen, etwa mitEquationMgr.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 duEmpty.
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=Falseerscheint die Gleichung erst nachEquationMgr.EvaluateAlloderModelDoc2.EditRebuild3im 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.