Расширения проекций
Идентификатор:
org.eclipse.ui.perspectiveExtensions
Описание:
Эта точка расширения служит для расширения проекций, зарегистрированных другими модулями. Проекции определяют начальное содержимое панелей действий окна (меню и панель инструментов) и начальный набор панелей и их макетов на странице рабочей среды.
Другие модули могут дополнять действия или панели в проекции. Эти действия отобразятся при выборе данной проекции. Необязательные дополнения от других модулей присоединяются к начальному определению.
Описание конфигурации:
<!ELEMENT extension (perspectiveExtension*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - полный идентификатор целевой точки расширения
- id - необязательный идентификатор экземпляра расширения
- name - необязательное имя экземпляра расширения
<!ELEMENT perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID - уникальный идентификатор проекции (как указано в реестре), в которую что-либо добавляется.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - уникальный идентификатор набора действий, добавляемого в проекцию.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - уникальный идентификатор панели, которая добавляется в подменю проекции "Показать панель" меню "Окно".
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - уникальный идентификатор проекции, которая добавляется в подменю проекции "Открыть проекцию" меню "Окно".
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - уникальный идентификатор нового мастера, который добавляется в подменю проекции "Создать" меню "Файл".
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - уникальный идентификатор новой панели, которая добавляется в пункт "Открыть в ..." меню Перейти.
<!ELEMENT view EMPTY>
<!ATTLIST view
id CDATA #REQUIRED
relative CDATA #IMPLIED
relationship (stack|left|right|top|bottom|fast)
ratio CDATA #IMPLIED
visible (true | false)
closeable (true | false)
moveable (true | false)
standalone (true | false)
showTitle (true | false) >
- id - уникальный идентификатор панели, которая добавляется в макет проекции.
- relative - уникальный идентификатор существующей панели в проекции. Он служит базовой точкой для размещения панели. Взаимоотношения двух панелей определяются с помощью relationship. Игнорируется если оно равно "fast".
- relationship - задает отношения между id и relative.
Поддерживаются следующие значения:
fast - расширение панели создается как быстрая панель.
stack - расширение панели вместе с самой панелью помещается в блокнот панелей.
left, right, top, bottom - расширение панели располагается рядом с самой панелью. В этом случае следует определить атрибут ratio.
- ratio - доля области (в процентах) связанной панели, которая передается расширению панели. Если расширение панели является быстрой панелью, то ratio - это процент рабочей среды, который займет активная быстрая панель. Коэффициент определяется как число с плавающей точкой в диапазоне между 0,05 и 0,95.
- visible - задает, будет ли панель видимой сразу после открытия проекции. Этот атрибут должен принимать значения "true" или "false".
Если этот атрибут не указан, то по умолчанию панель изначально видима.
- closeable - задает, можно ли будет закрыть панель в целевой проекции. Этот атрибут должен принимать значения "true" или "false".
Если этот атрибут не используется, то панель будет закрываемой, если сама проекция не помечена как фиксированная.
- moveable - задает, будет ли панель перемещаемой. Неперемещаемую панель нельзя переместить ни в пределах одной папки, ни между двумя папками проекции. Этот атрибут должен принимать значения "true" или "false".
Если этот атрибут не используется, то панель будет перемещаемой, если сама проекция не помечена как фиксированная.
- standalone - задает, будет ли панель автономной. Автономную панель нельзя состыковать с другими панелями той же папки. Этот атрибут должен принимать значения "true" или "false".
Если значение атрибута relationship равно "fast" или "stacked", то атрибут standalone игнорируется. Если этот атрибут не указан, то панель будет обычной, не автономной (по умолчанию стоит значение "false").
- showTitle - задает, будет ли показан заголовок панели. Этот атрибут должен принимать значения "true" или "false".
Атрибут применим только к автономным панелям. Если он не указан, то заголовок панели будет отображаться (значение по умолчанию равно "true").
Примеры:
Ниже приведен пример расширения проекции (обратите внимание, что используются подэлементы и атрибуты пути):
<extension point=
"org.eclipse.ui.perspectiveExtensions"
>
<perspectiveExtension
targetID=
"org.eclipse.ui.resourcePerspective"
>
<actionSet id=
"org.eclipse.jdt.ui.JavaActionSet"
/>
<viewShortcut id=
"org.eclipse.jdt.ui.PackageExplorer"
/>
<newWizardShortcut id=
"org.eclipse.jdt.ui.wizards.NewProjectCreationWizard"
/>
<perspectiveShortcut id=
"org.eclipse.jdt.ui.JavaPerspective"
/>
<view id=
"org.eclipse.jdt.ui.PackageExplorer"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"stack"
/>
<view id=
"org.eclipse.jdt.ui.TypeHierarchy"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"left"
ratio=
"0.50"
/>
</perspectiveExtension>
</extension>
В этом примере набор действий, ярлык панели, ярлык мастера создания и ярлык проекции добавляются в начальное содержимое панели Ресурсы. Кроме этого, панель Структура пакетов вложена в Навигатор ресурсов, а панель Иерархия типов добавлена рядом с Навигатором ресурсов.
Информация об API:
Элементы, определенные в расширении проекции, добавляются в начальное содержимое целевой проекции. Следовательно, пользователь может удалить любое дополнение из проекции или добавить в нее что-то свое из пользовательского интерфейса рабочей среды.
Copyright (c) 2002, 2004 IBM Corporation and others.
Все права защищены.
Эта программа и сопутствующие материалы распространяются на условиях Eclipse Public License v1.0, поставляемой вместе с продуктом и доступной на Web-сайте
http://www.eclipse.org/legal/epl-v10.html