public class

MouseInfo

extends Object
java.lang.Object
   ↳ java.awt.MouseInfo

Class Overview

MouseInfo provides methods for getting information about the mouse, such as mouse pointer location and the number of mouse buttons.

Summary

Public Methods
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.
[Expand]
Inherited Methods
From class java.lang.Object

Public Methods

public static int getNumberOfButtons ()

Returns the number of buttons on the mouse. On systems without a mouse, returns -1.

Returns
  • number of buttons on the mouse
Throws
HeadlessException if GraphicsEnvironment.isHeadless() returns true

public static PointerInfo getPointerInfo ()

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.

If there is a security manager, its checkPermission method is called with an AWTPermission("watchMousePointer") permission before creating and returning a PointerInfo object. This may result in a SecurityException.

Returns
  • location of the mouse pointer
Throws
HeadlessException if GraphicsEnvironment.isHeadless() returns true
SecurityException if a security manager exists and its checkPermission method doesn't allow the operation