- java.lang.Object
- 
- java.awt.Component
- 
- java.awt.Container
- 
- javax.swing.JComponent
- 
- javax.swing.JPopupMenu
 
 
 
 
- 
- All Implemented Interfaces:
- ImageObserver,- MenuContainer,- Serializable,- Accessible,- MenuElement
 - Direct Known Subclasses:
- BasicComboPopup
 
 @JavaBean(defaultProperty="UI", description="A small window that pops up and displays a series of choices.") public class JPopupMenu extends JComponent implements Accessible, MenuElement An implementation of a popup menu -- a small window that pops up and displays a series of choices. AJPopupMenuis used for the menu that appears when the user selects an item on the menu bar. It is also used for "pull-right" menu that appears when the selects a menu item that activates it. Finally, aJPopupMenucan also be used anywhere else you want a menu to appear. For example, when the user right-clicks in a specified area.For information and examples of using popup menus, see How to Use Menus in The Java Tutorial. Warning: Swing is not thread safe. For more information see Swing's Threading Policy. Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans™ has been added to the java.beanspackage. Please seeXMLEncoder.- Since:
- 1.2
- See Also:
- Serialized Form
 
- 
- 
Nested Class SummaryNested Classes Modifier and Type Class Description protected classJPopupMenu.AccessibleJPopupMenuThis class implements accessibility support for theJPopupMenuclass.static classJPopupMenu.SeparatorA popup menu-specific separator.- 
Nested classes/interfaces declared in class javax.swing.JComponentJComponent.AccessibleJComponent
 - 
Nested classes/interfaces declared in class java.awt.ContainerContainer.AccessibleAWTContainer
 - 
Nested classes/interfaces declared in class java.awt.ComponentComponent.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
- 
 - 
Field Summary- 
Fields declared in class javax.swing.JComponentlistenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 - 
Fields declared in class java.awt.ComponentaccessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 - 
Fields declared in interface java.awt.image.ImageObserverABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
- 
 - 
Constructor SummaryConstructors Constructor Description JPopupMenu()Constructs aJPopupMenuwithout an "invoker".JPopupMenu(String label)Constructs aJPopupMenuwith the specified title.
 - 
