package bluej.extmgr;

import javax.swing.JMenuItem;

import bluej.extensions.MenuGenerator;




| This interface provides methods for retrieving custom menu entries of an
| extension and to notify it if a menu is about to show. Implementations of
| this interface serve as a bridge between BlueJ and the extension mechanism.
|
| @author Simon Gerlach
|
public interface ExtensionMenu
{       



| Calls the extension to get a menu item.
|
| @param menuGenerator
|            The {}link MenuGenerator} which creates the menu.
| @return The {}link JMenuItem} the extension provides or <code>null</code>
|         if it does not provide a menu entry.
|
p.public JMenuItem getMenuItem(MenuGenerator menuGenerator);

   
   


| Post a notification about a menu going to be displayed.
|
| @param menuGenerator
|            The {}link MenuGenerator} which creates the menu.
| @param onThisItem
|            The {}link JMenuItem} which is about to show.
|
p.public void postMenuItem(MenuGenerator menuGenerator, JMenuItem onThisItem); 
   }