Por favor, lembre-se que esta tradução da especificação é resultado de um projeto da comunidade java.net( https://jdk5-api-pt-br.dev.java.net/). A versão oficial da especificação é a versão na língua inglesa que pode ser encontrada em http://java.sun.com/j2se/1.5.0/docs/api/. Em caso de divergências, a versão predominante da especificação é a original em inglês.

Please note that this translation of the specification is the result of a java.net community project ( https://jdk5-api-pt-br.dev.java.net/ ). The official version of the specification is the US English language version which can be found at http://java.sun.com/j2se/1.5.0/docs/api/. In case of disputes, the authoritative version of the specification is the original, English document.

java.awt
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

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 inherited from class java.lang.Object

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

Method Detail

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.

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

Since:

1.5

See Also:

GraphicsConfiguration, SecurityManager.checkPermission(java.security.Permission), AWTPermission

getNumberOfButtons

public static int getNumberOfButtons()
                              throws HeadlessException

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

Since:

1.5