SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.InterferenceDetectionMgr · in der englischen .NET-Hilfe: IInterferenceDetectionMgr

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

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 Sub

Bemerkungen

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

NameBeschreibung
CreateFastenersFolderLiest oder setzt, ob die Kollisionsprüfung Kollisionen mit Verbindungselementen in einem eigenen Ordner zusammenfasst.
IgnoreHiddenBodiesLiest oder setzt, ob die Kollisionsprüfung ausgeblendete Körper übergeht.
IncludeMultibodyPartInterferencesLiest oder setzt, ob die Kollisionsprüfung auch Kollisionen zwischen den Körpern eines Mehrkörperteils meldet.
MakeInterferingPartsTransparentLiest oder setzt, ob die Komponenten der gewählten Kollision transparent dargestellt werden.
NonInterferingComponentDisplayLiest oder setzt, wie die Kollisionsprüfung Komponenten ohne Kollision darstellt.
ShowIgnoredInterferencesLiest oder setzt, ob die Kollisionsprüfung ignorierte Kollisionen anzeigt.
TreatCoincidenceAsInterferenceLiest oder setzt, ob sich berührende Elemente als Kollision zählen.
TreatSubAssembliesAsComponentsLiest oder setzt, ob Unterbaugruppen als einzelne Komponenten gelten, sodass Kollisionen innerhalb einer Unterbaugruppe nicht gemeldet werden.
UseTransformLiest oder setzt, ob die Kollisionsprüfung die Transformationen aus SetComponentsAndTransforms nutzt.

Methoden 10, davon 10 beschrieben

NameBeschreibung
DoneBeendet die Kollisionsprüfung.
ExportResultsSpeichert die Ergebnisse der Kollisionsprüfung in eine Excel- oder CSV-Datei.
GetComponentsAndTransformsLiefert die Komponenten mit Kollision und ihre Transformationen.
GetComponentsTransformInterferencePrüft übergebene Komponenten an der Lage aus übergebenen Transformationen und liefert die Komponenten mit Kollision.
GetComponentsTransformInterferenceCountLiefert die Zahl der Komponenten mit Kollision für übergebene Komponenten und Transformationen.
GetInterferenceComponentCountBerechnet und liefert die Zahl der Komponenten, die an Kollisionen beteiligt sind.
GetInterferenceComponentsBerechnet die Kollisionen und liefert alle Komponenten, die an einer Kollision beteiligt sind.
GetInterferenceCountBerechnet und liefert die Zahl der Kollisionen.
GetInterferencesBerechnet die Kollisionen und liefert sie als Array.
SetComponentsAndTransformsSetzt 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.