/* * Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation.  Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package java.awt; import java.awt.Point;import java.awt.Toolkit;import java.awt.GraphicsEnvironment;import java.awt.event.*;import java.awt.AWTEvent;import java.awt.AWTEventMulticaster;import java.awt.EventQueue;import java.awt.PopupMenu;import java.awt.Image;import java.util.EventListener;import java.awt.peer.TrayIconPeer;import sun.awt.AppContext;import sun.awt.SunToolkit;import sun.awt.HeadlessToolkit;import java.util.EventObject;import java.security.AccessControlContext;import java.security.AccessController; /** * A <code>TrayIcon</code> object represents a tray icon that can be * added to the {@link SystemTray system tray}. A * <code>TrayIcon</code> can have a tooltip (text), an image, a popup * menu, and a set of listeners associated with it. * * <p>A <code>TrayIcon</code> can generate various {@link MouseEvent * MouseEvents} and supports adding corresponding listeners to receive * notification of these events.  <code>TrayIcon</code> processes some * of the events by itself.  For example, by default, when the * right-mouse click is performed on the <code>TrayIcon</code> it * displays the specified popup menu.  When the mouse hovers * over the <code>TrayIcon</code> the tooltip is displayed. * * <p><strong>Note:</strong> When the <code>MouseEvent</code> is * dispatched to its registered listeners its <code>component</code> * property will be set to <code>null</code>.  (See {@link * java.awt.event.ComponentEvent#getComponent}) The * <code>source</code> property will be set to this * <code>TrayIcon</code>. (See {@link * java.util.EventObject#getSource}) * * <p><b>Note:</b> A well-behaved {@link TrayIcon} implementation * will assign different gestures to showing a popup menu and * selecting a tray icon. * * <p>A <code>TrayIcon</code> can generate an {@link ActionEvent * ActionEvent}.  On some platforms, this occurs when the user selects * the tray icon using either the mouse or keyboard. * * <p>If a SecurityManager is installed, the AWTPermission * {@code accessSystemTray} must be granted in order to create * a {@code TrayIcon}. Otherwise the constructor will throw a * SecurityException. * * <p> See the {@link SystemTray} class overview for an example on how * to use the <code>TrayIcon</code> API. * * @since 1.6 * @see SystemTray#add * @see java.awt.event.ComponentEvent#getComponent * @see java.util.EventObject#getSource * * @author Bino George * @author Denis Mikhalkin * @author Sharon Zakhour * @author Anton Tarasov */public class TrayIcon {     private Image image;    private String tooltip;    private PopupMenu popup;    private boolean autosize;    private int id;    private String actionCommand;     transient private TrayIconPeer peer;     transient MouseListener mouseListener;    transient MouseMotionListener mouseMotionListener;    transient ActionListener actionListener;     /*     * The tray icon's AccessControlContext.     *     * Unlike the acc in Component, this field is made final     * because TrayIcon is not serializable.     */    private final AccessControlContext acc = AccessController.getContext();     /*     * Returns the acc this tray icon was constructed with.     */    final AccessControlContext getAccessControlContext() {        if (acc == null) {            throw new SecurityException("TrayIcon is missing AccessControlContext");        }        return acc;    }     static {        Toolkit.loadLibraries();        if (!GraphicsEnvironment.isHeadless()) {            initIDs();        }    }     private TrayIcon()      throws UnsupportedOperationException, HeadlessException, SecurityException    {        SystemTray.checkSystemTrayAllowed();        if (GraphicsEnvironment.isHeadless()) {            throw new HeadlessException();        }        if (!SystemTray.isSupported()) {            throw new UnsupportedOperationException();        }        SunToolkit.insertTargetMapping(this, AppContext.getAppContext());    }     /**     * Creates a <code>TrayIcon</code> with the specified image.     *     * @param image the <code>Image</code> to be used     * @throws IllegalArgumentException if <code>image</code> is     * <code>null</code>     * @throws UnsupportedOperationException if the system tray isn't     * supported by the current platform     * @throws HeadlessException if     * {@code GraphicsEnvironment.isHeadless()} returns {@code true}     * @throws SecurityException if {@code accessSystemTray} permission     * is not granted     * @see SystemTray#add(TrayIcon)     * @see TrayIcon#TrayIcon(Image, String, PopupMenu)     * @see TrayIcon#TrayIcon(Image, String)     * @see SecurityManager#checkPermission     * @see AWTPermission     */    public TrayIcon(Image image) {        this();        if (image == null) {            throw new IllegalArgumentException("creating TrayIcon with null Image");        }        setImage(image);    }     /**     * Creates a <code>TrayIcon</code> with the specified image and     * tooltip text.     *     * @param image the <code>Image</code> to be used     * @param tooltip the string to be used as tooltip text; if the     * value is <code>null</code> no tooltip is shown     * @throws IllegalArgumentException if <code>image</code> is     * <code>null</code>     * @throws UnsupportedOperationException if the system tray isn't     * supported by the current platform     * @throws HeadlessException if     * {@code GraphicsEnvironment.isHeadless()} returns {@code true}     * @throws SecurityException if {@code accessSystemTray} permission     * is not granted     * @see SystemTray#add(TrayIcon)     * @see TrayIcon#TrayIcon(Image)     * @see TrayIcon#TrayIcon(Image, String, PopupMenu)     * @see SecurityManager#checkPermission     * @see AWTPermission     */    public TrayIcon(Image image, String tooltip) {        this(image);        setToolTip(tooltip);    }     /**     * Creates a <code>TrayIcon</code> with the specified image,     * tooltip and popup menu.     *     * @param image the <code>Image</code> to be used     * @param tooltip the string to be used as tooltip text; if the     * value is <code>null</code> no tooltip is shown     * @param popup the menu to be used for the tray icon's popup     * menu; if the value is <code>null</code> no popup menu is shown     * @throws IllegalArgumentException if <code>image</code> is <code>null</code>     * @throws UnsupportedOperationException if the system tray isn't     * supported by the current platform     * @throws HeadlessException if     * {@code GraphicsEnvironment.isHeadless()} returns {@code true}     * @throws SecurityException if {@code accessSystemTray} permission     * is not granted     * @see SystemTray#add(TrayIcon)     * @see TrayIcon#TrayIcon(Image, String)     * @see TrayIcon#TrayIcon(Image)     * @see PopupMenu     * @see MouseListener     * @see #addMouseListener(MouseListener)     * @see SecurityManager#checkPermission     * @see AWTPermission     */    public TrayIcon(Image image, String tooltip, PopupMenu popup) {        this(image, tooltip);        setPopupMenu(popup);    }     /**     * Sets the image for this <code>TrayIcon</code>.  The previous     * tray icon image is discarded without calling the {@link     * java.awt.Image#flush} method &#151; you will need to call it     * manually.     *     * <p> If the image represents an animated image, it will be     * animated automatically.     *     * <p> See the {@link #setImageAutoSize(boolean)} property for     * details on the size of the displayed image.     *     * <p> Calling this method with the same image that is currently     * being used has no effect.     *     * @throws NullPointerException if <code>image</code> is <code>null</code>     * @param image the non-null <code>Image</code> to be used     * @see #getImage     * @see Image     * @see SystemTray#add(TrayIcon)     * @see TrayIcon#TrayIcon(Image, String)     */    public void setImage(Image image) {        if (image == null) {            throw new NullPointerException("setting null Image");        }        this.image = image;         TrayIconPeer peer = this.peer;        if (peer != null) {            peer.updateImage();        }    }     /**     * Returns the current image used for this <code>TrayIcon</code>.     *     * @return the image     * @see #setImage(Image)     * @see Image     */    public Image getImage() {        return image;    }     /**     * Sets the popup menu for this <code>TrayIcon</code>.  If     * <code>popup</code> is <code>null</code>, no popup menu will be     * associated with this <code>TrayIcon</code>.     *     * <p>Note that this <code>popup</code> must not be added to any     * parent before or after it is set on the tray icon.  If you add     * it to some parent, the <code>popup</code> may be removed from     * that parent.     *     * <p>The {@code popup} can be set on one {@code TrayIcon} only.     * Setting the same popup on multiple {@code TrayIcon}s will cause     * an {@code IllegalArgumentException}.     *     * <p><strong>Note:</strong> Some platforms may not support     * showing the user-specified popup menu component when the user     * right-clicks the tray icon.  In this situation, either no menu     * will be displayed or, on some systems, a native version of the     * menu may be displayed.     *     * @throws IllegalArgumentException if the {@code popup} is already     * set for another {@code TrayIcon}     * @param popup a <code>PopupMenu</code> or <code>null</code> to     * remove any popup menu     * @see #getPopupMenu     */    public void setPopupMenu(PopupMenu popup) {        if (popup == this.popup) {            return;        }        synchronized (TrayIcon.class) {            if (popup != null) {                if (popup.isTrayIconPopup) {                    throw new IllegalArgumentException("the PopupMenu is already set for another TrayIcon");                }                popup.isTrayIconPopup = true;            }            if (this.popup != null) {                this.popup.isTrayIconPopup = false;            }            this.popup = popup;        }    }     /**     * Returns the popup menu associated with this <code>TrayIcon</code>.     *     * @return the popup menu or <code>null</code> if none exists     * @see #setPopupMenu(PopupMenu)     */    public PopupMenu getPopupMenu() {        return popup;    }     /**     * Sets the tooltip string for this <code>TrayIcon</code>. The     * tooltip is displayed automatically when the mouse hovers over     * the icon.  Setting the tooltip to <code>null</code> removes any     * tooltip text.     *     * When displayed, the tooltip string may be truncated on some platforms;     * the number of characters that may be displayed is platform-dependent.     *     * @param tooltip the string for the tooltip; if the value is     * <code>null</code> no tooltip is shown     * @see #getToolTip     */    public void setToolTip(String tooltip) {        this.tooltip = tooltip;         TrayIconPeer peer = this.peer;        if (peer != null) {            peer.setToolTip(tooltip);        }    }     /**     * Returns the tooltip string associated with this     * <code>TrayIcon</code>.     *     * @return the tooltip string or <code>null</code> if none exists     * @see #setToolTip(String)     */    public String getToolTip() {        return tooltip;    }     /**     * Sets the auto-size property.  Auto-size determines whether the     * tray image is automatically sized to fit the space allocated     * for the image on the tray.  By default, the auto-size property     * is set to <code>false</code>.     *     * <p> If auto-size is <code>false</code>, and the image size     * doesn't match the tray icon space, the image is painted as-is     * inside that space &#151; if larger than the allocated space, it will     * be cropped.     *     * <p> If auto-size is <code>true</code>, the image is stretched or shrunk to     * fit the tray icon space.     *     * @param autosize <code>true</code> to auto-size the image,     * <code>false</code> otherwise     * @see #isImageAutoSize     */    public void setImageAutoSize(boolean autosize) {        this.autosize = autosize;         TrayIconPeer peer = this.peer;        if (peer != null) {            peer.updateImage();        }    }     /**     * Returns the value of the auto-size property.     *     * @return <code>true</code> if the image will be auto-sized,     * <code>false</code> otherwise     * @see #setImageAutoSize(boolean)     */    public boolean isImageAutoSize() {        return autosize;    }     /**     * Adds the specified mouse listener to receive mouse events from     * this <code>TrayIcon</code>.  Calling this method with a     * <code>null</code> value has no effect.     *     * <p><b>Note</b>: The {@code MouseEvent}'s coordinates (received     * from the {@code TrayIcon}) are relative to the screen, not the     * {@code TrayIcon}.     *     * <p> <b>Note: </b>The <code>MOUSE_ENTERED</code> and     * <code>MOUSE_EXITED</code> mouse events are not supported.     * <p>Refer to <a href="doc-files/AWTThreadIssues.html#ListenersThreads"     * >AWT Threading Issues</a> for details on AWT's threading model.     *     * @param    listener the mouse listener     * @see      java.awt.event.MouseEvent     * @see      java.awt.event.MouseListener     * @see      #removeMouseListener(MouseListener)     * @see      #getMouseListeners     */    public synchronized void addMouseListener(MouseListener listener) {        if (listener == null) {            return;        }        mouseListener = AWTEventMulticaster.add(mouseListener, listener);    }     /**     * Removes the specified mouse listener.  Calling this method with     * <code>null</code> or an invalid value has no effect.     * <p>Refer to <a href="doc-files/AWTThreadIssues.html#ListenersThreads"     * >AWT Threading Issues</a> for details on AWT's threading model.     *     * @param    listener   the mouse listener     * @see      java.awt.event.MouseEvent     * @see      java.awt.event.MouseListener     * @see      #addMouseListener(MouseListener)     * @see      #getMouseListeners     */    public synchronized void removeMouseListener(MouseListener listener) {        if (listener == null) {            return;        }        mouseListener = AWTEventMulticaster.remove(mouseListener, listener);    }     /**     * Returns an array of all the mouse listeners     * registered on this <code>TrayIcon</code>.     *     * @return all of the <code>MouseListeners</code> registered on     * this <code>TrayIcon</code> or an empty array if no mouse     * listeners are currently registered     *     * @see      #addMouseListener(MouseListener)     * @see      #removeMouseListener(MouseListener)     * @see      java.awt.event.MouseListener     */    public synchronized MouseListener[] getMouseListeners() {        return AWTEventMulticaster.getListeners(mouseListener, MouseListener.class);    }     /**     * Adds the specified mouse listener to receive mouse-motion     * events from this <code>TrayIcon</code>.  Calling this method     * with a <code>null</code> value has no effect.     *     * <p><b>Note</b>: The {@code MouseEvent}'s coordinates (received     * from the {@code TrayIcon}) are relative to the screen, not the     * {@code TrayIcon}.     *     * <p> <b>Note: </b>The <code>MOUSE_DRAGGED</code> mouse event is not supported.     * <p>Refer to <a href="doc-files/AWTThreadIssues.html#ListenersThreads"     * >AWT Threading Issues</a> for details on AWT's threading model.     *     * @param    listener   the mouse listener     * @see      java.awt.event.MouseEvent     * @see      java.awt.event.MouseMotionListener     * @see      #removeMouseMotionListener(MouseMotionListener)     * @see      #getMouseMotionListeners     */    public synchronized void addMouseMotionListener(MouseMotionListener listener) {        if (listener == null) {            return;        }        mouseMotionListener = AWTEventMulticaster.add(mouseMotionListener, listener);    }     /**     * Removes the specified mouse-motion listener.  Calling this method with     * <code>null</code> or an invalid value has no effect.     * <p>Refer to <a href="doc-files/AWTThreadIssues.html#ListenersThreads"     * >AWT Threading Issues</a> for details on AWT's threading model.     *     * @param    listener   the mouse listener     * @see      java.awt.event.MouseEvent     * @see      java.awt.event.MouseMotionListener     * @see      #addMouseMotionListener(MouseMotionListener)     * @see      #getMouseMotionListeners     */    public synchronized void removeMouseMotionListener(MouseMotionListener listener) {        if (listener == null) {

Lines 1–500 of 780. Load more