Suchseiten
Kennung: org.eclipse.search.searchPages
Beschreibung: Über diesen Erweiterungspunkt kann ein
Plug-in Suchseiten für spezielle Suchvorgänge registrieren.
Wenn die Suchaktion für eine Ressource ausgeführt wird, lokalisiert
die Suchinfrastruktur die am meisten spezifische Suchseite, die für
die Ressource registriert ist.
Konfigurationsbefehle:
<!ELEMENT page EMPTY>
<!ATTLIST page
id CDATA #REQUIRED
label CDATA #REQUIRED
class CDATA #REQUIRED
icon CDATA #IMPLIED
sizeHint CDATA #REQUIRED
tabPosition CDATA #IMPLIED
extensions CDATA #IMPLIED
-
id: Ein eindeutiger Name, der diese Suchseite kennzeichnet.
-
label: Eine übersetzbare Bezeichnung, die auf der
Registerkarte der Suchseite verwendet wird.
-
class: Der Name einer Klasse, die
org.eclipse.jface.dialogs.IDialogPage implementiert.
Die Aufnahme von
org.eclipse.jface.dialogs.DialogPage als Unterklasse wird
empfohlen.
-
icon: Der relative Name des Images, das für alle Ressourcen
verwendet wird, die den angegebenen Erweiterungen entsprechen.
Wenn dieses Attribut übergangen wird, enthält die Registerkarte der
Suchseite lediglich einen Kennsatz.
-
sizeHint: Ein Hinweis auf die Anfangsgröße der Seite. Hierbei
handelt es sich um eine Zeichenfolge, die Breite und Höhe durch ein
Komma voneinander getrennt angibt (z. B. "50, 60").
Wenn dieses Attribut übergangen wird, ist die Seite nicht größer als
die übrigen Seiten.
-
tabPosition: Eine ganze Zahl, die definiert, wo die Seite im
Seitenbuch platziert werden soll.
Dieser Wert definiert nicht die absolute Position, sondern nur die
relative Position in Bezug auf die übrigen Seiten.
Die Reihenfolge der Seiten richtet sich nach den folgenden Regeln:
- Falls keine Seite die Position der Registerkarte definiert,
werden die Seiten anhand ihrer Kennsätze alphabetisch angeordnet.
- Falls auf beiden Seiten die Position der Registerkarte angegeben
ist, wird zunächst die Seite mit dem kleineren Wert ausgegeben.
Sind die Werte identisch, werden die Seiten so behandelt, als ob
keine Werte vorhanden wären (siehe Regel 1).
- Falls der Wert nur auf einer Seite angegeben ist, wird diese
Seite zuerst ausgegeben.
-
extensions: Eine durch Kommata untergliederte Liste der
Dateierweiterungen, auf die die Suchseite angewendet werden kann.
Jede Erweiterung muss außerdem eine Wertigkeit enthalten (0 gibt die
niedrigste Wertigkeit an), damit die Suchinfrastruktur die
am besten geeignete Seite ermitteln kann.
Die Wertigkeit wird von der Erweiterung durch einen Doppelpunkt
getrennt.
Falls eine Suchseite alle möglichen Ressourcen durchsuchen kann, kann
das Zeichen * (Stern) verwendet werden.
Beispiele:
Beispiel einer Erweiterungsdefinition für eine
Suchseite:
<extension point="org.eclipse.search.searchPages">
<page
id="org.eclipse.search.ui.text.TextSearchPage"
label="Textsuche"
icon="icons/full/obj16/tsearch_pref.gif"
sizeHint="250,160"
tabPosition="1"
extensions="*:1"
class="org.eclipse.search.ui.text.TextSearchPage"
</page>
</extension>
Bereitgestellte Implementierung: Die
Suchinfrastruktur stellt eine Suchseite für die Volltextsuche zur
Verfügung.