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