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 VariantvPunkt = 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.