INQ-ITEM-BY-POSITION Action

This document covers the following topics:

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