This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.


java.awt
class PopupMenu

java.lang.Object extended by java.awt.MenuComponent extended by java.awt.MenuItem extended by java.awt.Menu extended by java.awt.PopupMenu
All Implemented Interfaces:
MenuContainer, Serializable, Accessible

Most common way to construct:

PopupMenu popup = new PopupMenu();

Based on 64 examples


public class PopupMenu
extends Menu

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 Class Summary
protected class

           Inner class of PopupMenu used to provide default support for accessibility.
Nested classes/interfaces inherited from class java.awt.Menu
Menu.AccessibleAWTMenu
 
Nested classes/interfaces inherited from class java.awt.MenuItem
MenuItem.AccessibleAWTMenuItem
 
Nested classes/interfaces inherited from class java.awt.MenuComponent
MenuComponent.AccessibleAWTMenuComponent
   
Constructor Summary

          Creates a new popup menu with an empty name.

          Creates a new popup menu with the specified name.
 
Method Summary
 void

          Creates the popup menu's peer.
 AccessibleContext

          Gets the AccessibleContext associated with this PopupMenu.
 MenuContainer

          Returns the parent container for this menu component.
 void
show(Component origin, int x, int y)

          Shows the popup menu at the x, y position relative to an origin component.
 
Methods inherited from class java.awt.Menu
add, add, addNotify, addSeparator, countItems, getAccessibleContext, getItem, getItemCount, insert, insert, insertSeparator, isTearOff, paramString, remove, remove, removeAll, removeNotify
 
Methods inherited from class java.awt.MenuItem
addActionListener, addNotify, deleteShortcut, disable, disableEvents, enable, enable, enableEvents, getAccessibleContext, getActionCommand, getActionListeners, getLabel, getListeners, getShortcut, isEnabled, paramString, processActionEvent, processEvent, removeActionListener, setActionCommand, setEnabled, setLabel, setShortcut
 
Methods inherited from class java.awt.MenuComponent
dispatchEvent, getAccessibleContext, getFont, getName, getParent, getPeer, getTreeLock, paramString, postEvent, processEvent, removeNotify, setFont, setName, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PopupMenu

public PopupMenu()
          throws HeadlessException
Creates a new popup menu with an empty name.

Throws:
HeadlessException - if GraphicsEnvironment.isHeadless() returns true.

PopupMenu

public PopupMenu(String label)
          throws HeadlessException
Creates a new popup menu with the specified name.

Parameters:
label - a non-null string specifying the popup menu's label
Throws:
HeadlessException - if GraphicsEnvironment.isHeadless() returns true.
Method Detail

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

getAccessibleContext

public AccessibleContext getAccessibleContext()
Gets the AccessibleContext associated with this PopupMenu.

Overrides:
getAccessibleContext in class Menu
Returns:
the AccessibleContext of this PopupMenu

getParent

public MenuContainer getParent()
{@inheritDoc}

Overrides:
getParent in class MenuComponent

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 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.

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


This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.
This page displays the Jadeite version of the documention, which is derived from the offical documentation that contains this copyright notice:
Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
The official Sun™ documentation can be found here at http://java.sun.com/javase/6/docs/api/.