Søkesider
Identifikator:
org.eclipse.search.searchPages
Beskrivelse:
Dette utvidelsespunktet
tillater at en plugin-modul registrerer søkesider for spesialiserte søk. Når søkehandlingen
utføres i en ressurs, finner infrastrukturen for søket den mest spesifikke registrerte
søkesiden for den.
Konfigurasjonskodetype:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - en fullt kvalifisert ID for målutvidelsespunktet
- id - en valgfri ID for utvidelsesforekomsten
- name - et valgfritt navn på utvidelsesforekomsten
<!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 - et unikt navn
som skal brukes til å identifisere denne søkesiden.
- label - en oversettbar
etikett som skal brukes på søkesideflippen.
- class - et navn
på klassen som implementerer org.eclipse.search.ui.ISearchPage. Det anbefales at
det opprettes subklasse av org.eclipse.jface.dialogs.DialogPage.
- icon - et relativt
navn på bildet som skal brukes til alle ressurser som samsvarer med de oppgitte
utvidelsene. Hvis det utelates, vil søkesidens flipp bare inneholde en etikett.
- sizeHint - et tips
for den opprinnelige størrelsen på siden. Dette er en streng
som inneholder bredden og høyden atskilt av komma (for eksempel "50, 60"). Hvis dette
tipset er utelatt, vil siden ikke være større enn de andre sidene.
- tabPosition - et heltall som
definerer hvor siden skal plasseres i sideboken. Verdien definerer ikke
den absolutte plasseringen, men plasseringen i forhold til de andre sidene. Sorteringen
av sidene er slik:
-
Hvis ingen av sidene
definerer plasseringen av flipper, blir de sortert alfabetisk etter etikettene.
-
Hvis begge sidene
har flipplasseringen oppgitt, vil siden med den laveste verdien komme først. Hvis verdiene
er like, blir sidene behandlet som om verdien ikke finnes (se 1).
-
Hvis bare en side
har verdien oppgitt, kommer denne siden først.
- extensions - en kommadelt
liste over filtyper som denne søkesiden kan arbeide med. Hver filtype må også
inkludere en vekt (0 betyr minste vekt) som gjør at søkeinfrastrukturen finner
siden som passer best. Vekten er skilt fra
filtypen med et kolon. Hvis en søkeside kan søke i alle
mulige ressurser, kan "*" brukes.
- searchViewHelpContextId - en valfri
ID for hjelpekonteksten for Søk-visningen som viser resultatene av denne siden. Hvis dette
attributtet mangler, brukes standard søke-ID for hjelpekonteksten
(org.eclipse.search.search_view_context).
- showScopeSection - hvis dette
attributtet mangler eller er definert til "false", blir omfangsdelen ikke vist i
Søk-dialogboksen.
Dette attributtet må være
definert til "true" for at det skal være mulig å se omfangsdelen.
Plugin-moduler som
legger til sin egen søkeside og ønsker å se omfangsdelen, må tilføye dette i
sin plugin.xml.
- enabled - hvis dette
attributtet mangler eller er definert til "false", blir siden ikke opprinnelig vist
i Søk-dialogboksen.
Siden kan aktiveres av
brukeren via "Tilpass"-knappen i Søk-dialogboksen.
- canSearchEnclosingProjects - hvis dette
attributtet mangler eller er definert til "false", blir søkeomfanget "Enclosing Projects" ikke vist
i omfangsdelen i Søk-dialogboksen.
Hvis attributtet "showScopeSection"
mangler eller er definert til "false", blir dette attributtet ignorert.
Eksempler:
Nedenfor finner
du et eksempel på en definisjon av en søkesideutvidelse:
<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-informasjon:
Klassen må
implementere org.eclipse.search.ui.ISearchPage
.
Levert implementering:
Søkeinfrastrukturen
har en søkeside for tekstsøk.
Copyright (c) 2001, 2004 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html