Method SummaryAll Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description JMenuItemadd(String s)Creates a new menu item with the specified text and appends it to the end of this menu.JMenuItemadd(Action a)Appends a new menu item to the end of the menu which dispatches the specifiedActionobject.JMenuItemadd(JMenuItem menuItem)Appends the specified menu item to the end of this menu.voidaddMenuKeyListener(MenuKeyListener l)Adds aMenuKeyListenerto the popup menu.voidaddPopupMenuListener(PopupMenuListener l)Adds aPopupMenulistener.voidaddSeparator()Appends a new separator at the end of the menu.protected PropertyChangeListenercreateActionChangeListener(JMenuItem b)Returns a properly configuredPropertyChangeListenerwhich updates the control as changes to theActionoccur.protected JMenuItemcreateActionComponent(Action a)Factory method which creates theJMenuItemforActionsadded to theJPopupMenu.protected voidfirePopupMenuCanceled()NotifiesPopupMenuListenersthat this popup menu is cancelled.protected voidfirePopupMenuWillBecomeInvisible()NotifiesPopupMenuListeners that this popup menu will become invisible.protected voidfirePopupMenuWillBecomeVisible()NotifiesPopupMenuListeners that this popup menu will become visible.AccessibleContextgetAccessibleContext()Gets the AccessibleContext associated with this JPopupMenu.ComponentgetComponent()Returns thisJPopupMenucomponent.ComponentgetComponentAtIndex(int i)Deprecated.replaced byContainer.getComponent(int)intgetComponentIndex(Component c)Returns the index of the specified component.static booleangetDefaultLightWeightPopupEnabled()Gets thedefaultLightWeightPopupEnabledproperty, which by default istrue.ComponentgetInvoker()Returns the component which is the 'invoker' of this popup menu.StringgetLabel()Returns the popup menu's labelInsetsgetMargin()Returns the margin, in pixels, between the popup menu's border and its containers.MenuKeyListener[]getMenuKeyListeners()Returns an array of all theMenuKeyListeners added to this JPopupMenu with addMenuKeyListener().PopupMenuListener[]getPopupMenuListeners()Returns an array of all thePopupMenuListeners added to this JMenuItem with addPopupMenuListener().SingleSelectionModelgetSelectionModel()Returns the model object that handles single selections.MenuElement[]getSubElements()Returns an array ofMenuElements containing the submenu for this menu component.PopupMenuUIgetUI()Returns the look and feel (L&F) object that renders this component.StringgetUIClassID()Returns the name of the L&F class that renders this component.voidinsert(Component component, int index)Inserts the specified component into the menu at a given position.voidinsert(Action a, int index)Inserts a menu item for the specifiedActionobject at a given position.booleanisBorderPainted()Checks whether the border should be painted.booleanisLightWeightPopupEnabled()Gets thelightWeightPopupEnabledproperty.booleanisPopupTrigger(MouseEvent e)Returns true if theMouseEventis considered a popup trigger by theJPopupMenu's currently installed UI.booleanisVisible()Returns true if the popup menu is visible (currently being displayed).voidmenuSelectionChanged(boolean isIncluded)Messaged when the menubar selection changes to activate or deactivate this menu.voidpack()Lays out the container so that it uses the minimum space needed to display its contents.protected voidpaintBorder(Graphics g)Paints the popup menu's border if theborderPaintedproperty istrue.protected StringparamString()Returns a string representation of thisJPopupMenu.protected voidprocessKeyEvent(KeyEvent evt)Processes key stroke events such as mnemonics and accelerators.voidprocessKeyEvent(KeyEvent e, MenuElement[] path, MenuSelectionManager manager)Processes a key event forwarded from theMenuSelectionManagerand changes the menu selection, if necessary, by usingMenuSelectionManager's API.voidprocessMouseEvent(MouseEvent event, MenuElement[] path, MenuSelectionManager manager)This method is required to conform to theMenuElementinterface, but it not implemented.voidremove(int pos)Removes the component at the specified index from this popup menu.voidremoveMenuKeyListener(MenuKeyListener l)Removes aMenuKeyListenerfrom the popup menu.voidremovePopupMenuListener(PopupMenuListener l)Removes aPopupMenulistener.voidsetBorderPainted(boolean b)Sets whether the border should be painted.static voidsetDefaultLightWeightPopupEnabled(boolean aFlag)Sets the default value of thelightWeightPopupEnabledproperty.voidsetInvoker(Component invoker)Sets the invoker of this popup menu -- the component in which the popup menu menu is to be displayed.voidsetLabel(String label)Sets the popup menu's label.voidsetLightWeightPopupEnabled(boolean aFlag)Sets the value of thelightWeightPopupEnabledproperty, which by default istrue.voidsetLocation(int x, int y)Sets the location of the upper left corner of the popup menu using x, y coordinates.voidsetPopupSize(int width, int height)Sets the size of the Popup window to the specified width and height.voidsetPopupSize(Dimension d)Sets the size of the Popup window using aDimensionobject.voidsetSelected(Component sel)Sets the currently selected component, This will result in a change to the selection model.voidsetSelectionModel(SingleSelectionModel model)Sets the model object to handle single selections.voidsetUI(PopupMenuUI ui)Sets the L&F object that renders this component.voidsetVisible(boolean b)Sets the visibility of the popup menu.voidshow(Component invoker, int x, int y)Displays the popup menu at the position x,y in the coordinate space of the component invoker.voidupdateUI()Resets the UI property to a value from the current look and feel.- 
Methods declared in class javax.swing.JComponentaddAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, unregisterKeyboardAction, update
 - 
Methods declared in class java.awt.Containeradd, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
 - 
Methods declared in class java.awt.Componentaction, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
 
- 
 
- 
- 
- 
Constructor Detail- 
JPopupMenupublic JPopupMenu() Constructs aJPopupMenuwithout an "invoker".
 - 
JPopupMenupublic JPopupMenu(String label) Constructs aJPopupMenuwith the specified title.- Parameters:
- label- the string that a UI may use to display as a title for the popup menu.
 
 
- 
 - 
