INQ-CLICKPOSITION Action

#### Search Results

Search

# INQ-CLICKPOSITION Action

This document covers the following topics:

- Description

- Parameters

## 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

### On this page

- Description
- Parameters