生成ウィザード

ID: org.eclipse.ui.newWizards

説明: この拡張ポイントは、リソース生成ウィザード拡張機能を登録するために 使用します。 作成ウィザードは、「新規」ダイアログの選択項目として表示され、一般にフォルダーおよびファイルの 作成に使用されます。

「新規」ダイアログで、ウィザードは、通常、特定の問題ドメインを反映するカテゴリーに編成されます。 たとえば、Java 指向のプラグインは、クラスまたはパッケージ作成ウィザードに適した、"Java" と呼ばれるカテゴリーを定義することができます。 あるプラグインによって定義されているカテゴリーは、category 属性を使用してその他のプラグインによって参照できます。 カテゴリー化されていないウィザード、および無効なカテゴリー・パスを持つウィザードは、 "Other" カテゴリーに含まれることになります。

ウィザードでは、オプションで、ウィザードに関する簡略テキストを本文に含む記述サブエレメントを 指定することができます。

構成マークアップ:

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

   an optional subelement whose body contains a short text describing what the wizard will do when started

   <!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 情報: 属性の値は、org.eclipse.ui.INewWizard をインプリメントするクラスを表す必要があります。 ウィザードが「新規ウィザード」内で作成された場合、これは既存のウィザードに挿入されます。 ウィザードがショートカットとして起動 (「ファイル」の「新規」またはツールバー・ボタンを使用)、された場合、 これは個別の独立したダイアログ・ボックスとして表示されます。

提供されるインプリメンテーション: ワークベンチには、プロジェクト、フォルダー、 およびファイルのタイプの空リソースを作成するウィザードが提供されています。 これらのウィザードは、上記のメカニズムと同様のメカニズムにより登録されています。 また、特定のプラットフォームのインストールに伴って、追加ウィザードを表示することもできます。

Copyright (c) 2002, 2003 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Common Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/cpl-v10.html