SolidWorksMakroprogrammierung

Methode · Vertex

GetClosestPointOn-Methode (Vertex)

Liefert zu einem gegebenen Punkt den nächsten Punkt am Eckpunkt, also den Eckpunkt selbst.

Syntax

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

Parameter

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

Rückgabewert

Ein Array mit fünf Double-Werten. Die ersten drei sind X, Y, Z des Eckpunkts. Was die beiden übrigen bedeuten, sagt die Hilfe nicht.

Beispiel

' swVertex ist ein Eckpunkt (Vertex), etwa aus Edge.GetStartVertex.
Dim vPunkt As Variant
vPunkt = swVertex.GetClosestPointOn(0, 0, 0)
Debug.Print "Abstand: " & Sqr(vPunkt(0) ^ 2 + vPunkt(1) ^ 2 + vPunkt(2) ^ 2) * 1000 & " mm"

Bemerkungen

Du bekommst immer die Lage des Eckpunkts, weil er nur ein Punkt ist. Der Befehl ist für Code gedacht, der Kanten, Flächen und Eckpunkte gleich behandelt. Für einen einzelnen Eckpunkt reicht Vertex.GetPoint.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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