Objekt · SldWorks
InterferenceDetectionMgr-Objekt
Der Manager für die Kollisionsprüfung in Baugruppen: Optionen der Prüfung, gefundene Kollisionen, Prüfung mit verschobenen Komponenten und Export der Ergebnisse.
Beschreibung
Mit InterferenceDetectionMgr prüfst du, ob sich die Komponenten einer Baugruppe überschneiden. Das entspricht der Kollisionsprüfung (interference detection) in der Oberfläche. Du setzt die Optionen, startest die Prüfung mit einem der Get-Befehle und beendest sie mit InterferenceDetectionMgr.Done. Die meisten Befehle gibt es seit SOLIDWORKS 2007, IgnoreHiddenBodies seit SOLIDWORKS 2011, die Befehle mit Transformationen seit SOLIDWORKS 2015 und ExportResults seit SOLIDWORKS 2021.
Zugriff
AssemblyDoc.InterferenceDetectionManager: der Manager der Baugruppe
Beispiel
' Prüft die aktive Baugruppe auf Kollisionen, gibt die Zahl der Kollisionen und
' Komponenten aus und speichert die Ergebnisse als Excel-Datei.
' Vorbedingung: Eine Baugruppe ist offen, der Ordner C:\Temp existiert.
' Ergebnis: Die Werte stehen im Direktfenster, die Ergebnisse in
' C:\Temp\Kollisionen.xlsx.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swAssy As SldWorks.AssemblyDoc
Dim swPruefung As SldWorks.InterferenceDetectionMgr
Dim vKollisionen As Variant
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocASSEMBLY Then Exit Sub
Set swAssy = swModel
Set swPruefung = swAssy.InterferenceDetectionManager
' Optionen wie im Hilfebeispiel "Run Interference Detection"
swPruefung.TreatCoincidenceAsInterference = False
swPruefung.TreatSubAssembliesAsComponents = False
swPruefung.IncludeMultibodyPartInterferences = True
swPruefung.IgnoreHiddenBodies = False
swPruefung.ShowIgnoredInterferences = False
swPruefung.UseTransform = False
swPruefung.NonInterferingComponentDisplay = swNonInterferingComponentDisplay_Wireframe
vKollisionen = swPruefung.GetInterferences
Debug.Print swPruefung.GetInterferenceCount & " Kollision(en), " & _
swPruefung.GetInterferenceComponentCount & " Komponente(n) beteiligt"
If Not IsEmpty(vKollisionen) Then
If False = swPruefung.ExportResults("C:\Temp\Kollisionen.xlsx", True) Then
Debug.Print "Export fehlgeschlagen"
End If
End If
swPruefung.Done
End SubBemerkungen
Ablauf: InterferenceDetectionMgr.GetInterferences, InterferenceDetectionMgr.GetInterferenceCount, InterferenceDetectionMgr.GetInterferenceComponents und InterferenceDetectionMgr.GetInterferenceComponentCount berechnen die Kollisionen und liefern sie dann. Die Optionen setzt du deshalb vorher. InterferenceDetectionMgr.Done beendet die Prüfung.
Hilfebeispiele: „Run Interference Detection“ öffnet mit dem veralteten AssemblyDoc.ToolsCheckInterference zuerst den PropertyManager „Kollisionsprüfung“, setzt alle Optionen, liest die Kollisionen und speichert sie mit ExportResults. Done steht dort auskommentiert, der PropertyManager bleibt offen. „Detect Interferences Using a Transform“ prüft mit InterferenceDetectionMgr.GetComponentsTransformInterference verschobene Komponenten. „Set Components and Transforms for Interference Detection“ verschiebt eine Komponente mit InterferenceDetectionMgr.SetComponentsAndTransforms und prüft danach, dass alle Komponenten nach Done wieder an ihrer Lage sind.
Optionen gelten nur vorübergehend: Bei CreateFastenersFolder, IgnoreHiddenBodies und ShowIgnoredInterferences sagt die Hilfe: Der Wert gilt nur, solange das Objekt besteht. Er bleibt weder über die Sitzung noch für die nächste Kollisionsprüfung in der Oberfläche erhalten. Für die übrigen Optionen sagt die Hilfe das nicht, vermutlich gilt es auch dort.
Acht Befehle nur in der Befehlsliste: IncludeMultibodyPartInterferences, MakeInterferingPartsTransparent, NonInterferingComponentDisplay, TreatCoincidenceAsInterference, TreatSubAssembliesAsComponents, GetComponentsTransformInterference, GetComponentsTransformInterferenceCount und GetInterferenceComponentCount haben in der .NET-Hilfe keine eigene Seite. Ihre Beschreibung steht nur in der Liste der Befehle.
Andere Prüfungen: Für die schnelle Prüfung zwischen Gruppen von Komponenten, die du an viele Lagen verschiebst, nennt die Hilfe den CollisionDetectionManager. Zwei Körper prüft Modeler.CheckInterferenceBetweenTwoBodies, ohne den Manager liefert AssemblyDoc.ToolsCheckInterference2 die Komponenten und Flächen mit Kollision. Abstände zwischen Komponenten prüft der ClearanceVerificationMgr.
SOLIDWORKS kann abstürzen, wenn du vor oder während der Kollisionsprüfung Komponenten und eine Transformation aus MathUtility.CreateTransform in globalen Variablen hältst.
Eigenschaften und Methoden
Eigenschaften 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| CreateFastenersFolder | Liest oder setzt, ob die Kollisionsprüfung Kollisionen mit Verbindungselementen in einem eigenen Ordner zusammenfasst. |
| IgnoreHiddenBodies | Liest oder setzt, ob die Kollisionsprüfung ausgeblendete Körper übergeht. |
| IncludeMultibodyPartInterferences | Liest oder setzt, ob die Kollisionsprüfung auch Kollisionen zwischen den Körpern eines Mehrkörperteils meldet. |
| MakeInterferingPartsTransparent | Liest oder setzt, ob die Komponenten der gewählten Kollision transparent dargestellt werden. |
| NonInterferingComponentDisplay | Liest oder setzt, wie die Kollisionsprüfung Komponenten ohne Kollision darstellt. |
| ShowIgnoredInterferences | Liest oder setzt, ob die Kollisionsprüfung ignorierte Kollisionen anzeigt. |
| TreatCoincidenceAsInterference | Liest oder setzt, ob sich berührende Elemente als Kollision zählen. |
| TreatSubAssembliesAsComponents | Liest oder setzt, ob Unterbaugruppen als einzelne Komponenten gelten, sodass Kollisionen innerhalb einer Unterbaugruppe nicht gemeldet werden. |
| UseTransform | Liest oder setzt, ob die Kollisionsprüfung die Transformationen aus SetComponentsAndTransforms nutzt. |
Methoden 10, davon 10 beschrieben
| Name | Beschreibung |
|---|---|
| Done | Beendet die Kollisionsprüfung. |
| ExportResults | Speichert die Ergebnisse der Kollisionsprüfung in eine Excel- oder CSV-Datei. |
| GetComponentsAndTransforms | Liefert die Komponenten mit Kollision und ihre Transformationen. |
| GetComponentsTransformInterference | Prüft übergebene Komponenten an der Lage aus übergebenen Transformationen und liefert die Komponenten mit Kollision. |
| GetComponentsTransformInterferenceCount | Liefert die Zahl der Komponenten mit Kollision für übergebene Komponenten und Transformationen. |
| GetInterferenceComponentCount | Berechnet und liefert die Zahl der Komponenten, die an Kollisionen beteiligt sind. |
| GetInterferenceComponents | Berechnet die Kollisionen und liefert alle Komponenten, die an einer Kollision beteiligt sind. |
| GetInterferenceCount | Berechnet und liefert die Zahl der Kollisionen. |
| GetInterferences | Berechnet die Kollisionen und liefert sie als Array. |
| SetComponentsAndTransforms | Setzt Komponenten und ihre Transformationen, mit denen die Kollisionsprüfung rechnet. |
Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IGetComponentsTransformInterference). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IInterferenceDetectionMgr in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.