< prev index next >

src/java.desktop/share/classes/java/awt/MouseInfo.java

Print this page




  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package java.awt;
  27 
  28 import sun.awt.AWTPermissions;
  29 import sun.awt.ComponentFactory;
  30 
  31 /**
  32  * <code>MouseInfo</code>  provides methods for getting information about the mouse,
  33  * such as mouse pointer location and the number of mouse buttons.
  34  *
  35  * @author     Roman Poborchiy
  36  * @since 1.5
  37  */
  38 
  39 public class MouseInfo {
  40 
  41     /**
  42      * Private constructor to prevent instantiation.
  43      */
  44     private MouseInfo() {
  45     }
  46 
  47     /**
  48      * Returns a <code>PointerInfo</code> instance that represents the current
  49      * location of the mouse pointer.
  50      * The <code>GraphicsDevice</code> stored in this <code>PointerInfo</code>
  51      * contains the mouse pointer. The coordinate system used for the mouse position
  52      * depends on whether or not the <code>GraphicsDevice</code> is part of a virtual
  53      * screen device.
  54      * For virtual screen devices, the coordinates are given in the virtual
  55      * coordinate system, otherwise they are returned in the coordinate system
  56      * of the <code>GraphicsDevice</code>. See {@link GraphicsConfiguration}
  57      * for more information about the virtual screen devices.
  58      * On systems without a mouse, returns <code>null</code>.
  59      * <p>
  60      * If there is a security manager, its <code>checkPermission</code> method
  61      * is called with an <code>AWTPermission("watchMousePointer")</code>
  62      * permission before creating and returning a <code>PointerInfo</code>
  63      * object. This may result in a <code>SecurityException</code>.
  64      *
  65      * @exception HeadlessException if GraphicsEnvironment.isHeadless() returns true
  66      * @exception SecurityException if a security manager exists and its
  67      *            <code>checkPermission</code> method doesn't allow the operation
  68      * @see       GraphicsConfiguration
  69      * @see       SecurityManager#checkPermission
  70      * @see       java.awt.AWTPermission
  71      * @return    location of the mouse pointer
  72      * @since     1.5
  73      */
  74     public static PointerInfo getPointerInfo() throws HeadlessException {
  75         if (GraphicsEnvironment.isHeadless()) {
  76             throw new HeadlessException();
  77         }
  78 
  79         SecurityManager security = System.getSecurityManager();
  80         if (security != null) {
  81             security.checkPermission(AWTPermissions.WATCH_MOUSE_PERMISSION);
  82         }
  83 
  84         Toolkit toolkit = Toolkit.getDefaultToolkit();
  85         Point point = new Point(0, 0);
  86         int deviceNum = 0;
  87         if (toolkit instanceof ComponentFactory) {


 101                     retval = new PointerInfo(gds[i], point);
 102                 }
 103             }
 104         }
 105 
 106         return retval;
 107     }
 108 
 109     private static boolean areScreenDevicesIndependent(GraphicsDevice[] gds) {
 110         for (int i = 0; i < gds.length; i++) {
 111             Rectangle bounds = gds[i].getDefaultConfiguration().getBounds();
 112             if (bounds.x != 0 || bounds.y != 0) {
 113                 return false;
 114             }
 115         }
 116         return true;
 117     }
 118 
 119     /**
 120      * Returns the number of buttons on the mouse.
 121      * On systems without a mouse, returns <code>-1</code>.
 122      * The number of buttons is obtained from the AWT Toolkit
 123      * by requesting the {@code "awt.mouse.numButtons"} desktop property
 124      * which is set by the underlying native platform.
 125      *
 126      * @exception HeadlessException if GraphicsEnvironment.isHeadless() returns true
 127      * @return number of buttons on the mouse
 128      * @see Toolkit#getDesktopProperty
 129      * @since 1.5
 130      */
 131     public static int getNumberOfButtons() throws HeadlessException {
 132         if (GraphicsEnvironment.isHeadless()) {
 133             throw new HeadlessException();
 134         }
 135         Object prop = Toolkit.getDefaultToolkit().
 136                               getDesktopProperty("awt.mouse.numButtons");
 137         if (prop instanceof Integer) {
 138             return ((Integer)prop).intValue();
 139         }
 140 
 141         // This should never happen.


  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package java.awt;
  27 
  28 import sun.awt.AWTPermissions;
  29 import sun.awt.ComponentFactory;
  30 
  31 /**
  32  * {@code MouseInfo}  provides methods for getting information about the mouse,
  33  * such as mouse pointer location and the number of mouse buttons.
  34  *
  35  * @author     Roman Poborchiy
  36  * @since 1.5
  37  */
  38 
  39 public class MouseInfo {
  40 
  41     /**
  42      * Private constructor to prevent instantiation.
  43      */
  44     private MouseInfo() {
  45     }
  46 
  47     /**
  48      * Returns a {@code PointerInfo} instance that represents the current
  49      * location of the mouse pointer.
  50      * The {@code GraphicsDevice} stored in this {@code PointerInfo}
  51      * contains the mouse pointer. The coordinate system used for the mouse position
  52      * depends on whether or not the {@code GraphicsDevice} is part of a virtual
  53      * screen device.
  54      * For virtual screen devices, the coordinates are given in the virtual
  55      * coordinate system, otherwise they are returned in the coordinate system
  56      * of the {@code GraphicsDevice}. See {@link GraphicsConfiguration}
  57      * for more information about the virtual screen devices.
  58      * On systems without a mouse, returns {@code null}.
  59      * <p>
  60      * If there is a security manager, its {@code checkPermission} method
  61      * is called with an {@code AWTPermission("watchMousePointer")}
  62      * permission before creating and returning a {@code PointerInfo}
  63      * object. This may result in a {@code SecurityException}.
  64      *
  65      * @exception HeadlessException if GraphicsEnvironment.isHeadless() returns true
  66      * @exception SecurityException if a security manager exists and its
  67      *            {@code checkPermission} method doesn't allow the operation
  68      * @see       GraphicsConfiguration
  69      * @see       SecurityManager#checkPermission
  70      * @see       java.awt.AWTPermission
  71      * @return    location of the mouse pointer
  72      * @since     1.5
  73      */
  74     public static PointerInfo getPointerInfo() throws HeadlessException {
  75         if (GraphicsEnvironment.isHeadless()) {
  76             throw new HeadlessException();
  77         }
  78 
  79         SecurityManager security = System.getSecurityManager();
  80         if (security != null) {
  81             security.checkPermission(AWTPermissions.WATCH_MOUSE_PERMISSION);
  82         }
  83 
  84         Toolkit toolkit = Toolkit.getDefaultToolkit();
  85         Point point = new Point(0, 0);
  86         int deviceNum = 0;
  87         if (toolkit instanceof ComponentFactory) {


 101                     retval = new PointerInfo(gds[i], point);
 102                 }
 103             }
 104         }
 105 
 106         return retval;
 107     }
 108 
 109     private static boolean areScreenDevicesIndependent(GraphicsDevice[] gds) {
 110         for (int i = 0; i < gds.length; i++) {
 111             Rectangle bounds = gds[i].getDefaultConfiguration().getBounds();
 112             if (bounds.x != 0 || bounds.y != 0) {
 113                 return false;
 114             }
 115         }
 116         return true;
 117     }
 118 
 119     /**
 120      * Returns the number of buttons on the mouse.
 121      * On systems without a mouse, returns {@code -1}.
 122      * The number of buttons is obtained from the AWT Toolkit
 123      * by requesting the {@code "awt.mouse.numButtons"} desktop property
 124      * which is set by the underlying native platform.
 125      *
 126      * @exception HeadlessException if GraphicsEnvironment.isHeadless() returns true
 127      * @return number of buttons on the mouse
 128      * @see Toolkit#getDesktopProperty
 129      * @since 1.5
 130      */
 131     public static int getNumberOfButtons() throws HeadlessException {
 132         if (GraphicsEnvironment.isHeadless()) {
 133             throw new HeadlessException();
 134         }
 135         Object prop = Toolkit.getDefaultToolkit().
 136                               getDesktopProperty("awt.mouse.numButtons");
 137         if (prop instanceof Integer) {
 138             return ((Integer)prop).intValue();
 139         }
 140 
 141         // This should never happen.
< prev index next >