Hakusivut
Tunnus:
org.eclipse.search.searchPages
Kuvaus:
Tämän laajennuspisteen avulla lisäosaan voidaan rekisteröidä
erikoishakuihin käytettäviä hakusivuja. Hakurakenne käyttää
resurssihaussa haettavaa resurssia tarkimmin vastaavaa rekisteröityä hakusivua.
Merkintärakenne:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - kohdelaajennuspisteen tarkka tunnus.
- id - laajennuksen ilmentymän valinnainen tunnus.
- name - laajennuksen ilmentymän valinnainen nimi.
<!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 - tämän hakusivun yksilöllinen nimi.
- label - hakusivujen välilehdellä käytettävä käännettävä nimiö.
- class - sen luokan nimi, joka toteuttaa org.eclipse.search.ui.ISearchPage-liittymän. Org.eclipse.jface.dialogs.DialogPage-aliluokkamääritystä suositellaan.
- icon - sen kuvan suhteellinen nimi, jota käytetään
kaikissa määritettyjä laajennuksia vastaavissa resursseissa.
Jos tälle määritteelle ei ole annettu arvoa, hakusivun välilehdellä näkyy vain label-määritteen nimiöarvo.
- sizeHint - sivun peruskoon vihjemääritys. Tämä on merkkijonomuotoinen
kokomääritys, joka sisältää leveys- ja korkeusarvot pilkulla erotettuina
(esimerkiksi "50, 60"). Jos tätä vihjemääritystä ei ole tehty,
sivua näytetään muiden sivujen kokoisena.
- tabPosition - kokonaisluku, joka määrittää sivun välilehtipaikan. Tämä arvo ei määritä paikkaa tarkasti vaan suhteessa muihin sivuihin. Sivut järjestetään
seuraavasti:
-
Jos sivujen välilehtipaikkaa ei ole määritetty, ne järjestetään
aakkosjärjestykseen niiden nimien (label-määrite) perusteella.
-
Jos sivuille on määritetty välilehtipaikka, sivut sijoitetaan
järjestyksessä alimmasta arvosta suurimpaan. Jos joillakin sivuilla on
sama arvo, sivut käsitellään ensimmäisen ehdon mukaisesti aivan kuin
niille ei olisi määritetty välilehtipaikkaa.
-
Jos tämä arvo on määritetty vain yhdelle sivulle, se sijoitetaan ensimmäiseksi.
- extensions - pilkuilla eroteltu luettelo tiedostotunnisteista, joita
tämä hakusivu voi käsitellä. Kuhunkin tunnisteeseen on lisättävä
painotusarvo (alin painotus on 0), jonka avulla hakurakenne
määrittää haettavaa kohdetta parhaiten vastaavan
hakusivun. Tunnisteen ja painotusarvon erotinmerkki
on puolipiste. Jos hakusivun avulla voi tehdä hakuja
kaikkiin mahdollisiin resursseihin, voidaan käyttää arvoa *.
- searchViewHelpContextId - valinnainen ohjekontekstin tunnus sitä hakunäkymää varten, jossa tämän sivun tulokset näytetään. Jos tälle määritteelle ei ole annettu arvoa, käytetään hakutoiminnon oletusohjekontekstin tunnusta (org.eclipse.search.search_view_context).
- showScopeSection - näyttämismääritys. Jos tälle määritteelle ei ole annettu arvoa tai jos arvo on false, hakuvalintaikkunassa ei näy vaikutusalueosaa.
Jos vaikutusalueosan halutaan näkyvän, tämän määritteen arvoksi on annettava true.
Jos vaikutusalueosan halutaan näkyvän oman hakusivun lisäävien lisäosien hakusivuilla, lisäosien plugin.xml-tiedostoissa on oltava tämä arvo.
- enabled - käyttömääritys. Jos tälle määritteelle ei ole annettu arvoa tai jos arvo on false, tämä sivu ei näy hakuvalintaikkunassa.
Käyttäjä voi ottaa sivun käyttöön napsauttamalla hakuvalintaikkunan Mukauta...-painiketta.
- canSearchEnclosingProjects - projektihakumääritys. Jos tälle määritteelle ei ole annettu arvoa tai jos arvo on false, hakuvalintaikkunan vaikutusalueosassa ei näy Sisältävät projektit -vaikutusaluetta.
Jos showScopeSection-määritteelle ei ole annettu arvoa tai jos arvo on false, tämän määritteen arvo ohitetaan.
Esimerkkejä:
Seuraavassa on hakusivulaajennuksen määritysesimerkki:
<extension point=
"org.eclipse.search.searchPages"
>
<page
id=
"org.eclipse.search.ui.text.TextSearchPage"
label=
"Tekstihaku"
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-tiedot:
Lisätyn luokan on toteutettava org.eclipse.search.ui.ISearchPage
-liittymä.
Toimitettu toteutus:
Hakurakenne sisältää tekstihakuja varten
suunnitellun hakusivun.
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