Method Detail- 
setDefaultLightWeightPopupEnabledpublic static void setDefaultLightWeightPopupEnabled(boolean aFlag) Sets the default value of thelightWeightPopupEnabledproperty.- Parameters:
- aFlag-- trueif popups can be lightweight, otherwise- false
- See Also:
- getDefaultLightWeightPopupEnabled(),- setLightWeightPopupEnabled(boolean)
 
 - 
getDefaultLightWeightPopupEnabledpublic static boolean getDefaultLightWeightPopupEnabled() Gets thedefaultLightWeightPopupEnabledproperty, which by default istrue.- Returns:
- the value of the defaultLightWeightPopupEnabledproperty
- See Also:
- setDefaultLightWeightPopupEnabled(boolean)
 
 - 
getUIpublic PopupMenuUI getUI() Returns the look and feel (L&F) object that renders this component.- Overrides:
- getUIin class- JComponent
- Returns:
- the PopupMenuUIobject that renders this component
 
 - 
setUI@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component\'s LookAndFeel.") public void setUI(PopupMenuUI ui) Sets the L&F object that renders this component.- Parameters:
- ui- the new- PopupMenuUIL&F object
- See Also:
- UIDefaults.getUI(javax.swing.JComponent)
 
 - 
updateUIpublic void updateUI() Resets the UI property to a value from the current look and feel.- Overrides:
- updateUIin class- JComponent
- See Also:
- JComponent.updateUI()
 
 - 
getUIClassID@BeanProperty(bound=false) public String getUIClassID() Returns the name of the L&F class that renders this component.- Overrides:
- getUIClassIDin class- JComponent
- Returns:
- the string "PopupMenuUI"
- See Also:
- JComponent.getUIClassID(),- UIDefaults.getUI(javax.swing.JComponent)
 
 - 
processKeyEventprotected void processKeyEvent(KeyEvent evt) Processes key stroke events such as mnemonics and accelerators.- Overrides:
- processKeyEventin class- JComponent
- Parameters:
- evt- the key event to be processed
- See Also:
- KeyEvent,- KeyListener,- KeyboardFocusManager,- DefaultKeyboardFocusManager,- Component.processEvent(java.awt.AWTEvent),- Component.dispatchEvent(java.awt.AWTEvent),- Component.addKeyListener(java.awt.event.KeyListener),- Component.enableEvents(long),- Component.isShowing()
 
 - 
getSelectionModelpublic SingleSelectionModel getSelectionModel() Returns the model object that handles single selections.- Returns:
- the selectionModelproperty
- See Also:
- SingleSelectionModel
 
 - 
setSelectionModel@BeanProperty(bound=false, expert=true, description="The selection model for the popup menu") public void setSelectionModel(SingleSelectionModel model) Sets the model object to handle single selections.- Parameters:
- model- the new- SingleSelectionModel
- See Also:
- SingleSelectionModel
 
 - 
addpublic JMenuItem add(JMenuItem menuItem) Appends the specified menu item to the end of this menu.- Parameters:
- menuItem- the- JMenuItemto add
- Returns:
- the JMenuItemadded
 
 - 
addpublic JMenuItem add(String s) Creates a new menu item with the specified text and appends it to the end of this menu.- Parameters:
- s- the string for the menu item to be added
- Returns:
- a new JMenuItemcreated usings
 
 - 
addpublic JMenuItem add(Action a) Appends a new menu item to the end of the menu which dispatches the specifiedActionobject.- Parameters:
- a- the- Actionto add to the menu
- Returns:
- the new menu item
- See Also:
- Action
 
 - 
createActionComponentprotected JMenuItem createActionComponent(Action a) Factory method which creates theJMenuItemforActionsadded to theJPopupMenu.- Parameters:
- a- the- Actionfor the menu item to be added
- Returns:
- the new menu item
- Since:
- 1.3
- See Also:
- Action
 
 - 
createActionChangeListenerprotected PropertyChangeListener createActionChangeListener(JMenuItem b) Returns a properly configuredPropertyChangeListenerwhich updates the control as changes to theActionoccur.- Parameters:
- b- the menu item for which to create a listener
- Returns:
- a properly configured PropertyChangeListener
 
 - 
