Страницы поиска
Идентификатор:
org.eclipse.search.searchPages
Описание:
Эта точка расширения
позволяет модулю регистрировать страницы поиска для специализированных
вариантов поиска. Когда выполняется действие поиска ресурса,
инфраструктура поиска находит наиболее подходящую зарегистрированную
страницу поиска.
Описание конфигурации:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - полный идентификатор целевой точки расширения
- id - необязательный идентификатор экземпляра расширения
- name - необязательное имя экземпляра расширения
<!ELEMENT page EMPTY>
<!ATTLIST page
id CDATA #REQUIRED
label CDATA #REQUIRED
class CDATA #REQUIRED
icon CDATA #IMPLIED
sizeHint CDATA #IMPLIED
tabPosition CDATA #IMPLIED
extensions CDATA #IMPLIED
searchViewHelpContextId CDATA #IMPLIED
showScopeSection (true | false)
enabled (true | false)
canSearchEnclosingProjects (true | false) >
- id - уникальное имя, которое будет обозначать данную страницу
поиска
- label - удобочитаемая метка, которая будет показана на вкладке
страницы поиска
- class - имя класса, реализующего
org.eclipse.search.ui.ISearchPage. Рекомендуется производный
класс org.eclipse.jface.dialogs.DialogPage.
- icon - относительное имя изображения, которое будет использовано
для всех ресурсов, соответствующих указанным расширениям. Если атрибут не
задан, то вкладка страницы поиска будет содержать только метку.
- sizeHint - подсказка с предлагаемым начальным размером
страницы. Это строка со значениями ширины и высоты, разделенными запятой
(например, "50, 60"). Если подсказка опущена, то страница не будет
превышать по размеру другие страницы.
- tabPosition - целое число, определяющее место размещения
страницы в книге страниц. Это не абсолютная позиция, а позиция
относительно других страниц. Страницы располагаются в следующем порядке:
-
если позиция вкладки не задана ни в одной из страниц, то они
упорядочиваются по алфавиту согласно своим меткам
-
если позиция вкладки задана в обеих страницах, то сначала размещается
страница с меньшим значением. Если эти значения равны, то страницы
упорядочиваются так, как если бы значений не было (см. 1)
-
если позиция вкладки задана только в одной странице, то сначала
размещается эта страница
- extensions - перечисленные через запятую расширения файлов, к
которым применима эта страница поиска. Каждому расширению может быть также
присвоен вес (0 означает наименьший вес), что позволяет инфраструктуре
поиска искать наиболее подходящую страницу. Вес отделяется от расширения
двоеточием. Если для страницы поиска считаются допустимыми все ресурсы,
можно указать символ "*".
- searchViewHelpContextId - необязательный ИД контекста справки
для панели Поиск, в которой показаны результаты этой страницы. Если этот
атрибут отсутствует, то используется ИД контекста справки для поиска,
применяемый по умолчанию
(org.eclipse.search.search_view_context).
- showScopeSection - если этот атрибут отсутствует или равен
"false", то раздел диапазонов поиска не будет показан в окне Поиск. Для
того чтобы увидеть раздел диапазонов поиска, необходимо присвоить этому
атрибуту значение "true". Модули, которые добавляют свою страницу Поиск и
которым требуется видеть раздел диапазонов поиска, должны добавить этот
атрибут в свой файл plugin.xml.
- enabled - если этот атрибут отсутствует или равен "false", то
первоначально страница не будет показана в окне Поиск. Для активации
страницы пользователь должен будет нажать кнопку "Настроить..." в окне
Поиск.
- canSearchEnclosingProjects - если этот атрибут отсутствует или
равен "false", то диапазон поиска "Окружающие проекты" не будет показан в
разделе диапазонов поиска в окне Поиск. Если атрибут "showScopeSection"
отсутствует или равен "false", то данный атрибут игнорируется.
Примеры:
Ниже приведен
пример определения расширения страницы поиска:
<extension point=
"org.eclipse.search.searchPages"
>
<page
id=
"org.eclipse.search.ui.text.TextSearchPage"
label=
"Текстовый поиск"
icon=
"icons/full/obj16/tsearch_pref.gif"
sizeHint=
"250,160"
tabPosition=
"1"
extensions=
"*:1"
showScopeSection=
"true"
class=
"org.eclipse.search.ui.text.TextSearchPage"
>
</page>
</extension>
Информация API:
Добавляемый
класс должен реализовывать org.eclipse.search.ui.ISearchPage
Поставляемая реализация:
Инфраструктура поиска предоставляет страницу поиска для поиска по всему
тексту.
Copyright (c) 2001, 2004 IBM Corporation and others.
Все права защищены. Эта программа и сопутствующие материалы распространяются на условиях Eclipse Public License v1.0, поставляемой вместе с продуктом и доступной на Web-сайте
http://www.eclipse.org/legal/epl-v10.html