Source for java.awt.PopupMenu

   1: /* PopupMenu.java -- An AWT popup menu
   2:    Copyright (C) 1999, 2000, 2001, 2002, 2004  Free Software Foundation, Inc.
   3: 
   4: This file is part of GNU Classpath.
   5: 
   6: GNU Classpath is free software; you can redistribute it and/or modify
   7: it under the terms of the GNU General Public License as published by
   8: the Free Software Foundation; either version 2, or (at your option)
   9: any later version.
  10: 
  11: GNU Classpath is distributed in the hope that it will be useful, but
  12: WITHOUT ANY WARRANTY; without even the implied warranty of
  13: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14: General Public License for more details.
  15: 
  16: You should have received a copy of the GNU General Public License
  17: along with GNU Classpath; see the file COPYING.  If not, write to the
  18: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  19: 02110-1301 USA.
  20: 
  21: Linking this library statically or dynamically with other modules is
  22: making a combined work based on this library.  Thus, the terms and
  23: conditions of the GNU General Public License cover the whole
  24: combination.
  25: 
  26: As a special exception, the copyright holders of this library give you
  27: permission to link this library with independent modules to produce an
  28: executable, regardless of the license terms of these independent
  29: modules, and to copy and distribute the resulting executable under
  30: terms of your choice, provided that you also meet, for each linked
  31: independent module, the terms and conditions of the license of that
  32: module.  An independent module is a module which is not derived from
  33: or based on this library.  If you modify this library, you may extend
  34: this exception to your version of the library, but you are not
  35: obligated to do so.  If you do not wish to do so, delete this
  36: exception statement from your version. */
  37: 
  38: 
  39: package java.awt;
  40: 
  41: import java.awt.peer.PopupMenuPeer;
  42: 
  43: import javax.accessibility.AccessibleContext;
  44: import javax.accessibility.AccessibleRole;
  45: 
  46: /**
  47:   * This class implement an AWT popup menu widget
  48:   *
  49:   * @author Aaron M. Renn (arenn@urbanophile.com)
  50:   */
  51: public class PopupMenu extends Menu
  52: {
  53: 
  54: /*
  55:  * Static Variables
  56:  */
  57: 
  58:   /**
  59:    * The number used to generate the name returned by getName.
  60:    */
  61:   private static transient long next_popup_number;
  62: 
  63:   // Serialization Constant
  64:   private static final long serialVersionUID = - 4620452533522760060L;
  65: 
  66: /*************************************************************************/
  67: 
  68: /*
  69:  * Constructors
  70:  */
  71: 
  72: /**
  73:   * Initializes a new instance of <code>PopupMenu</code>.
  74:   *
  75:   * @exception HeadlessException If GraphicsEnvironment.isHeadless()
  76:   * returns true.
  77:   */
  78: public
  79: PopupMenu()
  80: {
  81: }
  82: 
  83: /*************************************************************************/
  84: 
  85: /**
  86:   * Initializes a new instance of <code>PopupMenu</code> with the specified
  87:   * label.
  88:   *
  89:   * @param label The label for this popup menu.
  90:   *
  91:   * @exception HeadlessException If GraphicsEnvironment.isHeadless()
  92:   * returns true.
  93:   */
  94: public
  95: PopupMenu(String label)
  96: {
  97:   super(label);
  98: 
  99:   if (GraphicsEnvironment.isHeadless())
 100:     throw new HeadlessException ();
 101: }
 102: 
 103: /*************************************************************************/
 104: 
 105: /*
 106:  * Instance Methods
 107:  */
 108: 
 109: /**
 110:   * Creates this object's native peer.
 111:   */
 112: public void
 113: addNotify()
 114: {
 115:   if (peer == null)
 116:     peer = getToolkit ().createPopupMenu (this);
 117:   super.addNotify ();
 118: }
 119: 
 120: /*************************************************************************/
 121: 
 122: /**
 123:   * Displays this popup menu at the specified coordinates relative to
 124:   * the specified component.
 125:   *
 126:   * @param component The component to which the display coordinates are relative.
 127:   * @param x The X coordinate of the menu.
 128:   * @param y The Y coordinate of the menu.
 129:   */
 130: public void
 131: show(Component component, int x, int y)
 132: {
 133:   if (getPeer() == null)
 134:     this.addNotify();
 135:   PopupMenuPeer pmp = (PopupMenuPeer)getPeer();
 136:   if (pmp != null)
 137:     {
 138:       /* XXX
 139:       Event e = new Event (component, Event.ACTION_EVENT, component);
 140:       e.x = x;
 141:       e.y = y;*/
 142:       pmp.show (component, x, y);
 143:     }
 144: }
 145: 
 146:   protected class AccessibleAWTPopupMenu extends AccessibleAWTMenu
 147:   {
 148:     private static final long serialVersionUID = -4282044795947239955L;
 149: 
 150:     protected AccessibleAWTPopupMenu()
 151:     {
 152:     }
 153:     
 154:     public AccessibleRole getAccessibleRole()
 155:     {
 156:       return AccessibleRole.POPUP_MENU;
 157:     }
 158:     
 159:   }
 160:   
 161:   /**
 162:    * Gets the AccessibleContext associated with this <code>PopupMenu</code>.
 163:    * The context is created, if necessary.
 164:    *
 165:    * @return the associated context
 166:    */
 167:   public AccessibleContext getAccessibleContext()
 168:   {
 169:     /* Create the context if this is the first request */
 170:     if (accessibleContext == null)
 171:       accessibleContext = new AccessibleAWTPopupMenu();
 172:     return accessibleContext;
 173:   }
 174:   
 175:   /**
 176:    * Generate a unique name for this <code>PopupMenu</code>.
 177:    *
 178:    * @return A unique name for this <code>PopupMenu</code>.
 179:    */
 180:   String generateName()
 181:   {
 182:     return "popup" + getUniqueLong();
 183:   }
 184: 
 185:   private static synchronized long getUniqueLong()
 186:   {
 187:     return next_popup_number++;
 188:   }
 189: 
 190: } // class PopupMenu