Když uživatel zvolí prostředek a zvolí příkaz vyhledávání, vyhledávací modul plug-in spustí dialogové okno obsahující stránky pro různé druhy obsahového hledání. Tyto stránky jsou přispěny pomocí bodu rozšíření org.eclipse.search.searchPages.
Markup pro přispívání vyhledávací stránkou je zřejmý. Následující příklad je přispívání vyhledávací stránkou modulu plug-in JDT:
<extension point="org.eclipse.search.searchPages"> <page id="org.eclipse.jdt.ui.JavaSearchPage" icon="icons/full/obj16/jsearch_obj.png" label="%JavaSearchPage.label" sizeHint="460,160" extensions="java:90, jav:90" showScopeSection="true" canSearchEnclosingProjects="true" class="org.eclipse.jdt.internal.ui.search.JavaSearchPage"> </page> </extension>
Musí být specifikována třída class, která implementuje vyhledávací stránku. Tato třída musí implementovat rozhraní ISearchPage a typicky rozšiřuje DialogPage. Jsou určeny také popis label a ikona icon, které lze použít pro popis vyhledávání ve vyhledávacím dialogovém okně. Další parametry řídí velikost stránky a umístění stránky ve vyhledávacím dialogovém okně.
Atribut rozšíření extensions určuje prostředky, na nichž může vyhledávací stránka pracovat. Je formátován jako seznam přípon souborů oddělených čárkami. Každá přípona souboru by měla být následována hodnotou číselné váhy, přičemž 0 je nejnižší váha, oddělenou dvojtečkou. Hodnota váhy je relativní hodnota použitá k tomu, aby vyhledávací infrastruktura mohla najít vyhledávací stránku nejvhodnější pro daný prostředek.
Pokud vyhledávací stránka může hledat všechny možné prostředky, pak by se mělo použít "*".
Protokol pro ISearchPage
je jednoduchý. Vaše vyhledávací stránka musí implementovat performAction()
, který se volá při stlačení tlačítka Search. Vaše konkrétní implementace vyhledávání samozřejmě závisí na funkci vašeho modulu plug-in, ale v této metodě typické je otevřít prohlížeč výsledků pomocí NewSearchUImetody activateSearchResultView().
Váš modul plug-in odpovídá za zobrazení výsledků v zobrazení výsledků hledání.