SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.ClearanceVerificationMgr · in der englischen .NET-Hilfe: IClearanceVerificationMgr

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

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 Sub

Bemerkungen

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

NameBeschreibung
CheckClearanceBetweenLiest oder setzt, ob die Abstände nur zwischen den gewählten Elementen oder auch zum Rest der Baugruppe geprüft werden.
IgnoreClearanceEqualToSpecifiedValueLiest oder setzt, ob Abstände ignoriert werden, die dem Mindestabstand entsprechen, nach Angabe der Hilfe auch größere.
TreatSubAssembliesAsComponentsLiest oder setzt, ob Unterbaugruppen bei der Abstandsprüfung als einzelne Komponenten gelten.

Methoden 5, davon 5 beschrieben

NameBeschreibung
CalculateClearancesFührt die Abstandsprüfung für die gewählten Komponenten und Flächen aus und liefert die Ergebnisse.
GetComponentsOrFacesToCheckLiefert die Komponenten und Flächen, deren Abstände geprüft werden.
GetMinimumAcceptableClearanceLiefert den Mindestabstand der Abstandsprüfung.
SetComponentsOrFacesToCheckLegt die Komponenten und Flächen fest, deren Abstände geprüft werden.
SetMinimumAcceptableClearanceSetzt 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.