Objekt · SldWorks
EquationMgr-Objekt
Die Gleichungen und globalen Variablen eines Modells: lesen, anlegen, ändern, löschen, deaktivieren und lösen, auch je Konfiguration und mit einer verknüpften Gleichungsdatei.
Beschreibung
EquationMgr führt die Liste aller Gleichungen eines Modells. Dazu gehören auch die globalen Variablen, etwa "Breite" = 50mm. Gleichungen und globale Variablen stehen in derselben Liste. Jeder Eintrag hat einen Index ab 0, über den du ihn mit den Befehlen ansprichst. Den Text liest du mit EquationMgr.Equation, den berechneten Wert mit EquationMgr.Value. Die ältesten Befehle gibt es seit SOLIDWORKS 99, die Befehle für Konfigurationen seit SOLIDWORKS 2014.
Zugriff
ModelDoc2.GetEquationMgr: die Gleichungen eines Teils oder einer Baugruppe
Beispiel
' Listet alle Gleichungen und globalen Variablen des aktiven Modells mit
' ihrem Wert auf und legt die globale Variable "Breite" an, wenn es sie
' noch nicht gibt.
' Vorbedingung: Ein Teil oder eine Baugruppe ist offen.
' Ergebnis: Die Liste steht im Direktfenster (Strg+G), "Breite" steht
' im Dialog Gleichungen.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swGleichungen As SldWorks.EquationMgr
Dim sArt As String
Dim bGibtEs As Boolean
Dim nIndex As Long
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType = swDocDRAWING Then Exit Sub
Set swGleichungen = swModel.GetEquationMgr
If swGleichungen Is Nothing Then Exit Sub
' Lesen: nichts ändern, solange die Schleife läuft
For i = 0 To swGleichungen.GetCount - 1
If swGleichungen.GlobalVariable(i) Then sArt = "globale Variable" Else sArt = "Gleichung"
Debug.Print i & " (" & sArt & "): " & swGleichungen.Equation(i) & " = " & swGleichungen.Value(i)
If InStr(1, swGleichungen.Equation(i), """Breite""", vbTextCompare) = 1 Then bGibtEs = True
Next i
' Anlegen erst nach der Schleife
If False = bGibtEs Then
If swModel.GetConfigurationCount > 1 Then
nIndex = swGleichungen.Add3(-1, """Breite"" = 50mm", True, swAllConfiguration, Empty)
Else
nIndex = swGleichungen.Add2(-1, """Breite"" = 50mm", True)
End If
If nIndex = -1 Then
Debug.Print "Breite nicht angelegt"
Else
Debug.Print "Neu: " & swGleichungen.Equation(nIndex) & " = " & swGleichungen.Value(nIndex)
End If
End If
End SubBemerkungen
Text einer Gleichung: Du schreibst den Text wie im Dialog „Gleichungen“: Die Namen der Bemaßungen und globalen Variablen stehen in Anführungszeichen, etwa "D1@Extrude2" = "D1@Extrude3" / 2. In VBA verdoppelst du diese Anführungszeichen und setzt den ganzen Text in Anführungszeichen: """D1@Extrude2"" = ""D1@Extrude3"" / 2". Weitere Formen der Hilfe stehen bei EquationMgr.Equation.
Nicht in der Schleife ändern: Anlegen, Löschen und Deaktivieren ändern die Liste der Beziehungen. Tu das nicht, während du die Gleichungen durchläufst, SOLIDWORKS kann sonst abstürzen. Das Beispiel oben merkt sich deshalb in der Schleife nur, ob es „Breite“ schon gibt.
Add2 oder Add3: Für Modelle mit mehreren Konfigurationen, die in SOLIDWORKS 2014 oder später erstellt wurden, nimmst du EquationMgr.Add3, sonst EquationMgr.Add2. Ändern kannst du eine mit Add3 angelegte Gleichung mit EquationMgr.SetEquationAndConfigurationOption, bei nur einer Konfiguration mit EquationMgr.Equation. Globale Variablen brauchen bei Add3 swAllConfiguration aus swInConfigurationOpts_e. Ob ein Modell vor 2014 erstellt wurde, prüft das Beispiel oben nicht, es nimmt nur die Zahl der Konfigurationen.
Konfiguration: Der EquationMgr gehört zu der Konfiguration, die beim Abrufen aktiv war. Wechselst du die aktive Konfiguration, etwa mit ModelDoc2.ShowConfiguration2, holst du ihn mit ModelDoc2.GetEquationMgr neu.
Baugruppen: Du musst das Modell einer Komponente im Kontext bearbeiten, etwa mit AssemblyDoc.EditPart2, bevor du dort Gleichungen anlegst oder änderst.
Später lösen: Mit Solve = False bei EquationMgr.Add2 und EquationMgr.Add3 legst du viele Gleichungen schneller an. Dann löst du sie mit EquationMgr.EvaluateAll oder ModelDoc2.EditRebuild3, erst danach erscheinen sie im FeatureManager.
Hilfebeispiele: „Get Equation Values“ gibt Text, Wert, Status und GlobalVariable jedes Eintrags aus. „Add Equation and Evaluate All“ löscht Gleichungen, legt 26 globale Variablen A bis Z ohne sofortiges Lösen an und löst sie mit EvaluateAll. „Use IIf Function When Adding an Equation“ legt eine Gleichung mit der VBA-Funktion IIf an. „Add and Modify Equations“ arbeitet mit Add3 und SetEquationAndConfigurationOption, „Disable Equation“ mit Disabled, „Automatically Solve Equations in Sequence“ mit AutomaticSolveOrder und „Pack and Go Part and Linked Equation“ mit einer verknüpften Gleichungsdatei.
Veraltet: EquationMgr.Add ist durch EquationMgr.Add2 ersetzt. EquationMgr.Suppression ist seit SOLIDWORKS 2014 veraltet, die Hilfe nennt keinen Nachfolger.
EquationMgr.Value liefert den Wert in der Einheit des Dokuments, bei Millimeter also 40 für „40mm“ und nicht 0,04.
Eigenschaften und Methoden
Eigenschaften 11, davon 10 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| AngularEquationUnits | Liest oder setzt, in welcher Winkeleinheit die Gleichungen des Dokuments rechnen: Grad oder Bogenmaß. |
| AutomaticRebuild | Liest oder setzt, ob das Modell nach Änderungen an den Gleichungen automatisch neu aufgebaut wird. |
| AutomaticSolveOrder | Liest oder setzt, ob SOLIDWORKS die Reihenfolge festlegt, in der die Gleichungen gelöst werden. |
| Disabled | Liest oder setzt, ob eine Gleichung deaktiviert ist. |
| Equation | Liest oder setzt den Text einer Gleichung oder einer globalen Variable. |
| FilePath | Liest oder setzt den Pfad der Textdatei (.txt), in die die Gleichungen exportiert sind. |
| GlobalVariable | Liefert, ob der Eintrag an einem Index eine globale Variable ist und keine Gleichung. |
| LinkToFile | Liest oder setzt, ob die Gleichungen mit einer exportierten Textdatei (.txt) verknüpft sind. |
| Status | Liefert, ob der letzte Befehl mit einem Gleichungsindex geklappt hat: den Index der Gleichung oder -1 bei einem Fehler. |
| Suppression | veraltet |
| Value | Liefert den berechneten Wert einer Gleichung oder einer globalen Variable. |
Methoden 12, davon 11 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| Add | veraltet ersetzt durch EquationMgr.Add3 |
| Add2 | Fügt eine Gleichung oder eine globale Variable an einem Index ein, ohne Unterscheidung nach Konfigurationen. |
| Add3 | Fügt eine Gleichung oder eine globale Variable an einem Index ein, für alle oder bestimmte Konfigurationen. |
| ChangeSuppressionForAllConfigurations | Unterdrückt eine Gleichung in allen Konfigurationen oder hebt die Unterdrückung auf, nur für Gleichungen aus Versionen vor SOLIDWORKS 2014. |
| ChangeSuppressionForConfiguration | Unterdrückt eine Gleichung in einer Konfiguration oder hebt die Unterdrückung auf, nur für Gleichungen aus Versionen vor SOLIDWORKS 2014. |
| Delete | Löscht eine Gleichung oder globale Variable. |
| EvaluateAll | Löst alle Gleichungen, auch die, die mit Add2 oder Add3 ohne sofortiges Lösen angelegt wurden. |
| GetConfigurationOption | Liefert, für welche Konfigurationen eine Gleichung gilt. |
| GetCount | Liefert die Zahl der Gleichungen und globalen Variablen im Modell. |
| GetDisabledEquationCount | Liefert die Zahl der deaktivierten Gleichungen im Modell. |
| SetEquationAndConfigurationOption | Ändert eine Gleichung, die mit Add3 angelegt wurde, für alle oder bestimmte Konfigurationen. |
| UpdateValuesFromExternalEquationFile | Aktualisiert die Gleichungen aus der verknüpften Gleichungsdatei und prüft, ob es die Datei noch gibt. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IAdd3). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IEquationMgr in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.