#pragma section-numbers off
#pragma camelcase off

= SDL_SetWindowGrab =
Use this function to set a window's input grab mode.

<<TableOfContents()>>

== Syntax ==
{{{#!highlight cpp
void SDL_SetWindowGrab(SDL_Window* window,
                       SDL_bool    grabbed)
}}}

== Function Parameters ==
||'''window'''||the window for which the input grab mode should be set||
||'''grabbed'''||SDL_TRUE to grab input or SDL_FALSE to release input||

== Code Examples ==
{{{#!highlight cpp
You can add your code example here
}}}

== Remarks ==
When input is grabbed the mouse is confined to the window.

If the caller enables a grab while another window is currently grabbed, the other window loses its grab in favor of the caller's window.

== Related Functions ==
 .[[SDL_GetGrabbedWindow]]
 .[[SDL_GetWindowGrab]]

----
[[CategoryAPI]], [[CategoryVideo]]