建立精靈

識別碼: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>
             建立一個簡單 XYZ 成品及設定起始內容
          </description>
      </wizard>
   </extension>

API 資訊class 屬性值必須代表實作 org.eclipse.ui.INewWizard 的類別。 如果精靈是從「新建精靈」內建立的,它會插入現有的精靈中。 如果精靈是當作捷徑來啟動(從「檔案 - 新建」功能表或工具列按鈕),就會成為獨立的對話框。

finalPerspective 屬性指出當在精靈類別建立好 IProjet 資源時所要啟動的視景。 這個視景的啟動應該根據 IWorkbenchPreferenceConstants.PROJECT_OPEN_NEW_PERSPECTIVE 所定義的工作台喜好設定來解譯。 這可能表示「開啟在新視窗中」、「開啟在現行視窗中」、「取代現行視景」或「不執行任何動作」。 這只是一個提示,但開發人員最好要閱讀及啟動提示,或者也可以呼叫會自動作業的 api BasicNewProjectResourceWizard#updatePerspective(IConfigurationElement)。

提供的實作:工作台檢附用來建立下列類型之空資源的精靈:專案、資料夾和檔案。 這些精靈是利用上述相同機制來登錄的。 視特定平台安裝架構而定,也可能會出現其它精靈。

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