GestureNbPointer (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Managing several pointers
Limitations
Various

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

GestureNbPointer (Function)

In french: GesteNbPointeur

Returns the number of pointers in contact with the screen.

The returned value depends on how the function is used:

Used in an event linked to the movement of the pointer (click, move, pressed, released, etc.), returns the number of pointers (finger or stylus) currently in contact with the screen
Used in another event or process, returns the last known number of contact points.

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.

Versions 19 and later

This function is now available in browser code.

New in version 19

This function is now available in browser code.

Example

// -- Click code on an Image control
nbContactPoints is int
nbContactPoints = GestureNbPointer()

ToastDisplay("You are currently using " + nbContactPoints + " finger(s) on the screen")

Syntax

<Result> = GestureNbPointer()

<Result>: Integer

Number of pointers (fingers or styluses) in contact with the screen.
Note: In the Android simulator or emulator, this number is always equal to 1.

Remarks

Managing several pointers

To manage several pointers on the screen, the device must:

include a multi-touch feature,
operate with version 2.2 (or later) of the Android system.

Caution: On some devices, GestureNbPointer can return a values less than the number of pointers actually in contact with the screen. Indeed, the number of simultaneous contact points supported by the system is limited (this limit changes according to the device).

Limitations

This function is available on the devices running Android version 2.2 or later (api level 8).
A fatal error occurs if the function is used with an earlier system version.
To find out the version of Android system on which the application is run, use SysAndroidVersion.
Up to 2 pointers can be supported.
The browser used must support the multi-touch feature.

Various

To find out the vertical position (Y) of a pointer, use GesturePosY.
To find out the horizontal position (X) of a pointer, use GesturePosX.
To find out the subscript of the pointer that triggered the execution of an event linked to a movement on the screen, use GestureCurrentPointer.

Component : WDJS.DLL