Мастеры содержимого модулей
Идентификатор:
org.eclipse.pde.ui.pluginContent
Описание:
Эта точка расширения предназначена для добавления мастеров, создающих дополнительное содержимое для проектов модулей PDE.
После создания манифестов модулей и других ключевых файлов эти мастеры можно использовать для добавления файлов и расширений к их начальному набору.
Типичная реализация этого мастера добавляет содержимое, основываясь на параметрах шаблона, настроенного пользователем при работе с шаблоном.
Цель этого состоит в том, чтобы получить модуль, выполняющий полезные функции сразу после своего создания (панель, редактор и пр.)
.
Описание конфигурации:
<!ELEMENT extension (wizard*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - полный идентификатор целевой точки расширения
- id - необязательный идентификатор экземпляра расширения
- name - необязательное имя экземпляра расширения
<!ELEMENT wizard (description?)>
<!ATTLIST wizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
category CDATA #IMPLIED
ui-content (true | false) "true"
java (true | false) "true"
rcp (true | false) "false"
pureOSGi (true | false) "false"
requiresActivator (true | false) "false">
- id - уникальное имя, которое будет обозначать данный мастер
- name - локализованное имя, которое будет обозначать данный мастер в пользовательском интерфейсе
- icon - относительный путь к значку, который будет визуально представлять мастер.
- class - полное имя класса, реализующего интерфейс org.eclipse.pde.IPluginContentWizard
- category - необязательный тег, который может использоваться для связи мастеров контента с различными целевыми проектами.
- ui-content - флаг, указывающий, будет ли мастер создавать код, включающий элементы пользовательского интерфейса. Этот флаг задает, какой класс модуля будет выбран (модули с пользовательским интерфейсом расширяют класс
AbstractUIPlugin
, а модули без пользовательского интерфейса - базовый класс Plugin
). Поскольку многие дополнения Eclipse включают компоненты пользовательского интерфейса, по умолчанию значение этого флага - true
.
- java - флаг, указывающий, что мастер добавляет код Java. Поскольку большинство модулей Eclipse содержат код Java, по умолчанию этот атрибут равен
true
. Задайте его равным false
, если
модуль не содержит кода Java (например, документация).
- rcp - (начиная с 3.1) флаг, указывающий, что мастер добавляет код к самостоятельному приложению расширенного клиента. При значении
true
, мастер появится в мастере Создать проект модуля только если пользователь включает опцию Приложение расширенного клиента.
- pureOSGi - Начиная с версии 3.2. Флаг, указывающий, что мастер добавляет код к простому комплекту OSGi. При значении
true
мастер появится в мастере Создать проект модуля только если пользователь выберет создание простого комплекта OSGi.
- requiresActivator - Начиная с версии 3.2. Флаг, указывающий, что мастер добавляет код к классу активатора. При значении
true
мастер появится в мастере Создать проект модуля только если пользователь выберет создание активатора для управления жизненным циклом модуля.
<!ELEMENT description (#PCDATA)>
Краткое описание мастера.
Примеры:
Ниже приведен пример этой точки расширения:
<extension point=
"org.eclipse.pde.ui.pluginContent"
>
<wizard
name=
"Пример модуля генератора контента"
icon=
"icons/content_wizard.gif"
class=
"com.example.xyz.ContentGeneratorWizard"
id=
"com.example.xyz.ExampleContentGenerator"
>
<описание>
Добавляет панель и страницу параметров.
</description>
</wizard>
</extension>
Информация API:
Мастера, подключаемые к этой точка расширения, должны реализовывать интерфейс org.eclipse.pde.ui.IPluginContentWizard
и чаще всего также интерфейс org.eclipse.jface.wizard.Wizard
.
Поставляемая реализация:
PDE предоставляет API для добавления мастером содержимого, основанных на настраиваемых шаблонах. Ряд мастеров, основанных на этих шаблонах, добавляет сам пользовательский интерфейс PDE.
Copyright (c) 2004 IBM Corporation and others.
Все права защищены.
Эта программа и сопутствующие материалы распространяются на условиях Eclipse Public License v1.0, поставляемой вместе с продуктом и доступной на Web-сайте http://www.eclipse.org/legal/epl-v10.html.