ClickEllipse()

Summary

Awaits user input from the system pointer and returns coordinates that define an ellipse.

 

Syntax

corners_array = ClickEllipse()

 

Returns

An array of two coordinates, as follows:

 

Element	Type	Contents
1	Coord	Location of the upper left corner of the rectangle defining the ellipse
2	Coord	Location of the lower right corner of the rectangle defining the ellipse

 

Notes

• When used in a map window, ClickEllipse() returns coordinate values in longitude and latitude.

• When used in a layout window, ClickEllipse() returns coordinate values in the current page units (e.g., inches).

• If the rectangle that defines the ellipse is so tiny as to likely be an inadvertent click instead of a drag, ClickEllipse() returns an array of two identical coordinates.

• This function should be called only from a macro that is activated from the menus, or from a tool in a toolbox or toolbar. Calling it from any other type of dialog box often causes confusion about which window is active (the dialog box, versus the map).

Example

pt = ClickEllipse()

 

Error Codes

Error Type	Meaning
Escape	The user clicked Cancel

 

See Also

Function	Summary
ClickCircle()	Awaits user input from the system pointer and returns a circle
ClickRect()	Awaits user input from the system pointer and returns two coordinates that define a rectangle