Please enable JavaScript to view this site.

ESL Documentation

Response Inquiry Built-in Functions

Return the coordinates of the pointer's position when the object was selected.

{xcoord|ycoord}

Description

Use the xcoord and ycoord functions only within a response to OBJECT response definition. If you specify these functions within any response other than a response to OBJECT, ESL will return zero as the value of the function.

When used with the dragover, drop, and drophelp on clauses, xcoord and ycoord return the position of the pointer over the object, in the coordinate system of that object.

Graphical Objects, Image, Sense, or Dialog Regions

Function

Value Returned

xcoord

The X coordinate of the point selected, in the coordinate system of the object for which a response is taken.

ycoord

The Y coordinate of the point selected, in the coordinate system of the object for which a response is taken.

Textual Regions

Function

Value Returned

xcoord

The column number of the character selected.

ycoord

The line number of the character selected.

List Box, Combination Box, and Drop-down List Box (drag responses only)

Function

Value Returned

xcoord

0.

ycoord

The number of the line affected by the drag operation. If the drag operation occured over the entry field part of a combination box, drop-down combination box, or drop-down list, ycoord will be 0.

Multiple-line Entry Field (drag responses only)

Function

Value Returned

xcoord

0.

ycoord

The number of the line affected by the drag operation.

Table (drag responses only)

Function

Value Returned

xcoord

The number of the column affected by the drag operation.

ycoord

The number of the row affected by the drag operation.

Table Objects

When used with tables, xcoord and ycoord return the values of the current column (xcoord) and row (ycoord), thereby indicating the position of the cursor. The response triggered depends on the values returned, as shown in the following table:

If xcoord is

And ycoord is

The cursor is:

Greater than 0

Greater than 0

In a cell. Normal response is taken (response to cell event, mouse click, etc.).

0

Greater than 0

In a row header.

Greater than 0

0

In a column header

0

0

Outside the table; for example, in the upper left-hand corner between headers, in the lower right-hand corner between the scroll bars, below the last row.

Example

 

response to Blue_Key

 move to xcoord ycoord

 ...