|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference 11g Release 1 (11.1.1.7.2) E13403-10 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
oracle.ide.wizard.Wizard
public abstract class Wizard
The Wizard interface is used to identify a Java class as a Wizard in the context of the Oracle IDE.
The exact mechanism for invocation is up to the Wizard to determine. Some Wizards register a menu label which is used to create a menu item under the "Tools" menu and are invoked when the user selects that menu item. Other Wizards create their own menu item under a different menu (and may even create a new menu). Still other Wizards are available as an icon in the Gallery (File|New).
A Wizards should only implement the Addin
interface if they need to be loaded when the IDE starts up. By default a Wizard
is not loaded until it is requested (normally by the Object Gallery.
If the Wizard returns a non-null String
from the getMenuLabel
method, then registering the Wizard with the WizardManager
will add a menu item under the "Tools" menu. If the Wizard needs to appear in a different menu, then the Wizard needs to implement the Addin
interface, and manually create an oracle.ide.IdeAction
, a JMenuItem
, and add it to the appropriate menu in IdeMainWindow
.
oracle.ide.IdeAction
, IdeMainWindow
, oracle.ide.WizardManager
, Addin
Constructor Summary | |
---|---|
Wizard() |
Method Summary | |
---|---|
javax.swing.Icon |
getIcon() Gets the Icon to use in the Object Gallery. |
static java.lang.String[] |
getLegacyParams(Context context) Gets the array of String from the specified Context that represent the legacy parameters for the Wizard API used by some older Wizard implementations and Wizard launchers. |
java.lang.String |
getLongLabel() Provides a description of the Wizard that appears in the hint text area of the Object Gallery. |
MenuSpec |
getMenuSpecification() Provides the menu specification used by this Wizard. |
abstract java.lang.String |
getShortLabel() Provides the label that represents the Wizard in the Object Gallery. |
java.lang.String |
getToolTipText() The tool tip text to display when the mouse hovers over this Wizard's item in the Object Gallery. |
abstract boolean |
invoke(Context context) Invokes the wizard. |
abstract boolean |
isAvailable(Context context) Called when the sensitivity of the menu item that opens this wizard must be determined. |
static void |
setLegacyParams(Context context, java.lang.String[] params) Sets the String array that represents the legacy parameters for the Wizard API. |
java.lang.String |
toString() Returns a String describing the Wizard. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public Wizard()
Method Detail |
---|
public abstract boolean isAvailable(Context context)
context
- The Context
to use when invoking this Wizard
.true
if the wizard can be invoked, or false
otherwise.public abstract boolean invoke(Context context)
context
- The context of the wizard. All parameters required by the wizard must be set on the context. The wizard may also return values to the caller by setting them into the Context for the caller to retrieve.true
if the invocation was successful, false
if it failed or was canceled.public abstract java.lang.String getShortLabel()
public java.lang.String getLongLabel()
getShortLabel()
.public javax.swing.Icon getIcon()
Icon
to use in the Object Gallery. If this Wizard is not accessed from the Object Gallery, the Wizard should return null
.Icon
to be displayed in the Object Gallery.public java.lang.String getToolTipText()
public java.lang.String toString()
getShortLabel()
.toString
in class java.lang.Object
public static final java.lang.String[] getLegacyParams(Context context)
public static final void setLegacyParams(Context context, java.lang.String[] params)
public MenuSpec getMenuSpecification()
If this Wizard is not invokable from the "Tools" menu, return null
.
|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference 11g Release 1 (11.1.1.7.2) E13403-10 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |