Methode · DrawingDoc
GetInsertionPoint-Methode (DrawingDoc)
Liefert den aktuellen Einfügepunkt (Pickpunkt) der Zeichnung als x, y und z.
Syntax
Function GetInsertionPoint() As VariantvPunkt = swDraw.GetInsertionPointRückgabewert
Ein Array mit drei Double-Werten: x, y und z des Punkts. Eine Einheit und das Koordinatensystem nennt die Hilfe nicht. Vermutlich sind es wie sonst in der API Meter in Blattkoordinaten.
Beispiel
' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
Dim vPunkt As Variant
vPunkt = swDraw.GetInsertionPoint
If IsArray(vPunkt) Then
Debug.Print "X: " & Format(vPunkt(0) * 1000, "0.00") & " mm"
Debug.Print "Y: " & Format(vPunkt(1) * 1000, "0.00") & " mm"
Debug.Print "Z: " & Format(vPunkt(2) * 1000, "0.00") & " mm"
Else
Debug.Print "Kein Einfügepunkt geliefert."
End IfBemerkungen
Die Hilfe nennt den Punkt „insertion (pick) point“, erklärt aber nicht, wann SOLIDWORKS ihn setzt. Was zurückkommt, wenn es noch keinen solchen Punkt gibt, sagt sie ebenfalls nicht. Das Beispiel prüft deshalb vorsichtshalber mit IsArray. Die Umrechnung in mm setzt Meter voraus. Probier es in der eigenen Zeichnung aus, bevor du dich darauf verlässt.
Willst du mehrere ausgewählte Objekte auswerten, empfiehlt die Hilfe SelectionMgr.GetSelectionPointInSketchSpace2. Dort fragst du den Auswahlpunkt jedes Objekts einzeln über seinen Index in der Auswahl ab.
Die Koordinaten kommen in Metern zurück, die Umrechnung in mm im Beispiel stimmt also.
Siehe auch
Verfügbarkeit
In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.
Englisches Original: IDrawingDoc::GetInsertionPoint in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.