Søgesider
Id:
org.eclipse.search.searchPages
Beskrivelse:
Med dette udvidelsespunkt kan en plugin registrere søgesider for
specielle søgninger. Når søgefunktionen udføres i forbindelse med en
ressource, finder søgeinfrastrukturen den mest specifikke registrerede
søgeside til den.
Konfigurationskode:
<!ELEMENT extension (page*)>
<!ATTLIST-udvidelse
point CDATA #REQUIRED
id CDATA #IMPLIED
navn CDATA #IMPLIED>
- point - en fuldstændig id for måludvidelsespunktet.
- id - en valgfri id for udvidelsesforekomsten.
- name - et valgfrit navn på udvidelsesforekomsten.
<!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 entydigt navn, der skal bruges til at identificere
denne søgeside
- label - en oversætbar etiket, der vil blive brugt på
skillebladet til søgesiden
- class - eavnet på den klasse, der implementerer
org.eclipse.search.ui.ISearchPage. Vi anbefaler at opdele i
underklasser, for så vidt angår
org.eclipse.jface.dialogs.DialogPage.
- icon - et relativt navn på det image, der skal bruges til alle
de ressourcer, der matcher de angivne udvidelser. Hvis det udelades,
vil søgesidens skilleblad kun indeholde en etiket.
- sizeHint - en angivelse af den første størrelse på siden. Det
er en streng, der indeholder bredde og højde adskilt af et
komma, f.eks. "50, 60". Hvis denne angivelse udelades, vil siden ikke
være større end de andre sider.
- tabPosition - et heltal, der definerer, hvor siden skal
placeres i bogen. Værdien definerer ikke den absolutte position, men en
position i forhold til de andre sider. Sidernes rækkefølge er som følger:
-
hvis ingen af siderne definerer skillebladspositionen, sorteres de
alfabetisk i overensstemmelse med deres etiketter
-
hvis begge sider har skillebladspositionen angivet, kommer siden med den
mindste værdi først. Hvis værdierne er lige store, behandles siderne, som
om værdierne ikke findes (se 1).
-
hvis kun en af siderne har en værdi angivet, kommer denne side først
- extensions - en kommasepareret liste med filudvidelser, på
basis af hvilke søgesiden kan fungere. Hver udvidelse skal også omfatte en
vægt (0 betyder laveste vægt), som gør det muligt for søgeinfrastrukturen
at finde den side, der passer bedst. Vægten er adskilt fra udvidelsen med
et kolon. Hvis søgesiden kan søge efter alle de mulige ressourcer, kan du
bruge "*".
- searchViewHelpContextId - en valgfri hjælpekontekst-id for
søgeoversigten, som viser resultatet af denne side. Hvis denne attribut
mangler, anvendes standard-id'en for søgehjælpekonteksten
(org.eclipse.search.search_view_context).
- showScopeSection - hvis denne attribut mangler, eller den er
sat til "false", vises omfangsafsnittet ikke i søgedialogboksen.
Attributten skal sættes til "true", hvis omfangsafsnittet skal vises.
De plugin, der tilføjer deres egen søgeside og vil have vist
omfangsafsnittet, skal tilføje dette til deres plugin.xml.
- enabled - hvis denne attribut mangler, eller den er sat til
"false", vises siden ikke først i søgedialogboksen.
Brugeren kan aktivere siden ved hjælp af knappen "Tilpas..." i
søgedialogboksen.
- canSearchEnclosingProjects - hvis denne attribut mangler, eller
den er sat til "false", vises søgeomfanget "Omsluttende projekter" ikke i
søgedialogboksens omfangsdel.
Hvis attributten "showScopeSection" mangler, eller den er sat til "false",
ignoreres denne attribut.
Eksempler:
Det følgende er et eksempel på en definition på en søgesideudvidelse:
<udvidelsespunkt=
"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-oplysninger:
Den leverede
klasse skal implementere org.eclipse.search.ui.ISearchPage
Leveret implementering:
Søgeinfrastrukturen leverer en søgeside til fuldstændig tekstsøgning.
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