ClickCoord()
Summary
Awaits user input from the system pointer and returns a coordinate.
Syntax
user_coord = ClickCoord()
Returns
A coordinate.
Notes
-
When used in a map window, ClickCoord() returns longitude and latitude values.
-
When used in a layout window, ClickCoord() returns layout X and Y axis values in the current page units.
-
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 = ClickCoord()
Error Codes
| Error Type | Meaning |
|---|---|
| Escape | The user clicked Cancel |
| NotFound | The input coordinate is invalid (e.g., off the world) |
See Also
| Function | Summary |
|---|---|
| ClickCircle() | Awaits user input from the system pointer and returns a circle |
| ClickPolyline() | Awaits user input from the system pointer and returns an array of coordinates that define a line |
| ClickRect() | Awaits user input from the system pointer and returns two coordinates that define a rectangle |
| ClickScope() | Awaits user input of a rectangle on the map window, and returns a scope |