ListInfoXY (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Returned subscript

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ListInfoXY (Function)

In french: ListeInfoXY

Returns, for a given position in a List Box control (standard List Box or ListView), the subscript of the row (or image) corresponding to this position.

Notes:

This function cannot be used with a Combo Box control or with a Carousel control.
ListInfoXY can be used on:
- a browsing or memory List Box control,
- a single-selection or multiselection List Box control.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Example

// -- Rollover code of control
// Display a tooltip when the elements in a List Box control are hovered
Subscript is int
Subscript = ListInfoXY(LIST_List1, tiLineNumber, MouseXPos(), MouseYPos())
IF Subscript > 0 THEN
LIST_List1..ToolTip = LIST_List1[Subscript]
END

Syntax

<Result> = ListInfoXY(<List Box control> , <Type of information> , <X> , <Y>)

<Result>: Character string or integer

Requested information.
-1 if there is no row subscript or if the specified position corresponds to an empty row.

<List Box control>: Control name

Name of control to use:
List Box control,
ListView control.
If this parameter corresponds to an empty string (""), ListInfoXY will use the control to which the current event belongs.

<Type of information>: Integer constant

Requested type of information:
tiLineNumber
Row number for a standard List Box control,
Image number for a ListView control..
tiOriginScreen By default, (0,0) corresponds to row 1 (the scrollbars being located at the origin).
If tiOriginScreen is associated with the previous constant, (0,0) corresponds to the origin of the screen.
This constant cannot be used on its own.

<X>: Integer

X coordinate (in pixels) to study. This coordinate is given in relation to the List Box control (if the oriScreenOrigin constant is not specified).

<Y>: Integer

Y coordinate (in pixels) to study. This coordinate is given in relation to the List Box control (if the oriScreenOrigin constant is not specified).

Remarks

Returned subscript

The row subscript returned by ListInfoXY corresponds to the real row subscript (and not to the display subscript). This subscript takes into account the row already displayed but no longer visible in the List Box control.

Furthermore, if the scrollbars are used, ListInfoXY takes this move into account.

Component : wd240obj.dll