GestureCurrentPointer (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Specific Mobile functions

Multi-touch functions

GestureCurrentPointer

Presentation

Example

Position of several pointers

Limitations

Miscellaneous

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

// 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

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

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