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 |