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
,