Панели
Идентификатор:
org.eclipse.ui.views
Описание:
Эта точка расширения позволяет определять
дополнительные панели для рабочей среды. Панель - это визуальный компонент внутри страницы рабочей среды. Обычно
она используется для перемещения по иерархической структуре информации (такой, например, как рабочая
область), открытия редактора или отображения свойств активного редактора. Пользователь
может открыть панель с помощью меню Окно > Показать панель или закрыть ее с помощью локальной панели инструментов этой панели.
Для того чтобы упорядочить структуру окна Показать панель, панели необходимо сгруппировать по категориям.
Описание конфигурации:
<!ELEMENT extension (category | view | stickyView)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - полный идентификатор целевой точки расширения
- id - необязательный идентификатор экземпляра расширения
- name - необязательное имя экземпляра расширения
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - уникальное имя, которое будет применяться для идентификации данной категории.
- name - локализованное имя, которое будет использоваться для этой категории в пользовательском интерфейсе
- parentCategory - необязательный путь, состоящий из идентификаторов категорий, разделенных символом
'/'. Благодаря этому можно создавать иерархию категорий.
<!ELEMENT view (description?)>
<!ATTLIST view
id CDATA #REQUIRED
name CDATA #REQUIRED
category CDATA #IMPLIED
class CDATA #REQUIRED
icon CDATA #IMPLIED
fastViewWidthRatio CDATA #IMPLIED
allowMultiple (true | false) >
- id - уникальное имя, которое будет применяться для идентификации данной панели
- name - локализованное имя, которое будет использоваться для этой панели в пользовательском интерфейсе
- category - необязательный атрибут, состоящий из идентификаторов категорий, разделенных символом '/'. Каждая упоминаемая категория должна быть объявлена в соответствующем элементе категории.
- class - полное имя класса, реализующего интерфейс org.eclipse.ui.IViewPart. Для того,
чтобы наследовать функции по умолчанию, обычно создается производный класс класса
org.eclipse.ui.part.ViewPart
- icon - относительное имя значка, который будет связан с данной панелью.
- fastViewWidthRatio - ширина панели, если она будет открываться как быстрая панель (относительно
ширины рабочей области). Должна задаваться числом с плавающей точкой в интервале от 0.05 до 0.95. Если
значение не указано, будет использоваться относительная ширина по умолчанию.
- allowMultiple - флаг, указывающий, разрешается ли создавать несколько экземпляров данной панели с
помощью метода IWorkbenchPage.showView(String id, String secondaryId). Значение по умолчанию - false.
<!ELEMENT description (#PCDATA)>
Необязательный подэлемент, тело которого должно содержать текст краткого описания панели.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
Закрепленная панель, которая будет появляться по умолчанию во всех проекциях окна при его
открытии. Ее начальное расположение определяется атрибутом location, однако, ничто не
запрещает пользователю переместить или закрыть эту панель. Использование этого элемента
приводит к выводу рамки для создаваемой панели, сама панель показана не будет. Обратите
внимание, что этот элемент следует использовать осторожно и только для тех
панелей, которые должны оставаться активными при смене проекций.
Версия 3.0 и выше
- id - идентификатор панели, которую необходимо сделать закрепленной.
- location - необязательный атрибут, задающий расположение закрепленной панели относительно области
редактора. При его отсутствии панель будет пристыкована к области редактора справа.
- closeable - необязательный атрибут, указывающий, может ли панель закрываться. При отсутствии этого
атрибута панель можно закрыть.
- moveable - необязательный атрибут, указывающий, должна ли панель быть подвижной. Если он не
указан, то панель будет подвижной.
Примеры:
Пример точки расширения:
<extension point=
"org.eclipse.ui.views"
>
<category
id=
"com.xyz.views.XYZviews"
name=
"XYZ"
/>
<view
id=
"com.xyz.views.XYZView"
name=
"Панель XYZ"
category=
"com.xyz.views.XYZviews"
class=
"com.xyz.views.XYZView"
icon=
"icons/XYZ.gif"
/>
</extension>
Пример объявления закрепленной панели:
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
Информация об API:
Значение атрибута class должно быть
полным именем класса, реализующего интерфейс. org.eclipse.ui.IViewPart. Обычно при разработке
новой панели создается производный класс для org.eclipse.ui.part.ViewPart.
Предоставляемая реализация:
Платформа Eclipse предоставляет несколько
стандартных панелей, включая Навигатор, Свойства, Схема и Задачи. С точки зрения
пользователя, эти панели неотличимы от любой другой панели, предоставляемой модулями. Все
эти панели можно открыть в субменю "Показать панель" меню "Окно". Позиция панели
постоянна: она сохраняется при закрытии панели и восстанавливается при повторном открытии
панели в одном сеансе. Позиция также сохраняется от сеанса к сеансу.
Copyright (c) 2002, 2005 IBM Corporation и другие.
Все права защищены. Эта программа и сопутствующие материалы распространяются на условиях Eclipse Public License v1.0, поставляемой вместе с продуктом и доступной на Web-сайте
http://www.eclipse.org/legal/epl-v10.html