Vyhledávací stránky
Identifikátor:
org.eclipse.search.searchPages
Popis:
Tento bod rozšíření umožňuje modulu plug-in registrovat vyhledávací stránky pro specializovaná vyhledávání. Když je nad prostředkem provedena akce vyhledávání, vyhledá pro něj infrastruktura vyhledávání nejspecifičtější registrovanou vyhledávací stránku.
Konfigurační markup:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - Úplný identifikátor cílového bodu rozšíření.
- ID - Nepovinný identifikátor instance rozšíření.
- name - Nepovinný název instance rozšíření.
<!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 - Jedinečný název, který bude použit pro identifikaci této vyhledávací stránky.
- label - Přeložitelné označení, které bude použito na kartě vyhledávací stránky.
- class - Název třídy, která implementuje org.eclipse.search.ui.ISearchPage. Doporučujeme vytvořit podtřídu org.eclipse.jface.dialogs.DialogPage.
- icon - Vztažný název obrázku, který se použije pro všechny prostředky, které odpovídají určeným rozšířením.
Pokud je vynechán, bude karta vyhledávací stránky obsahovat pouze označení.
- sizeHint - Pokyn pro počáteční velikost dané stránky. Jedná se o řetězec obsahující šířku a výšku oddělené čárkou (např. "50, 60"). V případě, že je tento pokyn vynechán, nebude tato stránka o nic větší než ostatní stránky.
- tabPosition - Celé číslo definující, kde je stránka umístěna v knize stránek. Tato hodnota nedefinuje absolutní pozici, ale pozici relativní vzhledem k ostatním stránkám. Stránky jsou řazeny následujícím způsobem:
-
Pokud žádná stránka nedefinuje pozici karty, budou seřazeny abecedně podle svých označení.
-
Pokud mají obě stránky definovanou pozici karty, bude první uvedena stránka s nižší hodnotou. Pokud jsou hodnoty stejné, bude se stránkami zacházeno, jako by tyto hodnoty neexistovaly (viz bod 1).
-
Pokud má tuto hodnotu určenu pouze jedna stránka, pak bude uvedena první.
- extensions - Seznam přípon souborů, oddělených čárkou, s nimiž daná vyhledávací stránka umí pracovat. Každá přípona musí obsahovat také váhu (0 znamená nejnižší váhu), která umožňuje vyhledávací infrastruktuře najít nejlépe vyhovující stránku. Tato váha je od přípony oddělena dvojtečkou. Pokud může vyhledávací stránka prohledávat všechny možné prostředky, lze použít "*".
- searchViewHelpContextId - Nepovinné ID kontextu nápovědy pohledu vyhledávání zobrazujícího výsledky této stránky. Pokud tento atribut chybí, použije se výchozí ID kontextu nápovědy pro prohledávání (org.eclipse.search.search_view_context).
- showScopeSection - Pokud tento atribut chybí, nebo je nastaven na "false", nezobrazí se ve vyhledávacím dialogovém okně oddíl rozsahu.
Chcete-li oddíl rozsahu zobrazit, musí být tento atribut nastaven na "true".
Moduly plug-in, které přidávají své vlastní vyhledávací stránky a chtějí zobrazit oddíl rozsahu, jej musí přidat do svých souborů plugin.xml.
- enabled - Pokud tento atribut chybí, nebo je nastaven na "false", nezobrazí se tato stránka na začátku ve vyhledávacím dialogovém okně.
Uživatel může stránku aktivovat pomocí tlačítka "Přizpůsobit..." ve vyhledávacím dialogovém okně.
- canSearchEnclosingProjects - Pokud tento atribut chybí, nebo je nastaven na "false", nezobrazí se v oddíle rozsahu vyhledávacího dialogového okna rozsah prohledávání "Zapouzdřující projekty".
Pokud atribut "showScopeSection" chybí nebo je nastaven na "false", bude tento atribut ignorován.
Příklady:
Následuje příklad definice rozšíření vyhledávací stránky:
<extension point=
"org.eclipse.search.searchPages"
>
<page
id=
"org.eclipse.search.ui.text.TextSearchPage"
label=
"Text Search"
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>
Informace rozhraní API:
Přidaná třída musí implementovat org.eclipse.search.ui.ISearchPage
.
Dodaná implementace:
Infrastruktura vyhledávání poskytuje vyhledávací stránku pro plnotextové vyhledávání.
Copyright (c) 2001, 2004 IBM Corporation a další.
Všechna práva vyhrazena.
Tento program a doprovodné materiály jsou zpřístupněny za podmínek licence Eclipse Public License
v1.0, která je součástí této distribuce a je k dispozici na adrese
http://www.eclipse.org/legal/epl-v10.html