INQ-ITEM-BY-POSITION Action

#### Search Results

Search

# INQ-ITEM-BY-POSITION Action

This document covers the following topics:

- Description

- Parameters

## Description

Returns the item at a given position within a control. This is particularly useful for finding out which List Box Item or Status Bar Pane was clicked with the right mouse button before a context menu is displayed (see example below).

## Parameters

Name/Data Type | Explanation
--- | ---
HANDLE OF GUI | Input Specifies a list box or status bar control.
X-Position (I4) | Input Specifies the x-axis position in pixels relative to the top-left hand corner of the control.
Y-Position (I4) | Input Specifies the y-axis position in pixels relative to the top-left hand corner of the control.
Item (HANDLE OF GUI) | Output The handle of the List Box Item or Status Bar Pane at the specified position, or NULL-HANDLE if none.
Response (I4) | Output NATURAL error (if applicable).

#### Example:

      /* Sample BEFORE-OPEN code for context menu:
      PROCESS GUI ACTION INQ-CLICKPOSITION WITH
      #LB-1 #X-POSITION #Y-POSITION GIVING #RESPONSE
      PROCESS GUI ACTION INQ-ITEM-BY-POSITION WITH
      #LB-1 #X-POSITION #Y-POSITION #LBITEM GIVING #RESPONSE

### On this page

- Description
- Parameters