SolidWorksMakroprogrammierung

Methode · Face2

GetClosestPointOn-Methode (Face2)

Liefert den Punkt einer Fläche, der einem gegebenen Punkt am nächsten liegt.

Syntax

Function GetClosestPointOn( _
   ByVal X As Double, _
   ByVal Y As Double, _
   ByVal Z As Double _
) As Variant
vPunkt = swFace.GetClosestPointOn(dX, dY, dZ)

Parameter

XDoubleByVal
X des Punkts in Metern.
YDoubleByVal
Y des Punkts.
ZDoubleByVal
Z des Punkts.

Rückgabewert

Array mit fünf Double-Werten: X, Y, Z des nächsten Punkts, dann seine U- und V-Parameter auf der Fläche.

Beispiel

' swSelMgr ist der SelectionMgr, als erstes ist eine Fläche ausgewählt.
Dim swFace As SldWorks.Face2
Dim vKlick As Variant, vPunkt As Variant
Set swFace = swSelMgr.GetSelectedObject6(1, -1)
vKlick = swSelMgr.GetSelectionPoint2(1, -1)
vPunkt = swFace.GetClosestPointOn(vKlick(0), vKlick(1), vKlick(2))
Debug.Print vPunkt(0) * 1000 & " / " & vPunkt(1) * 1000 & " / " & vPunkt(2) * 1000 & " mm"

Bemerkungen

Es kommt nur ein Punkt, auch wenn mehrere gleich nah sind. Die Hilfe zu SelectionMgr.GetSelectionPoint2 empfiehlt genau diesen Weg, weil der Klickpunkt nicht auf der Fläche liegen muss.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2001Plus

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

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