org.fife.ui.app
Interface Plugin

All Known Implementing Classes:

GUIPlugin, MacroPlugin, Plugin, Plugin, Plugin, StatusBarPlugin, TasksPlugin, ToolPlugin, WizardPlugin

public interface Plugin

A "plugin" in a GUI application is a class that extends that application in some way. There are several base classes of plugins that you can subclass to make a plugin for your application, including:

• GUIPlugin is an actual GUI panel containing widgets, etc., and is either docked on one of the four sides of the main window or in its own floating window.
• StatusBarPlugin is a widget added to the application's status bar.
• WizardPlugin is a series of dialogs that guides the user through some process.

Version:

0.1

Author:

Robert Futrell

See Also:

GUIApplication, GUIPlugin, StatusBarPlugin, WizardPlugin

Method Summary

PluginOptionsDialogPanel	getOptionsDialogPanel() Returns an options panel for use in an Options dialog.
java.lang.String	getPluginAuthor() Returns the author of the plugin.
javax.swing.Icon	getPluginIcon() Returns the icon to display beside the name of this plugin in the application's interface.
java.lang.String	getPluginName() Returns the name of the plugin.
java.lang.String	getPluginVersion() Returns the version of the plugin.
void	install(AbstractPluggableGUIApplication app) Called just after a plugin is added to a GUI application.
void	savePreferences() Called when the GUI application is shutting down.
boolean	uninstall() Called just before this Plugin is removed from an GUIApplication.

Method Detail

getOptionsDialogPanel

public PluginOptionsDialogPanel getOptionsDialogPanel()

Returns an options panel for use in an Options dialog. This panel should contain all options pertaining to this plugin.

Returns:

The options panel.

getPluginAuthor

public java.lang.String getPluginAuthor()

Returns the author of the plugin.

Returns:

The author.

getPluginIcon

public javax.swing.Icon getPluginIcon()

Returns the icon to display beside the name of this plugin in the application's interface.

Returns:

The icon for this plugin. This value may be null to represent no icon.

getPluginName

public java.lang.String getPluginName()

Returns the name of the plugin.

Returns:

The plugin name.

getPluginVersion

public java.lang.String getPluginVersion()

Returns the version of the plugin.

Returns:

The version number of this plugin.

install

public void install(AbstractPluggableGUIApplication app)

Called just after a plugin is added to a GUI application. If this is a GUIPlugin, it has already been added visually. Plugins should use this method to register any listeners to the GUI application and do any other necessary setup.

Parameters:

app - The application to which this plugin was just added.

See Also:

uninstall()

savePreferences

public void savePreferences()

Called when the GUI application is shutting down. When this method is called, the Plugin should save any preferences.

uninstall

public boolean uninstall()

Called just before this Plugin is removed from an GUIApplication. This gives the plugin a chance to clean up any loose ends (kill any threads, close any files, remove listeners, etc.).

Returns:

Whether the uninstall went cleanly.

See Also:

install(org.fife.ui.app.AbstractPluggableGUIApplication)