install_get_xy()

Installs a user-defined event handler for prompting in the current window. Returns: none.

Syntax:

install_get_xy (aelFuncName[, autoRepeatable, prmStr]);

where

aelFuncName is a string. AEL function to call when (x,y) location is entered by clicking the left mouse button. The (x,y) coordinate of the pointer location is passed in to the AEL function.

autoRepeatable is optional; sets repeat capability, where:

• 0 = one-shot (default). The routine is not re-installed after the (x,y) location is entered.
• 1 = auto-repeatable. The event handler will be invoked every time the mouse is clicked until either the End Command button is pressed or another command is invoked.

prmStr is optional; the parameter to override the default event prompt.

Example:

The Example: prints out point each time mouse is clicked.

defun my_print_xy(x,y)
{
    fputs(stderr, fmt_tokens(list (x,y)));
}
install_get_xy("my_print_xy", 1, "enter the (x,y) location");

Where Used:

Graphical user interface