GetEntity Method

Gets an object interactively.

See Also | Example


object.GetEntity Object, PickedPoint[, Prompt]


The object or objects this method applies to.


Object; output-only
The picked object. Can be one of any of the Drawing Objects.


Variant (three-element array of doubles); output-only
A 3D WCS coordinate specifying the point that was selected.


Variant (string); input-only; optional
The text to display that prompts the user for input.


This method requires the AutoCAD user to select an object by picking a point on the graphics screen. If an object is picked, it is returned in the first parameter and the second parameter will contain the point picked in WCS coordinates. If the pick point is not on an object the call will fail.

The pick point returned by GetEntity does not necessarily lie on the selected object. The returned point represents the location of the crosshairs at the time of selection. The relationship between this point and the object varies depending on the size of the pickbox and the current zoom scale.

This method can retrieve an object even if it is not visible on the screen or if it is on a frozen layer.