0N/A/*
2362N/A * Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
2362N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
2362N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A * or visit www.oracle.com if you need additional information or have any
2362N/A * questions.
0N/A */
0N/A
0N/Apackage java.awt;
0N/A
0N/Aimport sun.security.util.SecurityConstants;
0N/A/**
0N/A * <code>MouseInfo</code> provides methods for getting information about the mouse,
0N/A * such as mouse pointer location and the number of mouse buttons.
0N/A *
0N/A * @author Roman Poborchiy
0N/A * @since 1.5
0N/A */
0N/A
0N/Apublic class MouseInfo {
0N/A
0N/A /**
0N/A * Private constructor to prevent instantiation.
0N/A */
0N/A private MouseInfo() {
0N/A }
0N/A
0N/A /**
0N/A * Returns a <code>PointerInfo</code> instance that represents the current
0N/A * location of the mouse pointer.
0N/A * The <code>GraphicsDevice</code> stored in this <code>PointerInfo</code>
0N/A * contains the mouse pointer. The coordinate system used for the mouse position
0N/A * depends on whether or not the <code>GraphicsDevice</code> is part of a virtual
0N/A * screen device.
0N/A * For virtual screen devices, the coordinates are given in the virtual
0N/A * coordinate system, otherwise they are returned in the coordinate system
0N/A * of the <code>GraphicsDevice</code>. See {@link GraphicsConfiguration}
0N/A * for more information about the virtual screen devices.
0N/A * On systems without a mouse, returns <code>null</code>.
0N/A * <p>
0N/A * If there is a security manager, its <code>checkPermission</code> method
0N/A * is called with an <code>AWTPermission("watchMousePointer")</code>
0N/A * permission before creating and returning a <code>PointerInfo</code>
0N/A * object. This may result in a <code>SecurityException</code>.
0N/A *
0N/A * @exception HeadlessException if GraphicsEnvironment.isHeadless() returns true
0N/A * @exception SecurityException if a security manager exists and its
0N/A * <code>checkPermission</code> method doesn't allow the operation
0N/A * @see GraphicsConfiguration
0N/A * @see SecurityManager#checkPermission
0N/A * @see java.awt.AWTPermission
0N/A * @return location of the mouse pointer
0N/A * @since 1.5
0N/A */
0N/A public static PointerInfo getPointerInfo() throws HeadlessException {
0N/A if (GraphicsEnvironment.isHeadless()) {
0N/A throw new HeadlessException();
0N/A }
0N/A
0N/A SecurityManager security = System.getSecurityManager();
0N/A if (security != null) {
1714N/A security.checkPermission(SecurityConstants.AWT.WATCH_MOUSE_PERMISSION);
0N/A }
0N/A
0N/A Point point = new Point(0, 0);
0N/A int deviceNum = Toolkit.getDefaultToolkit().getMouseInfoPeer().fillPointWithCoords(point);
0N/A GraphicsDevice[] gds = GraphicsEnvironment.getLocalGraphicsEnvironment().
0N/A getScreenDevices();
0N/A PointerInfo retval = null;
0N/A if (areScreenDevicesIndependent(gds)) {
0N/A retval = new PointerInfo(gds[deviceNum], point);
0N/A } else {
0N/A for (int i = 0; i < gds.length; i++) {
0N/A GraphicsConfiguration gc = gds[i].getDefaultConfiguration();
0N/A Rectangle bounds = gc.getBounds();
0N/A if (bounds.contains(point)) {
0N/A retval = new PointerInfo(gds[i], point);
0N/A }
0N/A }
0N/A }
0N/A
0N/A return retval;
0N/A }
0N/A
0N/A private static boolean areScreenDevicesIndependent(GraphicsDevice[] gds) {
0N/A for (int i = 0; i < gds.length; i++) {
0N/A Rectangle bounds = gds[i].getDefaultConfiguration().getBounds();
0N/A if (bounds.x != 0 || bounds.y != 0) {
0N/A return false;
0N/A }
0N/A }
0N/A return true;
0N/A }
0N/A
0N/A /**
0N/A * Returns the number of buttons on the mouse.
0N/A * On systems without a mouse, returns <code>-1</code>.
0N/A *
0N/A * @exception HeadlessException if GraphicsEnvironment.isHeadless() returns true
0N/A * @return number of buttons on the mouse
0N/A * @since 1.5
0N/A */
0N/A public static int getNumberOfButtons() throws HeadlessException {
0N/A if (GraphicsEnvironment.isHeadless()) {
0N/A throw new HeadlessException();
0N/A }
0N/A Object prop = Toolkit.getDefaultToolkit().
0N/A getDesktopProperty("awt.mouse.numButtons");
0N/A if (prop instanceof Integer) {
0N/A return ((Integer)prop).intValue();
0N/A }
0N/A
0N/A // This should never happen.
0N/A assert false : "awt.mouse.numButtons is not an integer property";
0N/A return 0;
0N/A }
0N/A
0N/A}