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.

Help / WLanguage / WLanguage functions / Mobile specific functions / Multi-Touch functions

Position of several pointers
Limitations
Miscellaneous

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.

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.
Note: In the simulator or Android 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

Use condition:
- This function must be used in the events of an Image control that has enabled event calling for each pointer: option "Recall processes for each pointer (multiple pointers)" in the "Detail" tab of the control description.
- This function must be called in one of the following field events: "Press", "Release", "Finger scroll", "Horizontal and vertical scan" or "Finger zoom". Otherwise, the function will always return 1.
Up to 2 pointers can be supported.
The browser used must support the multi-touch feature.

Miscellaneous

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

Component: WDJS.DLL