Description: This extension point is used to register resource creation wizard extensions. Creation wizards appear as choices within the "New Dialog", and are typically used to create new projects, folders and files.
In the "New Dialog", wizards are organized into categories which usually reflect a particular problem domain. For instance, a Chart oriented plugin may define a category called "Charts" which is appropriate for "Bar Chart" or "Line Chart" creation wizards. The categories defined by one plug-in can be referenced by other plug-ins using the category attribute. Uncategorized wizards, as well as wizards with invalid category paths, will end up in an "Other" category.
Wizards may optionally specify a description subelement whose body should contain short text about the wizard.
<!ELEMENT category EMPTY> <!ATTLIST category id CDATA #REQUIRED name CDATA #REQUIRED parentCategory CDATA #IMPLIED >
<!ELEMENT wizard (description)?> <!ATTLIST wizard id CDATA #REQUIRED name CDATA #REQUIRED icon CDATA #IMPLIED category CDATA #IMPLIED class CDATA #REQUIRED project (true | false) #IMPLIED finalPerspective CDATA #OPTIONAL > <!ELEMENT description (#PCDATA)>
<!ELEMENT selection EMPTY> <!ATTLIST selection class CDATA #REQUIRED name CDATA #OPTIONAL >
Following is an example of creation wizard configuration:
<extension point="org.jlense.uiworks.newWizards"> <category id="com.xyz.XYZ" name="XYZ Wizards"> </category> <category id="com.xyz.XYZ.Web" name="Web Wizards" parentCategory="com.xyz.XYZ"> </category> <wizard id="com.xyz.wizard1" name="XYZ artifact" category="com.xyz.XYZ/com.xyz.XYZ.Web" icon="./icons/XYZwizard1.gif" class="com.xyz.XYZWizard1"> <description> Create a simple XYZ artifact and set initial content </description> </wizard> </extension>
API Information: The value of the class attribute must represent a class that implements org.jlense.uiworks.workbench.INewWizard. If the wizard is created from within the New Wizard it will be inserted into the existing wizard. If the wizard is launched as a shortcut (from the File New menu or a toolbar button) it will appear standalone as a separate dialog box.
The finalPerspective attribute identifies a perspective to activate when IProject resource creation is finished within the wizard class. The activation of this perspective should be interpreted according to the workbench preference defined by IWorkbenchPreferenceConstants.PROJECT_OPEN_NEW_PERSPECTIVE. This may mean "open in a new window", "open in the current window", "replace the current perspective", or "do nothing". This is only a hint, but developers are encouraged to read and activate the hint, or they can call the api BasicNewProjectResourceWizard#updatePerspective(IConfigurationElement) which will do the work for them.