ListInfoXY (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Returned index

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ListInfoXY (Function)

In french: ListeInfoXY

Returns the index of the row (or image) at a given position in a List Box or ListView control.

Remarks:

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 multi-selection 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
Index is int
Index = ListInfoXY(LIST_List1, tiLineNumber, MouseXPos(), MouseYPos())
IF Index > 0 THEN
LIST_List1..Tooltip = LIST_List1[Index]
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 index or if the specified position corresponds to an empty row.

<List Box control>: Control name

Name of the control to be used:
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 index

The index returned by ListInfoXY corresponds to the real index of the row (not the index displayed). This index 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: wd270obj.dll