Version 6.3.13 for Windows
 —  Dialog Component Reference  —

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).

Top of page

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 

Top of page