PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Position of several pointers
  • Limitations
  • Various
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Returns the horizontal position of the pointer (finger or stylus). The returned value depends on how the function is used:
  • Used in a process linked to the movement of the pointer (click, move, pressed, released, ...), returns the horizontal position (X) of the pointer (finger or stylus) in relation to the relevant control or window.
  • Used in another process, returns the last known position of the pointer in the control.
  • If the device supports the multi-touch movements, used to retrieve the position of a specific contact point.
Some use examples: You can find out:
  • the position of pointer (finger or stylus) during a click in an image (function used in the click code of image).
  • the position of the pointer (finger or stylus) during its move on the surface of a control (function used in the optional "Rollover" process of a control).
  • the position of the nth pointer during a multi-touch movement on the surface of a control (if it is supported by the device).
Versions 18 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 18
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 19 and later
WEBDEV - Browser code This function is now available in browser code.
New in version 19
WEBDEV - Browser code This function is now available in browser code.
WEBDEV - Browser code This function is now available in browser code.
Example
// Position of the pointer (finger or stylus) during a click in an Image control
PositionX is int = GesturePosX(1, gpControl)
// Position of the second pointer pressed on the surface of a control
PositionX is int = GesturePosX(2, gpControl)
Android
// Position of the pointer in relation to the top left corner of the image displayed by the control
// when this image is not entirely displayed
PositionX is int = GesturePosX(1, gpImage)
// Position of the pointer in relation to the top left corner of the image displayed by the control
// when this image is not entirely displayed
PositionX is int = GesturePosX(1, gpImage)
Syntax
<Result> = GesturePosX([<Pointer Subscript> [, <Marker>]])
<Result>: Integer
  • Horizontal position (or X coordinate) in pixels of the pointer in relation to the relevant marker,
  • -1 if an error occurred.
<Pointer Subscript>: Optional integer
Subscript of the pointer (finger) whose horizontal position must be retrieved. The first pointer in contact with the screen corresponds to the subscript 1.
If this parameter is not specified, the function will return the position of the first pointer in contact with the screen.
If the subscript does not correspond to a pointer in contact with the screen or if the specified subscript is greater than 1 and if the device does not support the multi-touch, the function will return -1.
<Marker>: Optional Integer constant
Marker used to calculate the position:
gpControl
(default value)
Position of the pointer in relation to the top left corner of the control (or window if the event occurred on the window).
gpScreenPosition of the pointer in the screen (in relation to the top left corner of the screen).
gpWindowPosition of the pointer in relation to the top left corner of the window to which belongs the control on which the event occurred.
WEBDEV - Browser code This constant is not available
gpImagePosition of the pointer in relation to the top left corner of the image displayed by an Image control.

This constant can be used when an image is not entirely displayed in an Image control in order to find out the position of the pointer in the source image (while taking the possible zoom into account).

This constant must be used only when GesturePosX is called in a process of an Image control. Otherwise, GesturePosX will return -1.
iPhone/iPad This constant is not available.
Versions 19 and later
gpPage
New in version 19
gpPage
gpPage
Position of the pointer in relation to the top left corner of the page to which belongs the control on which the event occurred.
AndroidiPhone/iPad This constant is not available.
Remarks
Android

Position of several pointers

To manage the position of 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

  • Android 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.
  • Android In the Android simulator or emulator, GesturePosX can only be used to retrieve the position of the first pointer.
  • WEBDEV - Browser code 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 number of pointers in contact with the screen, use GestureNbPointer.
  • To find out the subscript of the pointer that triggered the execution of a process linked to a movement on the screen, use GestureCurrentPointer.
Components
WEBDEV - Browser code WDJS.DLL
Android wd230android.jar
Minimum required version
  • Version 17
This page is also available for…
Comments
Click [Add] to post a comment