removepublic void remove(int pos) Removes the component at the specified index from this popup menu.- Overrides:
- removein class- Container
- Parameters:
- pos- the position of the item to be removed
- Throws:
- IllegalArgumentException- if the value of- pos< 0, or if the value of- posis greater than the number of items
- See Also:
- Container.add(java.awt.Component),- Container.invalidate(),- Container.validate(),- Container.getComponentCount()
 
 - 
setLightWeightPopupEnabled@BeanProperty(bound=false, expert=true, description="Determines whether lightweight popups are used when possible") public void setLightWeightPopupEnabled(boolean aFlag) Sets the value of thelightWeightPopupEnabledproperty, which by default istrue. By default, when a look and feel displays a popup, it can choose to use a lightweight (all-Java) popup. Lightweight popup windows are more efficient than heavyweight (native peer) windows, but lightweight and heavyweight components do not mix well in a GUI. If your application mixes lightweight and heavyweight components, you should disable lightweight popups. Some look and feels might always use heavyweight popups, no matter what the value of this property.- Parameters:
- aFlag-- falseto disable lightweight popups
- See Also:
- isLightWeightPopupEnabled()
 
 - 
isLightWeightPopupEnabledpublic boolean isLightWeightPopupEnabled() Gets thelightWeightPopupEnabledproperty.- Returns:
- the value of the lightWeightPopupEnabledproperty
- See Also:
- setLightWeightPopupEnabled(boolean)
 
 - 
getLabelpublic String getLabel() Returns the popup menu's label- Returns:
- a string containing the popup menu's label
- See Also:
- setLabel(java.lang.String)
 
 - 
setLabel@BeanProperty(description="The label for the popup menu.") public void setLabel(String label) Sets the popup menu's label. Different look and feels may choose to display or not display this.- Parameters:
- label- a string specifying the label for the popup menu
- See Also:
- setLabel(java.lang.String)
 
 - 
addSeparatorpublic void addSeparator() Appends a new separator at the end of the menu.
 - 
insertpublic void insert(Action a, int index) Inserts a menu item for the specifiedActionobject at a given position.- Parameters:
- a- the- Actionobject to insert
- index- specifies the position at which to insert the- Action, where 0 is the first
- Throws:
- IllegalArgumentException- if- index< 0
- See Also:
- Action
 
 - 
insertpublic void insert(Component component, int index) Inserts the specified component into the menu at a given position.- Parameters:
- component- the- Componentto insert
- index- specifies the position at which to insert the component, where 0 is the first
- Throws:
- IllegalArgumentException- if- index< 0
 
 - 
addPopupMenuListenerpublic void addPopupMenuListener(PopupMenuListener l) Adds aPopupMenulistener.- Parameters:
- l- the- PopupMenuListenerto add
 
 - 
removePopupMenuListenerpublic void removePopupMenuListener(PopupMenuListener l) Removes aPopupMenulistener.- Parameters:
- l- the- PopupMenuListenerto remove
 
 - 
getPopupMenuListeners@BeanProperty(bound=false) public PopupMenuListener[] getPopupMenuListeners() Returns an array of all thePopupMenuListeners added to this JMenuItem with addPopupMenuListener().- Returns:
- all of the PopupMenuListeners added or an empty array if no listeners have been added
- Since:
- 1.4
 
 - 
addMenuKeyListenerpublic void addMenuKeyListener(MenuKeyListener l) Adds aMenuKeyListenerto the popup menu.- Parameters:
- l- the- MenuKeyListenerto be added
- Since:
- 1.5
 
 - 
removeMenuKeyListenerpublic void removeMenuKeyListener(MenuKeyListener l) Removes aMenuKeyListenerfrom the popup menu.- Parameters:
- l- the- MenuKeyListenerto be removed
- Since:
- 1.5
 
 - 
getMenuKeyListeners@BeanProperty(bound=false) public MenuKeyListener[] getMenuKeyListeners() Returns an array of all theMenuKeyListeners added to this JPopupMenu with addMenuKeyListener().- Returns:
- all of the MenuKeyListeners added or an empty array if no listeners have been added
- Since:
- 1.5
 
 - 
