Мастеры создания

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>

Создает простой объект XYZ и настраивает начальное содержимое

</description>

<selection class=

"org.eclipse.core.resources.IResource"

/>

</wizard>

</extension>

Значение атрибута класса должно представлять собой класс, реализующий org.eclipse.ui.INewWizard. Если мастер создается из окна Создать мастер, то он будет вставлен в уже имеющийся мастер. Если мастер запускается через ярлык (из меню Создать или с помощью кнопки на панели инструментов), то он будет самостоятельным и будет отображаться в отдельном окне диалога.

Рабочая среда поставляется с мастерами для создания пустых ресурсов следующих типов: проект, папка и файл. Эти мастеры зарегистрированы теми же способами, что описаны выше. В некоторых случаях могут поставляться дополнительные мастеры. Это зависит от конкретной установки платформы.