Zoekpagina's
ID:
org.eclipse.search.searchPages
Beschrijving:
Via dit extensiepunt kan een plugin zoekpagina's registreren voor gespecialiseerde zoekopdrachten. Wanneer de zoekopdracht wordt uitgevoerd op een resource, lokaliseert de infrastructuur voor zoeken de meest-specifieke, geregistreerde zoekpagina hiervoor.
Configuratiemarkup:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - een volledig gekwalificeerd ID van het doelextensiepunt.
- id - een optioneel ID van de extensie-instance.
- name - een optionele naam van de extensie-instance.
<!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 - een unieke naam die wordt gebruikt voor het identificeren van deze zoekpagina
- label - een vertaalbaar label dat wordt gebruikt in de zoekpagina-tab
- class - een naam van de klasse die org.eclipse.search.ui.ISearchPage implementeert. Aangeraden wordt het gebruiken van org.eclipse.jface.dialogs.DialogPage om subklassen onder te plaatsen.
- icon - een relatieve naam van de afbeelding die wordt gebruikt voor alle resources die overeenkomen met de opgegeven extensies. Als deze wordt weggelaten, bevat de tab Zoekpagina alleen een label.
- sizeHint - een hint over de oorspronkelijk grootte van de pagina. Deze tekenreeks bevat de breedte en de hoogte die worden gescheiden door een komma (e.g. "50, 60"). Als deze hint is weggelaten, wordt de pagina niet groter dan de andere pagina's.
- tabPosition - een geheel getal waarmee de plaats waar de pagina wordt geplaatst in het paginaboek wordt gedefinieerd. Door deze waarde wordt niet de absolute positie gedefinieerd maar de positie relatief aan de andere pagina's. Het bepalen van de volgorde van de pagina's vindt op de volgende manier plaats:
-
als door geen van de pagina's de tabpositie wordt gedefinieerd, worden de paginalabels op alfabet gesorteerd
-
als voor beide pagina's de tabpositie is opgegeven, wordt de pagina met de laagste waarde als eerste geplaatst. Als de waarden gelijk zijn, worden de pagina's behandeld alsof deze waarden niet bestaan (zie 1).
-
als slechts één pagina een waarde heeft gekregen, wordt deze als eerste geplaatst
- extensions - een lijst met bestandsextensies die door komma's worden gescheiden, waarop de zoekpagina kan functioneren. Elke extensie moet een gewicht bevatten (0 betekent het minste gewicht) dat het mogelijk maakt voor de zoekinfrastructuur om de meest geschikte pagina te vinden. Gewichten worden van extensies gescheiden door een dubbele punt. Als een zoekpagina alle mogelijke resources kan doorzoeken, kan "*" worden gebruikt.
- searchViewHelpContextId - een optioneel Helpcontext-ID van de view Zoeken waarin de resultaten van deze pagina worden weergegeven. Als dit kenmerk ontbreekt, wordt het standaard context-ID voor zoeken in Help (org.eclipse.search.search_view_context) gebruikt.
- showScopeSection - Als dit kenmerk ontbreekt of is ingesteld op "false", wordt het bereik niet afgebeeld in het dialoogvenster Zoeken.
Om de sectie voor bereik te kunnen zien, moet het kenmerk op "true" worden ingesteld.
Voor plugins waarvoor geldt dat een eigen Zoekpagina wordt toegevoegd en waarvoor de bereiksectie moet worden afgebeeld, moet dit kenmerk aan plugin.xml worden toegevoegd.
- enabled - Als dit kenmerk ontbreekt of is ingesteld op "false", wordt deze pagina niet onmiddellijk afgebeeld in het dialoogvenster Zoeken.
De pagina kan worden geactiveerd door de gebruiker met behulp van de knop "Aanpassen..." op het dialoogvenster Zoeken.
- canSearchEnclosingProjects - Als dit kenmerk ontbreekt of is ingesteld op "false", wordt het zoekbereik van de "Insluitende projecten" niet afgebeeld in het bereik van het dialoogvenster Zoeken.
Als het kenmerk "showScopeSection" ontbreekt of is ingesteld op "false", wordt dit kenmerk genegeerd.
Voorbeelden:
Een voorbeeld van een definitie van een zoekpaginaextensie:
<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>
API-informatie:
De aangeleverde klasse moet org.eclipse.search.ui.ISearchPage
implementeren.
Verstrekte implementatie:
De infrastructuur voor Zoeken levert een zoekpagina om te kunnen zoeken in de volledige tekst.
Copyright (c) 2001, 2004 IBM Corporation en anderen.
Alle rechten voorbehouden. Dit programma en het begeleidende materiaal zijn beschikbaar gesteld onder de voorwaarden van de Eclipse Public License v1.0 die bij deze distributie is geleverd en beschikbaar is op http://www.eclipse.org/legal/epl-v10.5tml.