SolidWorksMakroprogrammierung

Objekt · SldWorks

ClearanceResult-Objekt

Ein Ergebnis der Abstandsprüfung in einer Baugruppe: die beteiligten Komponenten oder Flächen, die Art und der Abstand.

Deklaration Dim x As SldWorks.ClearanceResult · in der englischen .NET-Hilfe: IClearanceResult

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

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 Sub

Bemerkungen

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

NameBeschreibung
ClearanceTypeLiefert die Art des Ergebnisses der Abstandsprüfung: Abstand oder Berührung.
ClearanceValueLiefert den gefundenen Abstand, wenn das Ergebnis die Art Abstand hat.
ComponentsOrFacesLiefert 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.