Objekt · SldWorks
ClearanceVerificationMgr-Objekt
Der Manager für die Abstandsprüfung in Baugruppen: welche Komponenten und Flächen geprüft werden, der Mindestabstand und die Prüfung selbst.
Beschreibung
Mit ClearanceVerificationMgr prüfst du die Abstände zwischen gewählten Komponenten und Flächen einer Baugruppe. Du legst fest, was geprüft wird, und einen Mindestabstand. ClearanceVerificationMgr.CalculateClearances führt die Prüfung aus und liefert die Ergebnisse als ClearanceResult. Den Manager gibt es seit SOLIDWORKS 2024 SP01.
Zugriff
AssemblyDoc.ClearanceVerificationManager: der Manager einer Baugruppe
Beispiel
' Prüft die Abstände zwischen den ausgewählten Komponenten und Flächen mit einem Mindestabstand
' von 50 mm, wie das Hilfebeispiel, und gibt die Ergebnisse aus.
' Vorbedingung: Eine Baugruppe ist offen, mehrere Komponenten oder Flächen sind ausgewählt.
' Ergebnis: Die Ergebnisse stehen im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swAssy As SldWorks.AssemblyDoc
Dim swSelMgr As SldWorks.SelectionMgr
Dim swPruefung As SldWorks.ClearanceVerificationMgr
Dim swErgebnis As SldWorks.ClearanceResult
Dim aKomponenten() As SldWorks.Component2
Dim aFlaechen() As SldWorks.Face2
Dim vKomponenten As Variant, vFlaechen As Variant, vErgebnisse As Variant
Dim nKomp As Long, nFl As Long, nFehler As Long, i As Long
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 swSelMgr = swModel.SelectionManager
For i = 1 To swSelMgr.GetSelectedObjectCount2(-1)
Select Case swSelMgr.GetSelectedObjectType3(i, -1)
Case swSelCOMPONENTS
ReDim Preserve aKomponenten(nKomp)
Set aKomponenten(nKomp) = swSelMgr.GetSelectedObject6(i, -1)
nKomp = nKomp + 1
Case swSelFACES
ReDim Preserve aFlaechen(nFl)
Set aFlaechen(nFl) = swSelMgr.GetSelectedObject6(i, -1)
nFl = nFl + 1
End Select
Next i
If nKomp > 0 Then vKomponenten = aKomponenten ' sonst bleibt der Variant leer
If nFl > 0 Then vFlaechen = aFlaechen
Set swPruefung = swAssy.ClearanceVerificationManager
If False = swPruefung.SetComponentsOrFacesToCheck(vKomponenten, vFlaechen, nFehler) Then
Debug.Print "Auswahl nicht übernommen, Fehler " & nFehler
Exit Sub
End If
swPruefung.SetMinimumAcceptableClearance 0.05 ' 50 mm, in Metern
swPruefung.CheckClearanceBetween = swCheckClearanceBetweenSelectedItems
swPruefung.TreatSubAssembliesAsComponents = False
swPruefung.IgnoreClearanceEqualToSpecifiedValue = True
vErgebnisse = swPruefung.CalculateClearances
If Not IsArray(vErgebnisse) Then
Debug.Print "Keine Ergebnisse"
Exit Sub
End If
For i = 0 To UBound(vErgebnisse)
Set swErgebnis = vErgebnisse(i)
If swErgebnis.ClearanceType = swClearanceType_Distance Then
Debug.Print i + 1 & ": " & Format(swErgebnis.ClearanceValue * 1000, "0.00") & " mm"
Else
Debug.Print i + 1 & ": Berührung"
End If
Next i
End SubBemerkungen
Fehlende Seiten: Nur CheckClearanceBetween und CalculateClearances haben in der Hilfe eine eigene Seite. Die übrigen Befehle beschreibt sie nur in der Liste der Befehle des Objekts, ohne Parameter und Versionsangabe.
Welche Ergebnisse: Ob CalculateClearances nur Abstände unter dem Mindestabstand liefert, sagt die API-Hilfe nicht. Für Einzelheiten zur Abstandsprüfung verweist sie auf „Assemblies > Detecting Problems > Clearance Verification“ in der SOLIDWORKS-Hilfe.
Einheit: Das Hilfebeispiel setzt den Mindestabstand 0,05 und nennt das „0.05 m“. Auch ClearanceResult.ClearanceValue gibt es in Metern aus.
Hilfebeispiel: Ist etwas anderes als Komponenten oder Flächen ausgewählt, beendet das Hilfebeispiel das Makro mit End. Das Beispiel hier überspringt solche Elemente.
ClearanceVerificationMgr.CalculateClearances meldet nur Abstände, die unter dem Mindestabstand liegen.
Eigenschaften und Methoden
Eigenschaften 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| CheckClearanceBetween | Liest oder setzt, ob die Abstände nur zwischen den gewählten Elementen oder auch zum Rest der Baugruppe geprüft werden. |
| IgnoreClearanceEqualToSpecifiedValue | Liest oder setzt, ob Abstände ignoriert werden, die dem Mindestabstand entsprechen, nach Angabe der Hilfe auch größere. |
| TreatSubAssembliesAsComponents | Liest oder setzt, ob Unterbaugruppen bei der Abstandsprüfung als einzelne Komponenten gelten. |
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| CalculateClearances | Führt die Abstandsprüfung für die gewählten Komponenten und Flächen aus und liefert die Ergebnisse. |
| GetComponentsOrFacesToCheck | Liefert die Komponenten und Flächen, deren Abstände geprüft werden. |
| GetMinimumAcceptableClearance | Liefert den Mindestabstand der Abstandsprüfung. |
| SetComponentsOrFacesToCheck | Legt die Komponenten und Flächen fest, deren Abstände geprüft werden. |
| SetMinimumAcceptableClearance | Setzt den Mindestabstand der Abstandsprüfung. |
Siehe auch
Englisches Original: IClearanceVerificationMgr in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.