##### Views

- Page
- Discussion
- View source
- History

# love.mouse.isDown

Checks whether a certain mouse button is down. This function does not detect mousewheel scrolling; you must use the love.mousepressed callback for that.

## Function

### Synopsis

down = love.mouse.isDown( button )

### Arguments

`MouseConstant button`
  The button to check.

### Returns

`boolean down`
  True if the specified button is down.

## Function

Available since LÖVE 0.7.2
This variant is not supported in earlier versions.

### Synopsis

anyDown = love.mouse.isDown( button1, button2, button3, ... )

### Arguments

`MouseConstant buttonN`
  A button to check.

### Returns

`boolean anyDown`
  True if any specified button is down, false otherwise.

## Example

### Increase a value while the right mouse button is held

val = 0 -- establish a variable for later use
function love.update(dt)
if love.mouse.isDown("r") then
val = val + dt -- we will increase the variable by 1 for every second the button is held down
end
end

## See Also

- Mouse Constant / buttons
- love.mouse
- love.mousepressed
- love.mousereleased
- love.keyboard.isDown

## Other Languages

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info

Retrieved from "https://www.love2d.org/wiki/love.mouse.isDown"
Categories: Templates | Functions

##### Personal tools

- Log in

##### Search

##### Toolbox

- What links here
- Related changes
- Special pages
- Printable version
- Permanent link
- Browse properties