Keresőoldalak
Azonosító:
org.eclipse.search.searchPages
Leírás:
Ezen kiterjesztési pont
segítségével a bedolgozó keresőoldalakat jegyezhet be a speciális
keresésekhez. A keresés tevékenység erőforráson végrehajtásakor a keresési
információforrás megkeresi a legspecifikusabb bejegyzett keresőoldalt.
Konfigurációs kód:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - a cél kiterjesztési pont teljes képzésű azonosítója
- id - a kiterjesztéspéldány elhagyható azonosítója
- name - a kiterjesztéspéldány elhagyható neve
<!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 - a keresőoldalt azonosító egyedi név
- label - a keresésoldal lapon használandó lefordítható címke
- class - az org.eclipse.search.ui.ISearchPage
elemet megvalósító osztály neve. Javasolt
org.eclipse.jface.dialogs.DialogPage alosztályok létrehozása.
- icon - a megadott kiterjesztéseknek megfelelő erőforrásokhoz
használandó kép relatív neve.
Ha ki van hagyva, akkor a keresőoldal lapja csak egy címkét tartalmat.
- sizeHint - az oldal kezdeti méretének tippje. Ez egy
karaktersorozat, amely vesszővel elválasztva tartalmazza a szélességet és
magasságot (például "50, 60"). Ha ez a tipp ki van hagyva, akkor az oldal
nem lesz nem nagyobb a többi oldalnál.
- tabPosition - egy egész szám, amely az oldal könyvben megadja
az oldal helyét. Az érték nem ad meg abszolút pozíciót, hanem más
oldalakhoz viszonyított relatív pozíciót. Az oldalak rendezése az alábbi:
-
ha egyik oldal sem ad meg lappozíciót, akkor címkék alapján, ábécérendben
jelennek meg
-
ha minden oldalhoz van megadva lappozíció, akkor az alacsonyabb értékű van
elöl. Ha az értékek megegyeznek, akkor a rendszer úgy kezeli őket, mintha
nem rendelkeznének értékkel (lásd 1. pont)
-
ha csak egy oldal rendelkezik megadott értékkel, akkor ez az oldal lesz az
első
- extensions - a fájlkiterjesztések vesszővel elválasztott
listája, amelyen a keresőoldal működhet. Minden kiterjesztésnek kell
tartalmaznia egy súlyozást (a 0 a legalacsonyabb), amelynek segítségével a
keresési infrastruktúra megkeresheti a legjobban megfelelő oldalt. A
súlyozás kettősponttal van elválasztva a kiterjesztéstől. Ha a keresőoldal
az összes lehetséges erőforrást keresheti, akkor a "*"
helyettesítőkarakter használható.
- searchViewHelpContextId - az oldal eredményeit megjelenítő
Keresés nézet elhagyható súgókontextus-azonosítója. Ha ez az attribútum
hiányzik, akkor a rendszer az alapértelmezett keresési
súgókontextus-azonosítót használja
(org.eclipse.search.search_view_context).
- showScopeSection - Ha ez az attribútum hiányzik, akkor "false"
értékre van állítva, akkor a hatókör rész nem jelenik meg a Keresés
párbeszédablakban.
A hatókör rész megjelenítéséhez az attribútumot "true" értékre kell állítani.
A bedolgozóknak, amelyek saját Keresés oldalt adnak, és meg kívánják
jeleníteni a hatókör részt, ezt hozzá kell adniuk a plugin.xml fájlhoz.
- enabled - Ha ez a jellemző hiányzik, vagy "false" értékre van
állítva, akkor az oldal kezdetben nem jelenik meg a Keresés
párbeszédablakban.
Az oldal a Keresés párbeszédablak "Testreszabás..." gombja segítségével
aktiválható.
- canSearchEnclosingProjects - Ha ez az attribútum hiányzik vagy
"false" értékre van állítva, akkor az "Körülvevő projektek" keresési
hatókör nem jelenik meg a keresés párbeszédablak hatókör részében.
Ha a "showScopeSection" attribútum hiányzik, vagy "false" értékre van
állítva, akkor ez az attribútum figyelmen kívül marad.
Példák:
Az alábbiakban
látható egy példa a keresőoldal-kiterjesztés megadására:
<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-információk:
A közreadott
osztálynak meg kell valósítania az
org.eclipse.search.ui.ISearchPage
elemet.
Szállított megvalósítás:
A
keresési infrastruktúra egy keresőpéldát biztosít a teljes szövegű
kereséshez.
Copyright (c) 2001, 2004 IBM Corporation és mások.
Minden jog fenntartva. Jelen program és annak kísérőanyagai a csomaghoz
tartozó, illetve a
http://www.eclipse.org/legal/epl-v10.html
címen is elérhető Eclipse Public License 1.0 verziójának hatálya alatt lettek
közzétéve.