创建向导

标识:org.eclipse.ui.newWizards

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

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

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

配置标记:

   <!ELEMENT extension (category | wizard)*>

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

   <!ELEMENT description (#CDATA)>

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

   <!ELEMENT selection EMPTY>

   <!ATTLIST selection
     class CDATA #REQUIRED
     name  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> 
           <selection class="org.eclipse.core.resources.IResource"/>
      </wizard>
   </extension> 

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

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

Copyright (c) 2002, 2003 IBM Corporation and others. All rights reserved. 该程序及附带提供的资料是基于“一般公共许可证”(Common Public License) v1.0 的条款提供的,本发行版中提供了该许可证条款,并且也可 在以下位置处找到该条款:http://www.eclipse.org/legal/cpl-v10.htm