Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.

Copyright © 2006 Sun Microsystems, Inc. All rights reserved.

JSR-209 (Final Approval Ballot)

javax.swing
Interface MenuElement

All Known Implementing Classes:
JMenu, JMenuBar, JMenuItem, JPopupMenu

public interface MenuElement

Any component that can be placed into a menu should implement this interface. This interface is used by MenuSelection to handle selection and navigation in menu hierarchies.


Method Summary
 java.awt.Component getComponent()
          This method should return the java.awt.Component used to paint the receiving element.
 MenuElement[] getSubElements()
          This method should return an array containing the sub-elements for the receiving menu element
 void menuSelectionChanged(boolean isIncluded)
          Call by the MenuSelection when the MenuElement is added or remove from the menu selection.
 void processKeyEvent(java.awt.event.KeyEvent event, MenuElement[] path, MenuSelectionManager manager)
          Process a key event.
 void processMouseEvent(java.awt.event.MouseEvent event, MenuElement[] path, MenuSelectionManager manager)
          Process a mouse event.
 

Method Detail

processMouseEvent

public void processMouseEvent(java.awt.event.MouseEvent event,
                              MenuElement[] path,
                              MenuSelectionManager manager)
Process a mouse event. event is a MouseEvent with source being the receiving element's component. path is the path of the receiving element in the menu hierarchy including the receiving element itself. manager is the MenuSelectionManager for the menu hierarchy. This method should process the MouseEvent and change the menu selection if necessary by using MenuSelectionManager's API Note: you do not have to forward the event to sub-components. This is done automatically by the MenuSelectionManager


processKeyEvent

public void processKeyEvent(java.awt.event.KeyEvent event,
                            MenuElement[] path,
                            MenuSelectionManager manager)
Process a key event.


menuSelectionChanged

public void menuSelectionChanged(boolean isIncluded)
Call by the MenuSelection when the MenuElement is added or remove from the menu selection.


getSubElements

public MenuElement[] getSubElements()
This method should return an array containing the sub-elements for the receiving menu element

Returns:
an array of MenuElements

getComponent

public java.awt.Component getComponent()
This method should return the java.awt.Component used to paint the receiving element. The returned component will be used to convert events and detect if an event is inside a MenuElement's component.

Returns:
the Component value

JSR-209 (Final Approval Ballot)

Copyright © 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.

For more information, please consult the JSR 209 specification.