Strony wyszukiwania
Identyfikator:
org.eclipse.search.searchPages
Opis:
Ten punkt rozszerzenia umożliwia modułom dodatkowym
rejestrację stron wyszukiwania na potrzeby wyszukiwań wyspecjalizowanych.
Podczas wykonywania wyszukiwania w odniesieniu do danego zasobu infrastruktura
wyszukiwania lokalizuje dla niego najodpowiedniejszą zarejestrowaną stronę.
Znaczniki konfiguracji:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA
#IMPLIED
name CDATA #IMPLIED>
- point - pełny identyfikator docelowego punktu rozszerzenia.
- id - opcjonalny identyfikator instancji rozszerzenia.
- name - opcjonalna nazwa instancji rozszerzenia.
<!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 - unikalna nazwa, która będzie używana do identyfikowania tej
strony wyszukiwania.
- label - możliwa do przetłumaczenia etykieta, która będzie używana na
karcie strony wyszukiwania.
- class - nazwa klasy, która implementuje interfejs
org.eclipse.search.ui.ISearchPage. Zaleca się utworzenie podklasy
klasy org.eclipse.jface.dialogs.DialogPage.
- icon - względna nazwa obrazu, który będzie stosowany do wszystkich
zasobów zgodnych z określonymi rozszerzeniami. Pominięcie tego atrybutu
spowoduje, że karta strony wyszukiwania będzie jedynie zawierać etykietę.
- sizeHint - wskazówka dotycząca początkowego rozmiaru strony. Jest to
łańcuch zawierający szerokość i wysokość oddzielone przecinkiem (np. "50, 60").
Pominięcie wskazówki spowoduje, że strona nie będzie większa niż pozostałe
strony.
- tabPosition - liczba całkowita określająca, w którym miejscu strona
znajduje się w podręczniku. Wartość ta nie określa pozycji bezwzględnej, ale
decyduje o umieszczeniu strony względem pozostałych stron. Rozmieszczenie stron
odbywa się zgodnie z następującymi zasadami:
-
Jeśli żadna ze stron nie ma określonej pozycji, strony są sortowane
alfabetycznie według etykiet.
-
Jeśli obie strony mają określone pozycje, strona z niższą wartością ma
pierwszeństwo. Jeśli wartości są równe, wtedy strony traktuje się tak, jakby
nie miały określonej pozycji (patrz punkt 1.)
-
Jeśli tylko jedna ze stron ma określoną wartość, ma pierwszeństwo przed innymi
stronami.
- extensions - rozdzielana przecinkami lista rozszerzeń nazw plików,
na których może operować dana strona wyszukiwania. Każde rozszerzenie musi
również obejmować wagę (0 oznacza najniższą wagę), co pozwala infrastrukturze
wyszukiwania znaleźć najodpowiedniejszą stronę. Wagę oddziela się od
rozszerzenia przy użyciu dwukropka. Jeśli strona wyszukiwania ma wyszukiwać
wszystkie możliwe zasoby, można użyć znaku "*".
- searchViewHelpContextId - opcjonalny identyfikator kontekstu pomocy
widoku wyszukiwania, w którym wyświetlane są wyniki danej strony. Brak tego
atrybutu spowoduje, że użyty zostanie domyślny identyfikator kontekstu pomocy
(org.eclipse.search.search_view_context).
- showScopeSection - jeśli ten atrybut jest nieobecny lub ustawiony na
wartość "false", w oknie dialogowym wyszukiwania nie będzie wyświetlana sekcja
zasięgu. Aby sekcja ta była widoczna, należy ustawić ten atrybut na wartość "true".
Aby wyświetlić sekcję zasięgu w przypadku modułów dodatkowych, które dodają
własne strony wyszukiwania, należy dodać ten atrybut do pliku plugin.xml.
- enabled - jeśli ten atrybut jest nieobecny lub ustawiony na wartość
"false", w oknie dialogowym wyszukiwania strona nie będzie początkowo
wyświetlana. Użytkownik może ją aktywować za pomocą przycisku "Dostosuj" w
oknie dialogowym wyszukiwania.
- canSearchEnclosingProjects - jeśli ten atrybut jest nieobecny lub
ustawiony na wartość "false", zasięg wyszukiwania "Projekty obejmujące" nie
będzie wyświetlany w sekcji zasięgu w oknie wyszukiwania. Jeśli atrybut
"showScopeSection" jest nieobecny lub ustawiony na wartość "false", niniejszy
atrybut zostanie zignorowany.
Przykłady:
Poniżej przedstawiono przykład definicji
rozszerzenia strony wyszukiwania:
<extension point=
"org.eclipse.search.searchPages"
>
<page
id=
"org.eclipse.search.ui.text.TextSearchPage"
label=
"Wyszukiwanie tekstowe"
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>
Informacje o interfejsie API:
Dodawana klasa musi implementować
interfejs org.eclipse.search.ui.ISearchPage
.
Dostarczana implementacja:
Infrastruktura wyszukiwania udostępnia
stronę wyszukiwania służącą do wyszukiwania pełnotekstowego.
Copyright (c) 2001, 2004 IBM Corporation i inne podmioty.
Wszelkie prawa zastrzeżone. Program ten oraz towarzyszące mu materiały są udostępniane na warunkach licencji EPL (Eclipse Public License), wersja 1.0, dołączonej do nich i dostępnej pod adresem http://www.eclipse.org/legal/epl-v10.html.