addPoint

addPoint(
l_point
) 
=> t / nil 

Description

Adds the point to the enterfunction in the current window.

addPoint is often used in conjunction with hiGetCommandPoint to add the point where you last clicked to an enterfunction.

Argument

l_point

Point in user units to add to the current enterfunction.

Values Returned

t	The point is added.
nil	The point is not added.

Examples

Displays the prompt Enter a point is displayed on the CIW prompt line:

procedure( pointDone( w done pts )
   if( done then
      printf("Point entered was %L.\n" car(pts))
   else
      println("Point entry aborted.")
   )
)
enterPoint( ?prompts
   list( "Enter a point.")
   ?doneProc "pointDone"
)

Adds the point at 2:6 location:

addPoint(2:6)

The enterfunction terminates and doneProc prints the specified message:

Point entered was (2.000 6.000).

The enterfunction returns the point list:

(2.000 6.000)

Related Topics

User Entry Functions

hiGetCurrentCmd

hiGetCommandPoint

Return to top