Class PopupMenu

java.lang.Object
java.awt.MenuComponent
java.awt.MenuItem
java.awt.Menu
java.awt.PopupMenu
All Implemented Interfaces:
MenuContainer,Serializable,Accessible
public classPopupMenuextendsMenu
A class that implements a menu which can be dynamically popped up at a specified position within a component.

As the inheritance hierarchy implies, aPopupMenu can be used anywhere aMenu can be used. However, if you use aPopupMenu like aMenu (e.g., you add it to aMenuBar), then youcannot callshow on thatPopupMenu.

See Also:

  • Constructor Details

  • Method Details

    • addNotify

      public void addNotify()
      Creates the popup menu's peer. The peer allows us to change the appearance of the popup menu without changing any of the popup menu's functionality.
      Overrides:
      addNotify in class Menu

    • show

      public void show(Component origin, int x, int y)
      Shows the popup menu at the x, y position relative to an origin component. The origin component must be contained within the component hierarchy of the popup menu's parent. Both the origin and the parent must be showing on the screen for this method to be valid.

      If thisPopupMenu is being used as aMenu (i.e., it has a non-Component parent), then you cannot call this method on thePopupMenu.

      Parameters:
      origin - the component which defines the coordinate space
      x - the x coordinate position to popup the menu
      y - the y coordinate position to popup the menu
      Throws:
      NullPointerException - if the parent isnull
      IllegalArgumentException - if thisPopupMenu has a non-Component parent
      IllegalArgumentException - if the origin is not in the parent's hierarchy
      RuntimeException - if the parent is not showing on screen

    • getAccessibleContext

      public AccessibleContext getAccessibleContext()
      Gets theAccessibleContext associated with thisPopupMenu.
      Specified by:
      getAccessibleContext in interface Accessible
      Overrides:
      getAccessibleContext in class Menu
      Returns:
      theAccessibleContext of thisPopupMenu
      Since:
      1.3