Editor.Snap Method to change the snap mode of point

<?xml encoding=”UTF-8″>By Deepak Nadig

In your workflow of using Editor.GetEntity you may sometimes want to retrieve
all the co-ordinates of pickpoint used to select the entity.

For example consider the following case by constructing a circle at point (0,0,5) and radius 5 on WCS XY-plane with top view.
On selecting a point on circle using Editor.GetEntity, PromptEntityResult.PickedPoint returns : (3.50064192661003 , 3.35618169844321 , 0)

To get all the co-ordinates,it may be useful to change the point to nearest snap mode using Editor.Snap that returns the Z co-ordinate as well. 

Code:

[CommandMethod(<span>"getEntityPickPoint"</span>)]
<span>public</span> <span>static</span> <span>void</span> getEntityPickPoint()
{
Document doc <span>=</span> <span>Application</span>.DocumentManager.MdiActiveDocument;
Database db <span>=</span> doc.Database;
Editor ed <span>=</span> doc.Editor;
PromptEntityOptions peo <span>=</span> <span>new</span> PromptEntityOptions(<span>"<span>n</span>Select Entity"</span>);
PromptEntityResult per <span>=</span> ed.GetEntity(peo);
<span>if</span> (per.Status <span>=</span><span>=</span> PromptStatus.OK)
{
Point3d pickedPoint <span>=</span> per.PickedPoint;
Point3d pickedPtOsnap <span>=</span> ed.Snap(<span>"_near"</span>, pickedPoint);
ed.WriteMessage(<span>"<span>n</span> Selected pick point: {0}"</span>, pickedPoint.ToString());
ed.WriteMessage(<span>"<span>n</span> Selected Picked Point Osnap near: {0}"</span>, pickedPtOsnap);
}
}

Result:

Command: GETENTITYPICKPOINT
Select Entity:
Selected pick point: (3.50064192661003,3.35618169844321,0)
Selected Picked Point Osnap near: (3.60921996485993,3.46027907043009,5)

More about object osnaps :
https://knowledge.autodesk.com/de/search-result/caas/CloudHelp/cloudhelp/2017/DEU/AutoCAD-AutoLISP/files/GUID-4EEE5488-01D8-454F-9386-79E493E55D6E-htm.html