Σελίδες αναζήτησης
Ταυτότητα:
org.eclipse.search.searchPages
Περιγραφή:
Αυτό το σημείο επέκτασης επιτρέπει σε μια πρόσθετη λειτουργία την καταχώρηση σελίδων αναζήτησης για συγκεκριμένες αναζητήσεις. Όταν η ενέργεια αναζήτησης πραγματοποιείται σε έναν πόρο, η υποδομή αναζήτησης εντοπίζει την πιο ειδική καταχωρημένη σελίδα αναζήτησης για αυτήν.
Μορφοποίηση ρυθμίσεων:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - μια πλήρης ταυτότητα του σημείου επέκτασης προορισμού
- id - μια προαιρετική ταυτότητα για τη χρήση της επέκτασης
- name - ένα προαιρετικό όνομα για τη χρήση της επέκτασης
<!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 - ένα μοναδικό όνομα που χρησιμοποιείται για τον προσδιορισμό αυτής της σελίδας αναζήτησης.
- label - μια μεταφράσιμη ετικέτα που χρησιμοποιείται στην καρτέλα της σελίδας αναζήτησης
- class - ένα όνομα της κλάσης η οποία υλοποιεί την org.eclipse.search.ui.ISearchPage. Συστήνεται η υποκλάση org.eclipse.jface.dialogs.DialogPage.
- icon - ένα σχετικό όνομα της εικόνας που χρησιμοποιείται για όλους τους πόρους που συμφωνούν με τις καθορισμένες επεκτάσεις.
Στην περίπτωση που παραλείπεται, η καρτέλα της σελίδας αναζήτησης θα περιέχει μόνο μια ετικέτα.
- sizeHint - μια υπόδειξη για το αρχικό μέγεθος της σελίδας. Πρόκειται για μια σειρά χαρακτήρων που περιέχει το πλάτος και το ύψος, διαχωρισμένα μεταξύ τους με κόμμα (π.χ. "50, 60"). Στην περίπτωση που η υπόδειξη αυτή παραλείπεται, η σελίδα δεν θα είναι μεγαλύτερη από τις άλλες σελίδες.
- tabPosition - ένας ακέραιος αριθμός που ορίζει το σημείο στο οποίο τοποθετείται η σελίδα στο βιβλίο σελίδων. Η τιμή δεν ορίζει την απόλυτη θέση, αλλά τη σχετική θέση ως προς τις άλλες σελίδες. Η σειρά των σελίδων έχει ως εξής:
-
εάν καμία σελίδα δεν ορίζει τη θέση της καρτέλας, τότε ταξινομούνται αλφαβητικά, σύμφωνα με τις ετικέτες τους
-
εάν και οι δύο σελίδες προσδιορίζουν τη θέση της καρτέλας, τότε η σελίδα με τη μικρότερη τιμή είναι πρώτη. εάν οι τιμές είναι ίσες, τότε οι σελίδες λαμβάνονται σαν να μην υπάρχουν οι τιμές αυτές (δείτε 1).
-
εάν μόνο μία σελίδα προσδιορίζει την τιμή αυτή, τότε η σελίδα αυτή είναι πρώτη
- extensions - μια λίστα με επεκτάσεις αρχείων, που διαχωρίζονται με κόμμα, όπου μπορεί να χρησιμοποιηθεί η σελίδα αναζήτησης. Κάθε επέκταση πρέπει επίσης να περιλαμβάνει ένα βαθμό σπουδαιότητας (το 0 σημαίνει χαμηλότερη σπουδαιότητα), που δίνει τη δυνατότητα στην υποδομή αναζήτησης να βρει τη σελίδα που ταιριάζει καλύτερα. Ο βαθμός σπουδαιότητας διαχωρίζεται από την επέκταση με άνω και κάτω τελεία. Εάν μια σελίδα αναζήτησης μπορεί να πραγματοποιήσει αναζήτηση σε όλους τους πιθανούς πόρους, τότε μπορεί να χρησιμοποιηθεί το "*".
- searchViewHelpContextId - μια προαιρετική ταυτότητα συμφραστικής βοήθειας της προβολής "Αναζήτηση" που εμφανίζει τα αποτελέσματα της σελίδας αυτής. Εάν το γνώρισμα αυτό λείπει, τότε χρησιμοποιείται η προεπιλεγμένη ταυτότητα συμφραστικής βοήθειας της αναζήτησης (org.eclipse.search.search_view_context).
- showScopeSection - Εάν το γνώρισμα αυτό λείπει ή εάν έχει την τιμή "false", τότε η ενότητα της εμβέλειας δεν εμφανίζεται στο πλαίσιο διαλόγου "Αναζήτηση".
Για να δείτε την ενότητα της εμβέλειας, το γνώρισμα αυτό πρέπει να έχει την τιμή "true".
Σε περίπτωση πρόσθετων λειτουργιών οι οποίες προσθέτουν τη δική τους σελίδα "Αναζήτηση", για να δείτε την ενότητα εμβέλειας πρέπει να την προσθέσετε στο αντίστοιχο αρχείο plugin.xml.
- enabled - Εάν το γνώρισμα αυτό λείπει ή εάν έχει την τιμή "false", τότε η σελίδα δεν εμφανίζεται εξαρχής στο πλαίσιο διαλόγου "Αναζήτηση".
Η σελίδα μπορεί να ενεργοποιηθεί από τον χρήστη, με τη χρήση του
κουμπιού "Προσαρμογή..." του πλαισίου διαλόγου
"Αναζήτηση".
- canSearchEnclosingProjects - Εάν το γνώρισμα αυτό λείπει ή εάν έχει την τιμή "false", τότε η εμβέλεια αναζήτησης "Περικλείοντα έργα" δεν εμφανίζεται στο τμήμα της εμβέλειας, στο πλαίσιο διαλόγου αναζήτησης.
Εάν το γνώρισμα "showScopeSection" λείπει ή εάν έχει την τιμή "false", τότε το γνώρισμα αυτό παραβλέπεται.
Παραδείγματα:
Παρακάτω δίνεται ένα παράδειγμα ορισμού επέκτασης σελίδας αναζήτησης:
<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:
Η συνεισφερόμενη κλάση πρέπει να υλοποιεί την org.eclipse.search.ui.ISearchPage
Παρεχόμενη υλοποίηση:
Η υποδομή αναζήτησης παρέχει μια σελίδα αναζήτησης για αναζήτηση πλήρους κειμένου.
Copyright (c) 2001, 2004 IBM Corporation και άλλων.
Με την επιφύλαξη παντός δικαιώματος. Αυτό το πρόγραμμα και τα συνοδευτικά του υλικά
διατίθενται βάσει των όρων της κοινής άδειας χρήσης Eclipse Public License v1.0 που
συνοδεύει αυτή τη διανομή και διατίθεται στην ακόλουθη διεύθυνση:
http://www.eclipse.org/legal/epl-v10.html.