Oppgi en søkeside

Når brukeren velger en ressurs og søkekommando, åpner plugin-modulen for søking en dialogboks som inneholder sider for ulike typer innholdssøking. Disse sidene oppgis ved hjelp av utvidelsespunktet org.eclipse.search.searchPages.

Kodetypen for å bidra med en søkeside, er enkel. Følgende eksempel er JDT-plugin-modulens bidrag til Java-søkesiden:

<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>

Klassen (class) som implementerer søkesiden, må angis. Klassen må implementere ISearchPage-grensesnittet og utvider vanligvis DialogPage.  Etiketten (label) og ikonet (icon) som kan brukes til å beskrive søkingen i søkedialogboksen, angis også. Andre parametere styrer størrelsen på siden og plasseringen av siden i søkedialogboksen.

Attributtet extensions angir ressursene som søkesiden kan operere på. Det er formatert som en liste over filtyper der komma brukes som skilletegn. Hver filtype etterfølges av en numerisk vektverdi der 0 er lavest, avgrenset av kolon.  Vektverdien er en relativ verdi som brukes for at søkeinfrastrukturen skal finne den mest egnede søkesiden for en gitt ressurs.

Hvis en søkeside kan søke i alle mulige ressurser, skal "*" brukes.

Implementere søkesiden

Protokollen for ISearchPage er enkel. Søkesiden må implementere performAction(), som kalles når du klikker på knappen Søk. Søkeimplementeringen avhenger selvsagt alltid av plugin-modulens funksjon, men det er vanlig å åpne et resultatvisningsprogram i denne metoden ved hjelp av NewSearchUI-metoden activateSearchResultView().

Det er plugin-modulens oppgave å vise resultatene i søkeresultatvisningen.