GestureCurrentPointer (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Position of several pointers
Limitations
Various

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

GestureCurrentPointer (Function)

In french: GestePointeurEncours

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

Then, this subscript can be used by GesturePosX and/or GesturePosY to find out 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.

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

// Retrieve the horizontal position of the pointer that triggered
// the call to the "Pressed" event associated to an Image control
PositionX is int
PositionX = GesturePosX(GestureCurrentPointer())

Syntax

<Result> = GestureCurrentPointer()

<Result>: Integer

Subscript the pointer (finger or stylus) that triggered the call of a "Pressed" or "Released" event associated with a Image control. The first pointer in contact with the screen corresponds to the subscript 1.
Note: 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:

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

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.
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 the processes at each finger (multipoints)" 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.
The browser used must support the multi-touch feature.

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

Component : WDJS.DLL