GestureCurrentPointer (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Position of several pointers
Limitations
Various

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

GestureCurrentPointer (Function)

In french: GestePointeurEncours

Returns the pointer index (finger or stylus) that triggered the call of a specific multi-touch event in an Image control.

This index can be used by GesturePosX and/or GesturePosY to get the vertical and/or horizontal position of the corresponding pointer.

Versions 18 and later

This function is now available for iPhone/iPad applications.

New in version 18

This function is now available for iPhone/iPad applications.

Example

// Récupère la position horizontale du pointeur ayant provoqué
// l'appel de l'événement "Enfoncé" associé à un champ Image
PositionX is int
PositionX = GesturePosX(GestureCurrentPointer())

Syntax

<Result> = GestureCurrentPointer()

<Result>: Integer

Pointer index (finger or stylus) that triggered the call of a "Pressed" or "Released" event associated with an Image control. The first pointer that touches the screen corresponds to index 1.
Remark: In the Android simulator or emulator, this number is always equal to 1.

Remarks

Position of several pointers

To manage several pointers on the screen, the device must be equipped with a multi-touch display..

Limitations

This function is only available on devices with Android version 2.2 or higher (API level 8).
A fatal error occurs if the function is used with an earlier system version.
To determine the version of Android the application is running on, use SysAndroidVersion.

Use condition:
- This function must be called in the events of an Image control that triggered the call to the events for each pointer: option "Recall processes for each pointer (multiple pointers)" in the "Details" tab of the control description.
- This function must be called in one of the following events of the control: "Pressed", "Released", "Scroll with finger", "Horizontal and vertical swipe" or "Zoom with finger". Otherwise, the function will always return 1.
Up to 2 pointers can be supported.

Various

To find out the horizontal position (X) of a pointer, use GesturePosX.
To find out the vertical position (Y) of a pointer, use GesturePosY.
To find out the number of pointers in Contact with the screen, use function GestureNbPointer.

Component: WDJS.DLL