创建向导

org.eclipse.ui.newWizards

此扩展点用来注册资源创建向导扩展。创建向导作为“新建对话框”中的选项出现,该向导通常用于创建文件夹和文件。

在“新建对话框”中,向导被组织成一些通常反映特定问题域的类别。例如,面向 Java 的插件可定义一个名为“Java”的类别,该类别适用于“类”或“包”创建向导。一个插件定义的类别可以由其它插件使用 category 属性来引用。未分类别的向导以及具有无效类别路径的向导将放在“其它”类别中。

向导可选择指定其主体应包含有关向导的简短文本的描述子元素。

<!ELEMENT extension (category | wizard | primaryWizard)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT category EMPTY>

<!ATTLIST category

id             CDATA #REQUIRED

name           CDATA #REQUIRED

parentCategory CDATA #IMPLIED>


<!ELEMENT wizard (description? , selection*)>

<!ATTLIST wizard

id                    CDATA #REQUIRED

name                  CDATA #REQUIRED

icon                  CDATA #IMPLIED

category              CDATA #IMPLIED

class                 CDATA #REQUIRED

project               (true | false)

finalPerspective      CDATA #IMPLIED

preferredPerspectives CDATA #IMPLIED

helpHref              CDATA #IMPLIED

descriptionImage      CDATA #IMPLIED

canFinishEarly        (true | false)

hasPages              (true | false) >


<!ELEMENT description (#PCDATA)>

一个可选子元素,其主体包含一个描述启动向导时向导所执行的操作的简短文本



<!ELEMENT selection EMPTY>

<!ATTLIST selection

class CDATA #REQUIRED

name  CDATA #IMPLIED>


<!ELEMENT primaryWizard EMPTY>

<!ATTLIST primaryWizard

id CDATA #REQUIRED>

声明一个向导在用户界面中是“主”向导的方法。主向导在新的向导对话框中是突出显示的。请注意,不打算让插件开发者使用此元素!有了此元素,产品经理就可以对他们的产品着重使用一组向导。



以下是创建向导配置的一个示例:

   

<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>

<selection class=

"org.eclipse.core.resources.IResource"

/>

</wizard>

</extension>

class 属性的值必须表示实现 org.eclipse.ui.INewWizard 的类。如果向导是从“新建向导”中创建的,则会将它插入到现有的向导中。如果向导是作为快捷方式启动的(从“文件”“新建”菜单或从工具栏按钮),则它将作为独立的对话框单独出现。

工作台附带提供了用来创建下列类型的空资源的向导:项目、文件夹和文件。这些向导是使用上述相同机制注册的。随特定的平台安装不同,也可能会出现其它向导。