Gets an object interactively.

See Also | Example

Signature

object.GetEntity Object, PickedPoint[, Prompt]

Object

Utility
The object or objects this method applies to.

Object

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

PickedPoint

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

Prompt

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

Remarks

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.