java.lang.Object
java.awt.MouseInfo
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 TypeMethodDescriptionstatic intReturns the number of buttons on the mouse.static PointerInfoReturns aPointerInfoinstance that represents the current location of the mouse pointer.
-
Method Details
-
getPointerInfo
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:
-
getNumberOfButtons
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:
-