firePopupMenuWillBecomeVisibleprotected void firePopupMenuWillBecomeVisible() NotifiesPopupMenuListeners that this popup menu will become visible.
 - 
firePopupMenuWillBecomeInvisibleprotected void firePopupMenuWillBecomeInvisible() NotifiesPopupMenuListeners that this popup menu will become invisible.
 - 
firePopupMenuCanceledprotected void firePopupMenuCanceled() NotifiesPopupMenuListenersthat this popup menu is cancelled.
 - 
packpublic void pack() Lays out the container so that it uses the minimum space needed to display its contents.
 - 
setVisible@BeanProperty(description="Makes the popup visible") public void setVisible(boolean b) Sets the visibility of the popup menu.- Overrides:
- setVisiblein class- JComponent
- Parameters:
- b- true to make the popup visible, or false to hide it
- See Also:
- Component.isVisible(),- Component.invalidate()
 
 - 
isVisiblepublic boolean isVisible() Returns true if the popup menu is visible (currently being displayed).- Overrides:
- isVisiblein class- Component
- Returns:
- trueif the component is visible,- falseotherwise
- See Also:
- Component.setVisible(boolean)
 
 - 
setLocation@BeanProperty(description="The location of the popup menu.") public void setLocation(int x, int y) Sets the location of the upper left corner of the popup menu using x, y coordinates.The method changes the geometry-related data. Therefore, the native windowing system may ignore such requests, or it may modify the requested data, so that the JPopupMenuobject is placed and sized in a way that corresponds closely to the desktop settings.- Overrides:
- setLocationin class- Component
- Parameters:
- x- the x coordinate of the popup's new position in the screen's coordinate space
- y- the y coordinate of the popup's new position in the screen's coordinate space
- See Also:
- Component.getLocation(),- Component.setBounds(int, int, int, int),- Component.invalidate()
 
 - 
getInvokerpublic Component getInvoker() Returns the component which is the 'invoker' of this popup menu.- Returns:
- the Componentin which the popup menu is displayed
 
 - 
setInvoker@BeanProperty(bound=false, expert=true, description="The invoking component for the popup menu") public void setInvoker(Component invoker) Sets the invoker of this popup menu -- the component in which the popup menu menu is to be displayed.- Parameters:
- invoker- the- Componentin which the popup menu is displayed
 
 - 
showpublic void show(Component invoker, int x, int y) Displays the popup menu at the position x,y in the coordinate space of the component invoker.- Parameters:
- invoker- the component in whose space the popup menu is to appear
- x- the x coordinate in invoker's coordinate space at which the popup menu is to be displayed
- y- the y coordinate in invoker's coordinate space at which the popup menu is to be displayed
 
 - 
getComponentAtIndex@Deprecated public Component getComponentAtIndex(int i) Deprecated.replaced byContainer.getComponent(int)Returns the component at the specified index.- Parameters:
- i- the index of the component, where 0 is the first
- Returns:
- the Componentat that index
 
 - 
getComponentIndexpublic int getComponentIndex(Component c) Returns the index of the specified component.- Parameters:
- c- the- Componentto find
- Returns:
- the index of the component, where 0 is the first; or -1 if the component is not found
 
 - 
setPopupSize@BeanProperty(description="The size of the popup menu") public void setPopupSize(Dimension d) Sets the size of the Popup window using aDimensionobject. This is equivalent tosetPreferredSize(d).- Parameters:
- d- the- Dimensionspecifying the new size of this component.
 
 - 
setPopupSize@BeanProperty(description="The size of the popup menu") public void setPopupSize(int width, int height) Sets the size of the Popup window to the specified width and height. This is equivalent tosetPreferredSize(new Dimension(width, height)).- Parameters:
- width- the new width of the Popup in pixels
- height- the new height of the Popup in pixels
 
 - 
setSelected@BeanProperty(expert=true, hidden=true, description="The selected component on the popup menu") public void setSelected(Component sel) Sets the currently selected component, This will result in a change to the selection model.- Parameters:
- sel- the- Componentto select
 
 - 
isBorderPaintedpublic boolean isBorderPainted() Checks whether the border should be painted.- Returns:
- true if the border is painted, false otherwise
- See Also:
- setBorderPainted(boolean)
 
 - 
