APIdia Launch Partner
Top Description Methods
javax.swing

public Interface MenuElement

Known Direct Implementers
javax.swing.JMenu, javax.swing.JMenuBar, javax.swing.JMenuItem, javax.swing.JPopupMenu
Imports
java.awt.*, java.awt.event.*

Any component that can be placed into a menu should implement this interface. This interface is used by MenuSelectionManager to handle selection and navigation in menu hierarchies.
Author
Arnaud Weber
Since
1.2

Method Summary

Modifier and TypeMethod and Description
public Component

Returns:

the Component value
getComponent
()

This method should return the java.awt.Component used to paint the receiving element.

public MenuElement[]

Returns:

an array of MenuElements
getSubElements
()

This method should return an array containing the sub-elements for the receiving menu element.

public void
processKeyEvent(KeyEvent
a KeyEvent to be processed
event
,
MenuElement[]
the path of the receiving element in the menu hierarchy
path
,
MenuSelectionManager
the MenuSelectionManager for the menu hierarchy
manager
)

Process a key event.

public void
processMouseEvent(MouseEvent
a MouseEvent to be processed
event
,
MenuElement[]
the path of the receiving element in the menu hierarchy
path
,
MenuSelectionManager
the MenuSelectionManager for the menu hierarchy
manager
)

Processes a mouse event.

Method Detail

getComponentback to summary
public 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:Component

the Component value

getSubElementsback to summary
public MenuElement[] getSubElements()

This method should return an array containing the sub-elements for the receiving menu element.

Returns:MenuElement[]

an array of MenuElements

processKeyEventback to summary
public void processKeyEvent(KeyEvent event, MenuElement[] path, MenuSelectionManager manager)

Process a key event.

Parameters
event:KeyEvent

a KeyEvent to be processed

path:MenuElement[]

the path of the receiving element in the menu hierarchy

manager:MenuSelectionManager

the MenuSelectionManager for the menu hierarchy

processMouseEventback to summary
public void processMouseEvent(MouseEvent event, MenuElement[] path, MenuSelectionManager manager)

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

Parameters
event:MouseEvent

a MouseEvent to be processed

path:MenuElement[]

the path of the receiving element in the menu hierarchy

manager:MenuSelectionManager

the MenuSelectionManager for the menu hierarchy