Class PopupMenu
java.lang.Object
java.awt.MenuComponent
java.awt.MenuItem
java.awt.Menu
java.awt.PopupMenu
- All Implemented Interfaces:
MenuContainer,Serializable,Accessible
A class that implements a menu which can be dynamically popped up
at a specified position within a component.
As the inheritance hierarchy implies, a PopupMenu
can be used anywhere a Menu can be used.
However, if you use a PopupMenu like a Menu
(e.g., you add it to a MenuBar), then you cannot
call show on that PopupMenu.
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprotected classInner class of PopupMenu used to provide default support for accessibility.Nested classes/interfaces declared in class java.awt.Menu
Menu.AccessibleAWTMenuNested classes/interfaces declared in class java.awt.MenuItem
MenuItem.AccessibleAWTMenuItemNested classes/interfaces declared in class java.awt.MenuComponent
MenuComponent.AccessibleAWTMenuComponent -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidCreates the popup menu's peer.Gets theAccessibleContextassociated with thisPopupMenu.voidShows the popup menu at the x, y position relative to an origin component.Methods declared in class java.awt.Menu
add, add, addSeparator, countItems, getItem, getItemCount, insert, insert, insertSeparator, isTearOff, paramString, remove, remove, removeAll, removeNotifyMethods declared in class java.awt.MenuItem
addActionListener, deleteShortcut, disable, disableEvents, enable, enable, enableEvents, getActionCommand, getActionListeners, getLabel, getListeners, getShortcut, isEnabled, processActionEvent, processEvent, removeActionListener, setActionCommand, setEnabled, setLabel, setShortcutMethods declared in class java.awt.MenuComponent
dispatchEvent, getFont, getName, getParent, getTreeLock, postEvent, setFont, setName, toStringMethods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods declared in interface java.awt.MenuContainer
getFont, postEvent
-
Constructor Details
-
PopupMenu
Creates a new popup menu with an empty name.- Throws:
HeadlessException- if GraphicsEnvironment.isHeadless() returns true.- See Also:
-
PopupMenu
Creates a new popup menu with the specified name.- Parameters:
label- a non-nullstring specifying the popup menu's label- Throws:
HeadlessException- if GraphicsEnvironment.isHeadless() returns true.- See Also:
-
-
Method Details
-
addNotify
-
show
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 this
PopupMenuis being used as aMenu(i.e., it has a non-Componentparent), then you cannot call this method on thePopupMenu.- Parameters:
origin- the component which defines the coordinate spacex- the x coordinate position to popup the menuy- the y coordinate position to popup the menu- Throws:
NullPointerException- if the parent isnullIllegalArgumentException- if thisPopupMenuhas a non-ComponentparentIllegalArgumentException- if the origin is not in the parent's hierarchyRuntimeException- if the parent is not showing on screen
-
getAccessibleContext
Gets theAccessibleContextassociated with thisPopupMenu.- Specified by:
getAccessibleContextin interfaceAccessible- Overrides:
getAccessibleContextin classMenu- Returns:
- the
AccessibleContextof thisPopupMenu - Since:
- 1.3
-