SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.EquationMgr · in der englischen .NET-Hilfe: IEquationMgr

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

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 Sub

Bemerkungen

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

NameBeschreibung
AngularEquationUnitsLiest oder setzt, in welcher Winkeleinheit die Gleichungen des Dokuments rechnen: Grad oder Bogenmaß.
AutomaticRebuildLiest oder setzt, ob das Modell nach Änderungen an den Gleichungen automatisch neu aufgebaut wird.
AutomaticSolveOrderLiest oder setzt, ob SOLIDWORKS die Reihenfolge festlegt, in der die Gleichungen gelöst werden.
DisabledLiest oder setzt, ob eine Gleichung deaktiviert ist.
EquationLiest oder setzt den Text einer Gleichung oder einer globalen Variable.
FilePathLiest oder setzt den Pfad der Textdatei (.txt), in die die Gleichungen exportiert sind.
GlobalVariableLiefert, ob der Eintrag an einem Index eine globale Variable ist und keine Gleichung.
LinkToFileLiest oder setzt, ob die Gleichungen mit einer exportierten Textdatei (.txt) verknüpft sind.
StatusLiefert, ob der letzte Befehl mit einem Gleichungsindex geklappt hat: den Index der Gleichung oder -1 bei einem Fehler.
Suppressionveraltet
ValueLiefert den berechneten Wert einer Gleichung oder einer globalen Variable.

Methoden 12, davon 11 beschrieben, 1 veraltet

NameBeschreibung
Addveraltet ersetzt durch EquationMgr.Add3
Add2Fügt eine Gleichung oder eine globale Variable an einem Index ein, ohne Unterscheidung nach Konfigurationen.
Add3Fügt eine Gleichung oder eine globale Variable an einem Index ein, für alle oder bestimmte Konfigurationen.
ChangeSuppressionForAllConfigurationsUnterdrückt eine Gleichung in allen Konfigurationen oder hebt die Unterdrückung auf, nur für Gleichungen aus Versionen vor SOLIDWORKS 2014.
ChangeSuppressionForConfigurationUnterdrückt eine Gleichung in einer Konfiguration oder hebt die Unterdrückung auf, nur für Gleichungen aus Versionen vor SOLIDWORKS 2014.
DeleteLöscht eine Gleichung oder globale Variable.
EvaluateAllLöst alle Gleichungen, auch die, die mit Add2 oder Add3 ohne sofortiges Lösen angelegt wurden.
GetConfigurationOptionLiefert, für welche Konfigurationen eine Gleichung gilt.
GetCountLiefert die Zahl der Gleichungen und globalen Variablen im Modell.
GetDisabledEquationCountLiefert die Zahl der deaktivierten Gleichungen im Modell.
SetEquationAndConfigurationOptionÄndert eine Gleichung, die mit Add3 angelegt wurde, für alle oder bestimmte Konfigurationen.
UpdateValuesFromExternalEquationFileAktualisiert 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.