package jas2.plugin;
import java.awt.Component;

/**
 * A PageContext allows a plugin to manipulate a page it has installed into the 
 * Java Analysis Application, as well as to receive events notifing the plugin
 * of user initiated changes to the page,
 *
 * @see Plugin#installPage(String,Component)
 */

public interface PageContext
{
	/**
	 * Add a page listener to receive notifications of user initiated changes
	 *
	 * @param listener The PageListener to install
	 */
	void addPageListener(PageListener listener);
	/**
	 * Remove a previously installed PageListener
	 *
	 * @param listener The PageListener to remove
	 */
	void removePageListener(PageListener listener);
	/**
	 * Requests that the associated page be shown
	 * If the page is iconized it is deiconized, and bought to the top
	 */
	void requestShow();
	/**
	 * Closes the associated window
	 */
	void close();
	/**
	 * Get the component associated with this page
	 */
	Component getPage();
	/**
	 * The name associated with the page
	 */
	String getPageName();
}