建立精靈

識別碼: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. 這個程式和伴隨的素材可以根據伴隨這個分送,而且可在 http://www.eclipse.org/legal/cpl-v10.html 中取得的 Common Public License v1.0 的條款來使用