{{newin|[[0.9.0]]|090|type=function|text=It has been renamed from [[love.mouse.setGrab]]}}
Grabs the mouse and confines it to the window.
== Function ==
=== Synopsis ===
<source lang="lua">
love.mouse.setGrabbed( grab )
</source>
=== Arguments ===
{{param|boolean|grab|True to confine the mouse, false to let it leave the window.}}
=== Returns ===
Nothing.
== Examples ==
Toggles whether the mouse is grabbed by pressing tab, with the help of [[love.mouse.isGrabbed]].
<source lang="lua">
function love.keypressed(key)
   if key == "tab" then
      local state = not love.mouse.isGrabbed()   -- the opposite of whatever it currently is
      love.mouse.setGrabbed(state)
   end
end
</source>
== See Also ==
* [[parent::love.mouse]]
* [[love.mouse.isGrabbed]]
[[Category:Functions]]
{{#set:Description=Grabs the mouse and confines it to the window.}}
== Other Languages ==
{{i18n|love.mouse.setGrabbed}}