ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Mouse functions
  • Error
  • Miscellaneous
  • Limits in browser code
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Returns the horizontal position (X) of the mouse cursor relative to the specified window or control. Used in a mouse or stylus process (click, hover, left or right button down, etc.).
You can get:
  • the position of the mouse (or stylus) when an Image control is clicked (function used in the "Click" event of the Image control).
  • the position of the mouse (or stylus) when hovering over a window (function used in the optional "Mouse hover" event of a window).
WEBDEV - Browser code Returns the horizontal position (X) of the mouse cursor according to the specified marker. Used in a browser event of a control or page.
Remarks:
  • WINDEV The mouse position can also be obtained with CursorPos. CursorPos should only be used to modify the mouse position.
  • Universal Windows 10 AppAndroidJava This function should only be used in the events of controls hovered with the mouse.
  • Universal Windows 10 AppAndroid MouseXPos returns the last known position of the finger on the screen.
Example
WINDEVReports and QueriesJavaUser code (UMC)
// "WIN_Drawing" window hovered by the mouse
// Optional code of the window
Message("Position of the mouse: X: " + MouseXPos() + "Y: " + MouseYPos())
WINDEVReports and QueriesUniversal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac CatalystJavaUser code (UMC)
// Displays a different message according to the location clicked
IF MouseXPos() > 25 THEN
Info("To the right")
ELSE
Info("To the left")
END
WEBDEV - Browser code
// "Drawing" page hovered by the mouse
// Optional code of the page
// Mouse moved (onmousemove)
Message("Position of the mouse: X: " + MouseXPos(mpPage) + "Y: " + MouseYPos(mpPage))
Syntax
WINDEVReports and QueriesUniversal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac CatalystJavaUser code (UMC)

Retrieving the mouse position in a window Hide the details

<Result> = MouseXPos([<Marker>])
<Result>: Integer
  • Horizontal position (X-coordinate) of the mouse or stylus, in pixels. By default, this position is relative to the upper-left corner of the control on which the left mouse button was pressed.
  • -1 if an error occurred.
<Marker>: Optional Integer constant
Marker used to calculate the position:
mpControl
(Default value)
Mouse position relative to the upper-left corner of the hovered control or window, depending on where the event occurs.
mpImageMouse position in the Image control (relative to the upper-left corner).

This constant should only be used when MouseXPos is called in an event associated with an Image control. Otherwise, MouseXPos will return -1.
mpScreenMouse position in the screen (relative to the upper-left corner).
mpWindowMouse position relative to the upper-left corner of the window.

Universal Windows 10 App This parameter is not available.
WEBDEV - Browser code

Retrieving the mouse position in a page Hide the details

<Result> = MouseXPos([<Marker>])
<Result>: Integer or real
  • Horizontal position (X-coordinate) of the mouse cursor relative to the specified marker (in pixels)
  • 0 if the information is not available (depending on the browser used and on the control).
<Marker>: Optional integer constant
Marker used to calculate the position:
mpControl
(Default value)
Mouse position relative to the upper-left corner of the hovered control or page, depending on where the event occurs.
If this constant is selected, MouseXPos must be used in the "OnClick" code of the control.
mpPageMouse position relative to the upper-left corner of the page (taking into account the position of the page if it has been scrolled).
mpScreenMouse position in the screen (relative to the upper-left corner).
Remarks
WINDEVReports and QueriesUniversal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac CatalystJavaUser code (UMC)

Error

The main error codes are as follows:
  • No window is opened.
  • No mouse click is performed.
  • MouseXPos is not called in a mouse event.
  • The click code is executed by Execute or ExecuteProcess.
WINDEVReports and QueriesUniversal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac CatalystJavaUser code (UMC)

Miscellaneous

  • You can get the vertical position of the mouse or stylus with MouseYPos.
  • MouseXPos used in the selection code of row or table always returns 0.
  • Universal Windows 10 AppAndroidJava This function should only be used in WLanguage events of controls hovered with the mouse.
WEBDEV - Browser code

Limits in browser code

MouseXPos is not available:
  • in browser procedures.
  • in the events directly or indirectly called from a browser procedure (via ExecuteProcess for example).
  • in the browser code of a Button or Link control..
Related Examples:
The drawing functions Unit examples (WINDEV): The drawing functions
[ + ] Using the main drawing functions of WINDEV to:
- Initialize an Image control for drawing
- Draw simple shapes
- Write a text into a drawing
- Change the color in a drawing
Component: wd290obj.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help