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
showScopeSection CDATA #IMPLIED
enabled CDATA #IMPLIED
>
- id: Ein eindeutiger Name, der diese Suchseite kennzeichnet.
-
label: Eine umsetzbare Bezeichnung, die auf der Registerkarte der Suchseite verwendet wird.
-
class: Der Name einer Klasse, die
org.eclipse.search.ui.ISearchPage 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:
- Wenn die Position der Registerkarte (tabPosition) für die Seite nicht angegeben ist, wird
Integer.MAX_VALUE / 2 verwendet.
- Die Seite mit dem kleineren Wert wird zuerst ausgegeben. Sind die Werte identisch, werden die Seiten gemäß ihrer Bezeichnungen alphabetisch angeordnet.
-
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 "*" verwendet werden.
-
showScopeSection - Wenn dieses Attribut fehlt oder auf "false" gesetzt ist, wird der Abschnitt für den Bereich im Suchdialog nicht angezeigt. Dieses Attribut muss auf "true" gesetzt sein, damit der Abschnitt für den Bereich angezeigt wird. Plug-ins, die ihre eigene Suchseite hinzufügen und den Abschnitt für den Bereich anzeigen möchten , müssen dieses Attribut ihrer Datei "plugin.xml" hinzufügen.
- enabled - Wenn dieses Attribut fehlt oder auf "false" gesetzt ist, wird der Abschnitt für den Bereich im Suchdialog nicht angezeigt. Die Seite kann vom Benutzer über die Taste "Anpassen..." im Suchdialog aktiviert 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"
showScopeSection="true"
class="org.eclipse.search.ui.text.TextSearchPage"
</page>
</extension>
Bereitgestellte Implementierung: Die
Suchinfrastruktur stellt eine Suchseite für die Volltextsuche zur
Verfügung.