描述:此扩展点用来注册资源创建向导扩展。创建向导出现为“新建对话框”内的选项,通常用来创建新项目、新文件夹和新文件。
在“新建对话框”中,将向导组织成一些通常反映特定问题域的类别。例如,面向 Java 的插件可定义一个名为“Java”的类别,该类别适用于“类”或“包”创建向导。一个插件定义的类别可由其他插件使用 category 属性来引用。未分类别的向导以及具有无效类别路径的向导将放在“其他”类别中。
向导可选择指定其主体应包含有关向导的简短文本的描述子元素。
配置标记:
<!ELEMENT category EMPTY>
<!ATTLIST category
id
CDATA #REQUIRED
name
CDATA #REQUIRED
parentCategory CDATA #IMPLIED
>
下面是创建向导配置的一个示例:
<extension point="org.eclipse.ui.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 信息:class 属性的值必须表示实现 org.eclipse.ui.INewWizard 的类。如果从“新向导”中创建了向导, 则会将它插入到现有的向导中。如果作为快捷方式启动了向导(从“文件” -> “新建”菜单或从工具栏按钮),向导将作为独立的对话框单独出现。
finalPerspective 属性标识当在向导类内完成 IProject 资源创建时要激活的透视图。此透视图的激活应根据 IWorkbenchPreferenceConstants.PROJECT_OPEN_NEW_PERSPECTIVE 定义的工作台首选项来解释。这可能意味着“在新窗口中打开”、“在当前窗口中打开”、“替换当前透视图”或“不执行任何操作”。这只是一个提示,但鼓励开发者阅读并激活该提示,或者他们可调用 api BasicNewProjectResourceWizard#updatePerspective(IConfigurationElement) 来为他们完成这些工作。
提供的实现:向导附带的工作台用来创建下列类型的空资源:项目、文件夹和文件。这些向导是使用上述的机制注册的。其他向导也可能会出现,并遵从特定的平台安装规则。