Точка расширения org.eclipse.ui.preferencePages позволяет добавлять страницы в окно общих параметров (Окно->Параметры). Окно параметров содержит упорядоченный список записей параметров пользователя. При выборе каждой записи открывается соответствующая страница параметров.
Утилита readme использует данную точку расширения для добавления страницы параметров Readme Example.
<extension point = "org.eclipse.ui.preferencePages"> <page id="org.eclipse.ui.examples.readmetool.Page1" class="org.eclipse.ui.examples.readmetool.ReadmePreferencePage" name="%PreferencePage.name"> </page> </extension>
Этот пример кода определяет страницу параметров с именем "Readme Example", которая используется в классе ReadmePreferencePage. Данный класс должен применять интерфейс IWorkbenchPreferencePage.
Используя базовые механизмы, рабочая среда получает доступ ко всем узлам в дереве параметров и соответствующим страницам. Список формируется на основе информации в службе параметров и не требует выполнения какого-либо кода.
Параметр "Readme Example" добавляется на самый верхний уровень дерева параметров слева. Почему? Потому что страница параметров всегда добавляется в корень дерева, если не указан атрибут category. (Название атрибута category (категория) не соответствует его назначению. Возможно, лучше было назвать этот атрибут путь.) Атрибут category указывает идентификатор (или последовательность идентификаторов от корневого субъекта) родительской страницы. Например, следующий пример кода создает вторую страницу параметров утилиты readme, "Readme Example Child Page," в виде дочерней страницы.
<extension point = "org.eclipse.ui.preferencePages"> <page id="org.eclipse.ui.examples.readmetool.Page1" class="org.eclipse.ui.examples.readmetool.ReadmePreferencePage" name="%PreferencePage.name"> </page> <page id="org.eclipse.ui.examples.readmetool.Page2" class="org.eclipse.ui.examples.readmetool.ReadmePreferencePage2" name="Readme Example Child Page" category="org.eclipse.ui.examples.readmetool.Page1> </page> </extension>
Когда пользователь выбирает в дереве запись для страницы параметров, рабочая среда создает и отображает страницу параметров, используя класс, указанный в определении расширения. Это действие активирует модуль (если он еще не активирован в результате другой операции пользователя).