1
1
Fork 0
mirror of https://github.com/QB64Official/qb64.git synced 2024-07-01 09:10:37 +00:00
qb64/internal/help/_MOUSEMOVEMENTY.txt
2021-01-12 20:28:26 -03:00

43 lines
1.6 KiB
Plaintext

{{DISPLAYTITLE:_MOUSEMOVEMENTY}}
The [[_MOUSEMOVEMENTY]] function returns the relative vertical position of the mouse cursor as positive or negative values.
{{PageSyntax}}
: {{Parameter|verticalMove}} = [[_MOUSEMOVEMENTY]]
* Returns the relative vertical cursor pixel position compared to the previous cursor position. Negative values are up moves.
* Can also be used to check for any mouse movements to enable a program or close [[Screen Saver Programs]].
* On Windows only, [[_MOUSEMOVEMENTY]] will continue to track the mouse when it is outside the program window.
''Example:'' MOD is used to keep vertical movement of circle and cursor inside of the SCREEN 13 window(200).
{{CodeStart}} '' ''
{{Cl|SCREEN}} 13, , 1, 0
{{Cl|DO...LOOP|DO}}: {{Cl|_LIMIT}} 200
{{Cl|DO...LOOP|DO}} {{Cl|WHILE}} {{Cl|_MOUSEINPUT}}
x = x + {{Cl|_MOUSEMOVEMENTX}}
y = y + {{Cl|_MOUSEMOVEMENTY}}
{{Cl|LOOP}}
x = (x + 320) {{Cl|MOD}} 320 'keeps object on screen
y = (y + 200) {{Cl|MOD}} 200 'remove if off screen moves are desired
{{Cl|CLS}}
{{Cl|CIRCLE}} (x, y), 20
{{Cl|PCOPY}} 1, 0
{{Cl|LOOP}} {{Cl|UNTIL}} {{Cl|INKEY$}} <> "" 'press any key to exit '' ''
{{CodeEnd}}
: '''NOTE:''' When using the function this way, give the user a keypress exit option. Make sure the user has some way to exit that is not dependent on clicking the X button.
{{PageSeeAlso}}
* [[_MOUSEMOVEMENTX]]
* [[_MOUSEINPUT]], [[_MOUSEX]]
* [[_DEVICES]], [[_DEVICEINPUT]]
* [[_WHEEL]], [[_LASTWHEEL]]
* [[_AXIS]], [[_LASTAXIS]]
* [[_MOUSESHOW]], [[_MOUSEHIDE]]
* [[Screen Saver Programs]]
{{PageNavigation}}