- java.lang.Object
-
- java.awt.MouseInfo
-
public class MouseInfo extends Object
MouseInfoprovides methods for getting information about the mouse, such as mouse pointer location and the number of mouse buttons.- Since:
- 1.5
-
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static intgetNumberOfButtons()Returns the number of buttons on the mouse.static PointerInfogetPointerInfo()Returns aPointerInfoinstance that represents the current location of the mouse pointer.
-
-
-
Method Detail
-
getPointerInfo
public static PointerInfo getPointerInfo() throws HeadlessException
Returns aPointerInfoinstance that represents the current location of the mouse pointer. TheGraphicsDevicestored in thisPointerInfocontains the mouse pointer. The coordinate system used for the mouse position depends on whether or not theGraphicsDeviceis 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 theGraphicsDevice. SeeGraphicsConfigurationfor more information about the virtual screen devices. On systems without a mouse, returnsnull.If there is a security manager, its
checkPermissionmethod is called with anAWTPermission("watchMousePointer")permission before creating and returning aPointerInfoobject. This may result in aSecurityException.- Returns:
- location of the mouse pointer
- Throws:
HeadlessException- if GraphicsEnvironment.isHeadless() returns trueSecurityException- if a security manager exists and itscheckPermissionmethod doesn't allow the operation- Since:
- 1.5
- See Also:
GraphicsConfiguration,SecurityManager.checkPermission(java.security.Permission),AWTPermission
-
getNumberOfButtons
public static int getNumberOfButtons() throws HeadlessExceptionReturns 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(java.lang.String)
-
-