建立精靈

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>

這個工具的目的,是宣告精靈「主要」是位於 UI 中。 主要精靈主要是位於新的精靈對話框中。 請注意,這個元素不是專供外掛程式開發人員所用!這個元素的用途,是讓產品管理程式強調產品的一組精靈。



下面是建立精靈配置的範例:

   

<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 的類別。如果精靈是從「新建精靈」內建立的,它會插入現有的精靈中。 如果精靈是當作捷徑來啟動(從「檔案 - 新建」功能表或工具列按鈕),就會以個別的對話框單獨出現。

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