SDL Wiki
(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_WarpMouseInWindow

Move the mouse cursor to the given position within the window.

Header File

Defined in <SDL3/SDL_mouse.h>

Syntax

void SDL_WarpMouseInWindow(SDL_Window * window,
                       float x, float y);

Function Parameters

SDL_Window * window the window to move the mouse into, or NULL for the current mouse focus.
float x the x coordinate within the window.
float y the y coordinate within the window.

Remarks

This function generates a mouse motion event if relative mode is not enabled. If relative mode is enabled, you can force mouse events for the warp by setting the SDL_HINT_MOUSE_RELATIVE_WARP_MOTION hint.

Note that this function will appear to succeed, but not actually move the mouse when used over Microsoft Remote Desktop.

Version

This function is available since SDL 3.1.3.

See Also


CategoryAPI, CategoryAPIFunction, CategoryMouse


[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.