Страницы предпочтений
Идентификатор:
org.eclipse.ui.preferencePages
Описание:
Рабочая среда предоставляет одно
общее окно для выбора предпочтений. Данная точка расширения позволяет модулям добавлять
страницы в это окно. Если окно предпочтений открыто (из строки меню), то добавляемые таким образом страницы
будут помещаться в это окно.
Окно предпочтений позволяет группировать страницы, создавая для иерархическую структуру. Поэтому для страницы
можно дополнительно указывать атрибут category. Этот атрибут задает путь,
состоящий из идентификаторов родительских страниц, разделенных символом '/'. Если путь
отсутствует, или невозможно найти какой-либо из родительских узлов, страница добавляется
на корневой уровень.
Описание конфигурации:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - полный идентификатор целевой точки расширения
- id - необязательный идентификатор экземпляра расширения
- name - необязательное имя экземпляра расширения
<!ELEMENT page (keywordReference*)>
<!ATTLIST page
id CDATA #REQUIRED
name CDATA #REQUIRED
class CDATA #REQUIRED
category CDATA #IMPLIED>
- id - уникальное имя, применяемое для идентификации данной страницы.
- name - локализованное имя, которое будет применяться для этой страницы в
пользовательском интерфейсе.
- class - имя полностью определенного класса, реализующего
org.eclipse.ui.IWorkbenchPreferencePage.
- category - путь, указывающий расположение страницы в дереве предпочтений. Путь
может быть или идентификатором родительского узла, или набором идентификаторов,
разделенных символом '/', представляющим полный путь от корневого узла.
<!ELEMENT keywordReference EMPTY>
<!ATTLIST keywordReference
id CDATA #REQUIRED>
Ссылка на ключевое слово. См. точку расширения ключевых слов.
- id - идентификатор ключевого слова, на которое ссылается страница предпочтений
Примеры:
Ниже приведен пример точки
расширения окна выбора предпочтений:
<extension
point=
"org.eclipse.ui.preferencePages"
>
<page
id=
"com.xyz.prefpage1"
name=
"XYZ"
class=
"com.xyz.prefpages.PrefPage1"
>
<keywordReference id=
"xyz.Keyword"
/>
</page>
<page
id=
"com.xyz.prefpage2"
name=
"Keyboard Settings"
class=
"com.xyz.prefpages.PrefPage2"
category=
"com.xyz.prefpage1"
>
</page>
</extension>
Информация об API:
Значение атрибута class
должно представлять полное имя класса, реализующего
org.eclipse.ui.IWorkbenchPreferencePage.
Предоставляемая реализация:
Рабочая среда
добавляет несколько страниц для настройки параметров платформы. После них будут добавляться страницы,
зарегистрированные с помощью данного расширения, в порядке, определенном информацией о их категории.
Copyright (c) 2002, 2005 IBM Corporation и другие.
Все права защищены. Эта программа и сопутствующие материалы распространяются на условиях Eclipse Public License v1.0, поставляемой вместе с продуктом и доступной на Web-сайте
http://www.eclipse.org/legal/epl-v10.html