java.lang.Object | ||||
↳ | java.awt.MenuComponent | |||
↳ | java.awt.MenuItem | |||
↳ | java.awt.Menu | |||
↳ | java.awt.PopupMenu |
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
.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
PopupMenu.AccessibleAWTPopupMenu | Inner class of PopupMenu used to provide default support for accessibility. |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates a new popup menu with an empty name.
| |||||||||||
Creates a new popup menu with the specified name.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates the popup menu's peer.
| |||||||||||
Gets the
AccessibleContext associated with this
PopupMenu . | |||||||||||
Returns the parent container for this menu component.
| |||||||||||
Shows the popup menu at the x, y position relative to an origin
component.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.awt.Menu
| |||||||||||
From class
java.awt.MenuItem
| |||||||||||
From class
java.awt.MenuComponent
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
java.awt.MenuContainer
| |||||||||||
From interface
javax.accessibility.Accessible
|
Creates a new popup menu with an empty name.
HeadlessException | if GraphicsEnvironment.isHeadless() returns true. |
---|
Creates a new popup menu with the specified name.
label | a non-null string specifying
the popup menu's label |
---|
HeadlessException | if GraphicsEnvironment.isHeadless() returns true. |
---|
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.
Gets the AccessibleContext
associated with this
PopupMenu
.
AccessibleContext
of this
PopupMenu
Returns the parent container for this menu component.
null
if this menu component
is the outermost component, the menu bar itself
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 PopupMenu
is being used as a Menu
(i.e., it has a non-Component
parent),
then you cannot call this method on the PopupMenu
.
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 |
NullPointerException | if the parent is null |
---|---|
IllegalArgumentException | if this PopupMenu
has a non-Component parent |
IllegalArgumentException | if the origin is not in the parent's heirarchy |
RuntimeException | if the parent is not showing on screen |