setBorderPainted@BeanProperty(bound=false, description="Is the border of the popup menu painted") public void setBorderPainted(boolean b) Sets whether the border should be painted.- Parameters:
- b- if true, the border is painted.
- See Also:
- isBorderPainted()
 
 - 
paintBorderprotected void paintBorder(Graphics g) Paints the popup menu's border if theborderPaintedproperty istrue.- Overrides:
- paintBorderin class- JComponent
- Parameters:
- g- the- Graphicsobject
- See Also:
- JComponent.paint(java.awt.Graphics),- JComponent.setBorder(javax.swing.border.Border)
 
 - 
getMargin@BeanProperty(bound=false) public Insets getMargin() Returns the margin, in pixels, between the popup menu's border and its containers.- Returns:
- an Insetsobject containing the margin values.
 
 - 
paramStringprotected String paramString() Returns a string representation of thisJPopupMenu. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not benull.- Overrides:
- paramStringin class- JComponent
- Returns:
- a string representation of this JPopupMenu.
 
 - 
getAccessibleContext@BeanProperty(bound=false) public AccessibleContext getAccessibleContext() Gets the AccessibleContext associated with this JPopupMenu. For JPopupMenus, the AccessibleContext takes the form of an AccessibleJPopupMenu. A new AccessibleJPopupMenu instance is created if necessary.- Specified by:
- getAccessibleContextin interface- Accessible
- Overrides:
- getAccessibleContextin class- Component
- Returns:
- an AccessibleJPopupMenu that serves as the AccessibleContext of this JPopupMenu
 
 - 
processMouseEventpublic void processMouseEvent(MouseEvent event, MenuElement[] path, MenuSelectionManager manager) This method is required to conform to theMenuElementinterface, but it not implemented.- Specified by:
- processMouseEventin interface- MenuElement
- Parameters:
- event- a- MouseEventto be processed
- path- the path of the receiving element in the menu hierarchy
- manager- the- MenuSelectionManagerfor the menu hierarchy
- See Also:
- MenuElement.processMouseEvent(MouseEvent, MenuElement[], MenuSelectionManager)
 
 - 
processKeyEventpublic void processKeyEvent(KeyEvent e, MenuElement[] path, MenuSelectionManager manager) Processes a key event forwarded from theMenuSelectionManagerand changes the menu selection, if necessary, by usingMenuSelectionManager's API.Note: you do not have to forward the event to sub-components. This is done automatically by the MenuSelectionManager.- Specified by:
- processKeyEventin interface- MenuElement
- Parameters:
- e- a- KeyEvent
- path- the- MenuElementpath array
- manager- the- MenuSelectionManager
 
 - 
menuSelectionChangedpublic void menuSelectionChanged(boolean isIncluded) Messaged when the menubar selection changes to activate or deactivate this menu. This implements thejavax.swing.MenuElementinterface. OverridesMenuElement.menuSelectionChanged.- Specified by:
- menuSelectionChangedin interface- MenuElement
- Parameters:
- isIncluded- true if this menu is active, false if it is not
- See Also:
- MenuElement.menuSelectionChanged(boolean)
 
 - 
getSubElements@BeanProperty(bound=false) public MenuElement[] getSubElements() Returns an array ofMenuElements containing the submenu for this menu component. It will only return items conforming to theJMenuElementinterface. If popup menu isnullreturns an empty array. This method is required to conform to theMenuElementinterface.- Specified by:
- getSubElementsin interface- MenuElement
- Returns:
- an array of MenuElementobjects
- See Also:
- MenuElement.getSubElements()
 
 - 
getComponentpublic Component getComponent() Returns thisJPopupMenucomponent.- Specified by:
- getComponentin interface- MenuElement
- Returns:
- this JPopupMenuobject
- See Also:
- MenuElement.getComponent()
 
 - 
isPopupTriggerpublic boolean isPopupTrigger(MouseEvent e) Returns true if theMouseEventis considered a popup trigger by theJPopupMenu's currently installed UI.- Parameters:
- e- a- MouseEvent
- Returns:
- true if the mouse event is a popup trigger
- Since:
- 1.3
 
 
- 
 
-