Objekt · SldWorks
ClearanceResult-Objekt
Ein Ergebnis der Abstandsprüfung in einer Baugruppe: die beteiligten Komponenten oder Flächen, die Art und der Abstand.
Beschreibung
ClearanceResult gibt Zugriff auf die Ergebnisse der Abstandsprüfung. ClearanceVerificationMgr.CalculateClearances liefert ein Array solcher Objekte, eines je Ergebnis. Für Einzelheiten zur Abstandsprüfung verweist die Hilfe auf „Assemblies > Detecting Problems > Clearance Verification“ in der SOLIDWORKS-Hilfe. Das Objekt gibt es seit SOLIDWORKS 2024 SP01.
Zugriff
ClearanceVerificationMgr.CalculateClearances: alle Ergebnisse einer Abstandsprüfung
Beispiel
' Prüft die Abstände zwischen den ausgewählten Komponenten und dem Rest der Baugruppe
' mit einem Mindestabstand von 5 mm und gibt jedes Ergebnis aus.
' Vorbedingung: Eine Baugruppe ist offen, eine oder mehrere Komponenten 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 swObj As Object
Dim swComp As SldWorks.Component2
Dim aKomponenten() As SldWorks.Component2
Dim vKomponenten As Variant, vFlaechen As Variant, vErgebnisse As Variant, vElemente As Variant
Dim nFehler As Long, n As Long, i As Long, j As Long
Dim sText As String
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)
If swSelMgr.GetSelectedObjectType3(i, -1) = swSelCOMPONENTS Then
ReDim Preserve aKomponenten(n)
Set aKomponenten(n) = swSelMgr.GetSelectedObject6(i, -1)
n = n + 1
End If
Next i
If n = 0 Then Exit Sub
vKomponenten = aKomponenten ' vFlaechen bleibt leer
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.005 ' 5 mm, in Metern
swPruefung.CheckClearanceBetween = swCheckClearanceBetweenSelectedItemsAndRestAssembly
vErgebnisse = swPruefung.CalculateClearances
If Not IsArray(vErgebnisse) Then Exit Sub
For i = 0 To UBound(vErgebnisse)
Set swErgebnis = vErgebnisse(i)
sText = ""
vElemente = swErgebnis.ComponentsOrFaces
For j = 0 To UBound(vElemente)
Set swObj = vElemente(j)
If TypeOf swObj Is SldWorks.Component2 Then
Set swComp = swObj
sText = sText & swComp.Name2 & " "
Else
sText = sText & "(Fläche) "
End If
Next j
If swErgebnis.ClearanceType = swClearanceType_Distance Then
Debug.Print sText & Format(swErgebnis.ClearanceValue * 1000, "0.00") & " mm"
Else
Debug.Print sText & "berühren sich"
End If
Next i
End SubBemerkungen
Art und Wert: ClearanceResult.ClearanceValue gilt nur bei der Art swClearanceType_Distance. Die Einheit nennt die Hilfe nicht, ihr Beispiel gibt den Wert aber mit „(m)“ aus.
Welche Ergebnisse: Ob CalculateClearances nur Abstände unter dem Mindestabstand liefert, sagt die API-Hilfe nicht, siehe ClearanceVerificationMgr.
ClearanceVerificationMgr.CalculateClearances liefert nur Ergebnisse für Abstände unter dem Mindestabstand.
Eigenschaften und Methoden
Eigenschaften 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| ClearanceType | Liefert die Art des Ergebnisses der Abstandsprüfung: Abstand oder Berührung. |
| ClearanceValue | Liefert den gefundenen Abstand, wenn das Ergebnis die Art Abstand hat. |
| ComponentsOrFaces | Liefert die Komponenten oder Flächen, zwischen denen der Abstand gefunden wurde. |
Siehe auch
Englisches Original: IClearanceResult in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.