SolidWorksMakroprogrammierung

Methode · ModelDoc2

ClosestDistance-Methode (ModelDoc2)

Berechnet den kleinsten Abstand zwischen zwei Geometrieobjekten und die nächsten Punkte darauf.

Syntax

Function ClosestDistance( _
   ByVal Object1 As Object, _
   ByVal Object2 As Object, _
   ByRef Point1 As Variant, _
   ByRef Point2 As Variant _
) As Double
dAbstand = swModel.ClosestDistance(swObj1, swObj2, vP1, vP2)

Parameter

Object1ObjectByVal
Erstes Objekt (siehe Bemerkungen).
Object2ObjectByVal
Zweites Objekt.
Point1VariantByRef · Rückgabe
Gibt den Punkt auf Object1 zurück, der Object2 am nächsten liegt (x, y, z).
Point2VariantByRef · Rückgabe
Gibt den Punkt auf Object2 zurück, der Object1 am nächsten liegt.

Rückgabewert

Abstand in Metern, -1 wenn es keine Lösung gibt.

Beispiel

' swModel ist ein Teil, in dem zwei Flächen ausgewählt sind.
Dim swSelMgr As SldWorks.SelectionMgr
Dim vP1 As Variant, vP2 As Variant
Dim dAbstand As Double
Set swSelMgr = swModel.SelectionManager
dAbstand = swModel.ClosestDistance(swSelMgr.GetSelectedObject6(1, -1), _
    swSelMgr.GetSelectedObject6(2, -1), vP1, vP2)
If dAbstand >= 0 Then
    Debug.Print "Abstand: " & dAbstand * 1000 & " mm"
    Debug.Print "von " & vP1(0) & "/" & vP1(1) & "/" & vP1(2) & " nach " & vP2(0) & "/" & vP2(1) & "/" & vP2(2)
End If

Bemerkungen

Erlaubt sind Flächen, Kanten, Eckpunkte, Skizzenelemente, Referenzebenen, der Ursprungspunkt, Referenzachsen, Referenzkurven, Volumenkörper (keine Flächenkörper) und Komponenten (Mehrkörperteile ja, Unterbaugruppen aus mehreren Teilen nein).

In Zeichnungen gilt: Zwischen Skizzenelement und Modellelement kann nicht gemessen werden, gemessene Skizzenelemente müssen auf demselben Blatt liegen, Modellmaße beziehen sich auf den Modellursprung, und temporäre Geometrie geht nicht.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2001Plus

Englisches Original: IModelDoc2::ClosestDistance in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.