Προβολές
Ταυτότητα:
org.eclipse.ui.views
Περιγραφή:
Αυτό το σημείο επέκτασης χρησιμοποιείται για τον ορισμό πρόσθετων προβολών στον πάγκο εργασίας. Η προβολή είναι ένα οπτικό στοιχείο στη σελίδα του πάγκου εργασίας. Χρησιμοποιείται συνήθως για την πλοήγηση σε μια ιεραρχίας πληροφοριών (όπως στο χώρο εργασίας), το άνοιγμα μιας λειτουργίας επεξεργασίας ή την εμφάνιση των ιδιοτήτων της ενεργής λειτουργίας επεξεργασίας. Ο χρήστης μπορεί να εμφανίσει μια προβολή από το μενού Παράθυρο > Εμφάνιση προβολής ή να την κλείσει από την τοπική γραμμή τίτλου της προβολής.
Για να μειωθεί το οπτικό χάος στο πλαίσιο διαλόγου "Εμφάνιση προβολής", οι προβολές θα πρέπει να ομαδοποιούνται χρησιμοποιώντας κατηγορίες.
Μορφοποίηση ρυθμίσεων:
<!ELEMENT extension (category | view | stickyView)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - μια πλήρης ταυτότητα του σημείου επέκτασης προορισμού
- id - μια προαιρετική ταυτότητα για τη χρήση της επέκτασης
- name - ένα προαιρετικό όνομα για τη χρήση της επέκτασης
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - ένα μοναδικό όνομα που θα χρησιμοποιηθεί για τον ορισμό αυτής της κατηγορίας
- name - ένα μεταφράσιμο όνομα που θα χρησιμοποιηθεί στο περιβάλλον χρήστη για αυτή την κατηγορία.
- parentCategory - μια προαιρετική διαδρομή που αποτελείται από ταυτότητες κατηγοριών που διαχωρίζονται με "/". Αυτό επιτρέπει τη δημιουργία μιας ιεραρχίας κατηγοριών.
<!ELEMENT view (description?)>>
<!ATTLIST view
id CDATA #REQUIRED
name CDATA #REQUIRED
category CDATA #IMPLIED
class CDATA #REQUIRED
icon CDATA #IMPLIED
fastViewWidthRatio CDATA #IMPLIED
allowMultiple (true | false) >
- id - ένα μοναδικό όνομα που θα χρησιμοποιηθεί για τον προσδιορισμό αυτής της προβολής.
- name - ένα μεταφράσιμο όνομα που θα χρησιμοποιηθεί στο περιβάλλον χρήστη για αυτή την προβολή.
- category - ένα προαιρετικό γνώρισμα που αποτελείται από τις ταυτότητες κατηγοριών που διαχωρίζονται με "/". Κάθε κατηγορία στην οποία έχει γίνει παραπομπή πρέπει να δηλωθεί σε ένα αντίστοιχο στοιχείο κατηγορίας.
- class - ένα πλήρες όνομα της κλάσης που υλοποιεί το org.eclipse.ui.IViewPart. Κοινή πρακτική είναι η δημιουργία υποκλάσης org.eclipse.ui.part.ViewPart για τη μεταβίβαση της προεπιλεγμένης λειτουργίας.
- icon - ένα σχετικό όνομα του εικονιδίου που θα συσχετιστεί με την προβολή.
- fastViewWidthRatio - το ποσοστό του πλάτους του πάγκου εργασίας που θα καταλάβει η προβολή ως μια ενεργή ταχεία προβολή.
Πρέπει να ορισθεί ως τιμή κινητής υποδιαστολής και να κυμαίνεται μεταξύ 0.05 και 0.95.
Αν δεν παρέχεται κάποια τιμή, θα χρησιμοποιηθεί η προεπιλεγμένη αναλογία.
- allowMultiple - ενδείκτης που επισημαίνει αν αυτή η προβολή επιτρέπει τη δημιουργία πολλαπλών χρήσεων χρησιμοποιώντας το IWorkbenchPage.showView(Ταυτότητα σειράς χαρακτήρων, secondaryId σειράς χαρακτήρων). Η προεπιλογή είναι "false".
<!ELEMENT description (#PCDATA)>
ένα προαιρετικό υποστοιχείο που θα πρέπει να περιέχει ένα κείμενο με μια σύντομη περιγραφή της προβολής.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
Η επανεμφανιζόμενη προβολή είναι μια προβολή η οποία θα εμφανίζεται ως προεπιλογή σε όλες τις προοπτικές ενός παραθύρου από τη στιγμή που θα ανοίγει. Η αρχική της τοποθέτηση εξαρτάται από το γνώρισμα θέσης, ωστόσο ο χρήστης μπορεί να την μετακινήσει ή να την κλείσει. Η χρήση αυτού του στοιχείου θα προκαλέσει μόνο τη δημιουργία ενός συμβόλου κράτησης θέσης για την προβολή και δεν θα εμφανίσει την προβολή. Να σημειωθεί ότι η χρήση αυτού του στοιχείου θα πρέπει να γίνεται με μεγάλη προσοχή και θα πρέπει να εφαρμόζεται μόνο σε προβολές που πραγματικά εξαρτώνται από τις προοπτικές για τη λειτουργία τους.
Από την έκδοση 3.0.
- id - Η ταυτότητα της προβολής που θα επανεμφανίζεται.
- location - προαιρετικό γνώρισμα που προσδιορίζει τη θέση της επανεμφανιζόμενης προβολής η οποία αφορά την περιοχή λειτουργίας επεξεργασίας. Αν απουσιάζει, η προβολή θα σταθεροποιηθεί στα δεξιά της περιοχής λειτουργίας επεξεργασίας.
- closeable - προαιρετικό γνώρισμα που προσδιορίζει αν η προβολή θα διαθέτει τη δυνατότητα κλεισίματος. Αν απουσιάζει, τότε η προβολή θα μπορεί να κλείσει.
- moveable - προαιρετικό γνώρισμα που προσδιορίζει αν η προβολή θα είναι μετακινήσιμη. Αν απουσιάζει, τότε θα είναι μετακινήσιμη.
Παραδείγματα:
Ακολουθεί ένα παράδειγμα του σημείου επέκτασης:
<extension point=
"org.eclipse.ui.views"
>
<category
id=
"com.xyz.views.XYZviews"
name=
"XYZ"
/>
<view
id=
"com.xyz.views.XYZView"
name=
"XYZ View"
category=
"com.xyz.views.XYZviews"
class=
"com.xyz.views.XYZView"
icon=
"icons/XYZ.gif"
/>
</extension>
Ακολουθεί ένα παράδειγμα δήλωσης επανεμφανιζόμενης προβολής:
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
Πληροφορίες API:
Η τιμή του γνωρίσματος class πρέπει να αποτελεί πλήρες όνομα της κλάσης που υλοποιεί το org.eclipse.ui.IViewPart. Συνηθίζεται η δημιουργία υποκλάσης org.eclipse.ui.part.ViewPart κατά την ανάπτυξη μιας νέας προβολής.
Παρεχόμενη υλοποίηση:
Η Πλατφόρμα Eclipse παρέχει έναν αριθμό τυπικών προβολών, μεταξύ των οποίων: "Πλοήγηση", "Ιδιότητες", "Διάρθρωση" και "Εργασίες". Από την πλευρά του χρήστη, αυτές οι προβολές δε διαφέρουν από οποιαδήποτε άλλη προβολή παρέχεται από τις πρόσθετες λειτουργίες. Όλες οι προβολές μπορούν να εμφανιστούν από το υπομενού "Εμφάνιση προβολής" του μενού "Παράθυρο". Η θέση μιας προβολής είναι μόνιμη: Αποθηκεύεται όταν κλείνει η προβολή και γίνεται επαναφορά όταν ή προβολή ανοίγει ξανά σε μοναδική συνεδρία. Η θέση παραμένει μόνιμη και ανάμεσα στις συνεδρίες του πάγκου εργασίας.
Copyright (c) 2002, 2005 IBM Corporation και άλλων.
Με την επιφύλαξη παντός δικαιώματος. Αυτό το πρόγραμμα και τα
συνοδευτικά του υλικά διατίθενται βάσει των όρων της κοινής άδειας
χρήσης Eclipse Public License v1.0 που συνοδεύει αυτή τη διανομή και
διατίθεται στην ακόλουθη διεύθυνση:
http://www.eclipse.org/legal/epl-v10.html.