ClickLine()

Summary

Awaits user input from the system pointer and returns two coordinates that define a line.

 

Syntax

coord_array = ClickLine()

 

Returns

An array of two coordinates, the beginning and end points of the line.

 

Element	Type	Contents
1	Coord	Beginning point of the line
2	Coord	Ending point of the line

 

Notes

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

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

• 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

cpts = ClickLine()

 

Error Codes

Error Type	Meaning
Escape	The user clicked Cancel
NotFound	A point or points fell outside the defined projection space (off the earth)

 

See Also

Function	Summary
ClickPolyline()	Awaits user input from the system pointer and returns an array of coordinates that define a line