GestureNbPointer (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

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) that touch the screen.
Remark: 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 be equipped with a multi-touch display.

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 only available on devices with Android 2.2 or later (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.

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 get the pointer index that triggered the execution of an event linked to a movement on the screen, use GestureCurrentPointer.

Component: WDJS.DLL