创建向导

标识符:org.eclipse.ui.newWizards

描述:此扩展点用来注册资源创建向导扩展。创建向导出现为“新建对话框”内的选项,通常用来创建新项目、新文件夹和新文件。

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

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

配置标记:

   <!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
   > 示例:

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

   <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) 来为他们完成这些工作。

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

Copyright IBM Corp. 2000, 2001.  All Rights Reserved.