# Class MouseInfo

java.lang.Object
java.awt.MouseInfo

public class MouseInfo extends Object
`MouseInfo` provides methods for getting information about the mouse, such as mouse pointer location and the number of mouse buttons.

Since:
  1.5

## Method Summary

Modifier and Type
Method
Description
`static int`
`getNumberOfButtons()`
Returns the number of buttons on the mouse.
`static PointerInfo`
`getPointerInfo()`
Returns a `PointerInfo` instance that represents the current location of the mouse pointer.

### Methods declared in class Object

`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

## Method Details

### getPointerInfo

public static PointerInfo getPointerInfo() throws HeadlessException
Returns a `PointerInfo` instance that represents the current location of the mouse pointer. The `GraphicsDevice` stored in this `PointerInfo` contains the mouse pointer. The coordinate system used for the mouse position depends on whether or not the `GraphicsDevice` is part of a virtual screen device. For virtual screen devices, the coordinates are given in the virtual coordinate system, otherwise they are returned in the coordinate system of the `GraphicsDevice`. See `GraphicsConfiguration` for more information about the virtual screen devices. On systems without a mouse, returns `null`.

Returns:
  location of the mouse pointer
Throws:
  `HeadlessException` - if GraphicsEnvironment.isHeadless() returns true
Since:
  1.5

### getNumberOfButtons

public static int getNumberOfButtons() throws HeadlessException
Returns the number of buttons on the mouse. On systems without a mouse, returns `-1`. The number of buttons is obtained from the AWT Toolkit by requesting the `"awt.mouse.numButtons"` desktop property which is set by the underlying native platform.

Returns:
  number of buttons on the mouse
Throws:
  `HeadlessException` - if GraphicsEnvironment.isHeadless() returns true
Since:
  1.5
See Also:
  - `Toolkit.getDesktopProperty(String)`