Söksidor
ID:
org.eclipse.search.searchPages
Beskrivning:
Med den här utökningspunkten kan du använda ett insticksprogram för att registrera söksidor för
specialiserade sökningar. När sökåtgärden
utförs för en resurs letar sökinfrastrukturen
rätt på den mest specifika registrerade söksidan för den.
Konfigurationsmärkordsuppsättning:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - ett fullständigt ID för målutökningspunkten
- id - ett valfritt ID för utökningsförekomsten
- name - ett valfritt namn på utökningsförekomsten
<!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 - ett unikt namn som används för att identifiera
söksidan
- label - en översättningabar etikett som använs på söksidans
flik
- class - ett namn på den klass som implementerar org.eclipse.search.ui.ISearchPage. Vi rekommenderar underklassindelning av
org.eclipse.jface.dialogs.DialogPage.
- icon - ett relativt namn på den avbild som används
för alla resurser som stämmer med de angivna utökningarna. Om det utelämnas innehåller söksidans flik endast en etikett.
- sizeHint - ett tips för sidans initiala storlek. Detta är en sträng
som innehåller bredd och höjd avgränsade med
kommatecken (t ex "50, 60"). Om det här tipset
utelämnas blir sidan inte större än andra sidor.
- tabPosition - ett heltal som definierar var sidan placeras i
sidboken. Värdet definierar inte den absoluta positionen
utan positionen i relation till övriga sidor. Sidorna
sorteras på följande sätt:
-
Om ingen av sidorna definierar flikpositionen sorteras de
alfabetiskt efter sina etiketter
-
om båda sidorna har flikposition angiven placeras den
sidan som har det lägsta värdet först. Om värdena
är lika behandlas sidorna som om värdena
inte fanns (se 1.)
-
om endast en sida har värdet angivet placeras den
sidan först
- extensions - en kommaavgränsad lista med filnamnstillägg som
söksidan kan användas för. Varje filnamnstillägg måste
även inkludera en vikt (0 utgör den lägsta vikten)
som möjliggör för sökinfrastrukturen att hitta
den mest passande sidan. Vikten avgränsas från
filnamnstillägget med ett kolon. Om en söksida kan
användas för sökning i alla möjliga resurser kan "*" användas.
- searchViewHelpContextId - ett valfritt hjälpsammanhangs-ID för sökvyn visar resultat för den här sidan. Om attributet saknas används förvalt hjälpsammanhangs-ID för sökning(org.eclipse.search.search_view_context).
- showScopeSection - Om det här attributet saknas eller har värdet "false" visas inte omfångsavsnittet i sökdialogrutan.
Om du vill visa omfångsavsnittet måste attributet ha värdet "true".
Om du vill visa omfångsavsnittet för insticksprogram som lägger till sina egna söksidor måste du lägga till detta i deras plugin.xml.
- enabled - Om det här attributet saknas eller har värdet "false" visas inte sidan till att börja med i sökdialogrutan.
Sidan kan aktiveras av användaren via knappen "Anpassa..." i sökdialogrutan.
- canSearchEnclosingProjects - Om det här attributet saknas eller har värdet "false" visas inte sökomfånget "Omslutande projekt" i sökdialogrutans omfångsdel.
Om attributet "showScopeSection" saknas eller har värdet "false" ignoreras det här attributet.
Exempel:
Här följer ett exempel på en söksidas filltilläggsdefinition:
<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-information:
Den bidragande klassen måste implementera org.eclipse.search.ui.ISearchPage
Medföljande implementering:
Sökinfrastrukturen innehåller en söksida för fritextssökning.
Copyright (c) 2001, 2004 IBM Corporation and others.
All Rights Reserved. Detta program och medföljande material tillhandahålls under villkoren för Eclipse Public License v1.0 som medföljer denna distribution och finns tillgänglig på
http://www.eclipse.org/legal/epl-v10.html