INQ-CLICKPOSITION Action

This document covers the following topics:


Description

Returns the x-axis and the y-axis position where the end user has clicked (relative to the dialog element's rectangle). These coordinates are also updated immediately before a context-menu's before-open event is called. The application can then combine this call with a call to either INQ-ITEM-BY-POSITION or TABLE-INQUIRE-CELL to determine which list box item or Table Control cell was right-clicked.

Parameters

Name/Data Type Explanation
HANDLE OF GUI Input

Specifies a dialog element.

X-Position (I4) Output (optional parameter)

The x-axis position in pixels.

Y-Position (I4) Output (optional parameter)

The y-axis position in pixels.

Valid (L) Output (optional parameter)

The click position is valid. If this parameter is set to FALSE, there is no click position (e.g., when a context menu is accessed via the keyboard), and the coordinate (0, 0) is returned (if requested).

Response (I4) Output

Natural error (if applicable).

Example:

 
   PROCESS GUI ACTION INQ-CLICKPOSITION WITH #BM-1 #X-POSITION #Y-POSITION 
   GIVING #RESPONSE 
   #IF-1.STRING := #X-POSITION  /* Display the coordinates in these two 
   #IF-2.STRING := #Y-POSITION  /* Input Field Controls