Επεκτάσεις προοπτικής
Ταυτότητα:
org.eclipse.ui.perspectiveExtensions
Περιγραφή:
Αυτό το σημείο επέκτασης χρησιμοποιείται για την επέκταση προοπτικών που έχουν καταχωρηθεί από άλλες πρόσθετες λειτουργίες. Μια προοπτική ορίζει τα αρχικά περιεχόμενα των γραμμών ενεργειών παραθύρων (μενού και γραμμή εργαλείων), καθώς και το αρχικό σύνολο προβολών και τη διάταξή τους σε μια σελίδα πάγκου εργασίας.
Άλλες πρόσθετες λειτουργίες μπορούν να συνεισφέρουν ενέργειες ή προβολές στην προοπτική, οι οποίες θα εμφανίζονται όταν η προοπτική επιλέγεται. Προαιρετικές προσθήκες από άλλες πρόσθετες λειτουργίες προσαρτώνται στον αρχικό ορισμό.
Μορφοποίηση ρυθμίσεων:
<!ELEMENT extension (perspectiveExtension*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - μια πλήρως προσδιορισμένη ταυτότητα του σημείου επέκτασης προορισμού
- id - μια προαιρετική ταυτότητα για τη χρήση της επέκτασης
- name - ένα προαιρετικό όνομα για τη χρήση της επέκτασης
<!ELEMENT perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID - η μοναδική ταυτότητα της προοπτικής (όπως ορίζεται στην καταχώρηση), στην οποία γίνεται η συνεισφορά.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - η μοναδική ταυτότητα του συνόλου ενεργειών, το οποίο θα προστεθεί στην προοπτική.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - η μοναδική ταυτότητα της προβολής η οποία θα προστεθεί στο υπομενού προοπτικής "Εμφάνιση προβολής" του μενού "Παράθυρο".
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - η μοναδική ταυτότητα της προοπτικής η οποία θα προστεθεί στο υπομενού προοπτικής "Άνοιγμα προοπτικής" του μενού "Παράθυρο".
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - η μοναδική ταυτότητα του οδηγού δημιουργίας, ο οποίος θα προστεθεί στο υπομενού προοπτικής "Δημιουργία" του μενού "Αρχείο".
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - η μοναδική ταυτότητα της προβολής η οποία θα προστεθεί στην προτροπή προοπτικής "Εμφάνιση σε..." στο μενού "Πλοήγηση".
<!ELEMENT view EMPTY>
<!ATTLIST view
id CDATA #REQUIRED
relative CDATA #IMPLIED
relationship (stack|left|right|top|bottom|fast)
ratio CDATA #IMPLIED
visible (true | false)
closeable (true | false)
moveable (true | false)
standalone (true | false)
showTitle (true | false) >
- id - η μοναδική ταυτότητα της προβολής, η οποία θα προστεθεί στη διάταξη προοπτικής.
- relative - η μοναδική ταυτότητα μιας προβολής, η οποία υπάρχει ήδη στην προοπτική. Αυτή θα χρησιμοποιείται ως σημείο αναφοράς για την τοποθέτηση της προβολής. Η σχέση μεταξύ δύο προβολών ορίζεται από το relationship. Παραβλέπεται, εάν το γνώρισμα relationship έχει την τιμή "fast".
- relationship - προσδιορίζει τη σχέση μεταξύ των id και relative.
Υποστηρίζονται οι ακόλουθες τιμές:
fast - η επέκταση προβολής θα δημιουργηθεί ως μια ταχεία προβολή.
stack - η επέκταση προβολής θα τοποθετηθεί σε στοίβα με την προβολή relative σε ένα φάκελο.
left, right, top, bottom - η επέκταση προβολής θα τοποθετηθεί δίπλα στην προβολή relative. Στην περίπτωση αυτή, πρέπει επίσης να οριστεί ένα ratio.
- ratio - το ποσοστό της περιοχής εντός της προβολής relative το οποίο θα προσφερθεί στην επέκταση προβολής. Εάν η επέκταση προβολής είναι μια ταχεία προβολή, τότε το ratio θα είναι το ποσοστό του πάγκου εργασίας που καλύπτει η ταχεία προβολή, όταν είναι ενεργή. Αυτό πρέπει να ορίζεται ως μια τιμή κινητής υποδιαστολής, μεταξύ 0,05 και 0,95.
- visible - εάν η προβολή είναι αρχικά ορατή, όταν ανοίγει η προοπτική. Το γνώρισμα αυτό θα πρέπει να έχει μια τιμή "true" ή "false", αν χρησιμοποιείται.
Εάν το γνώρισμα αυτό δεν χρησιμοποιείται, τότε ως προεπιλογή, η προβολή θα είναι αρχικά ορατή.
- closeable - εάν η προβολή μπορεί να κλείσει στην προοπτική προορισμού. Το γνώρισμα αυτό θα πρέπει να έχει μια τιμή "true" ή "false", αν χρησιμοποιείται. Εάν το γνώρισμα αυτό δεν χρησιμοποιείται, η προβολή θα μπορεί να κλείσει, εκτός κι αν η ίδια η προοπτική είναι σημειωμένη ως σταθερή.
- moveable - εάν η προβολή μπορεί να μετακινηθεί. Αν μια προβολή δεν μπορεί να μετακινηθεί, τότε αυτό θα ισχύει τόσο για μετακινήσεις μέσα στον ίδιο φάκελο όσο και για μετακινήσεις μεταξύ φακέλων της προοπτικής. Το γνώρισμα αυτό θα πρέπει να έχει μια τιμή "true" ή "false", αν χρησιμοποιείται.
Εάν το γνώρισμα αυτό δεν χρησιμοποιείται, η προβολή θα μπορεί να μετακινηθεί, εκτός κι αν η ίδια η προοπτική είναι σημειωμένη ως σταθερή.
- standalone - εάν η προβολή είναι μια ανεξάρτητη προβολή. Μια ανεξάρτητη προβολή δεν μπορεί να σταθεροποιηθεί με άλλες προβολές μέσα στον ίδιο φάκελο. Το γνώρισμα αυτό θα πρέπει να έχει μια τιμή "true" ή "false", αν χρησιμοποιείται. Το γνώρισμα αυτό παραβλέπεται, εάν το γνώρισμα relationship έχει την τιμή "fast" ή "stacked". Εάν το γνώρισμα αυτό δεν χρησιμοποιείται, η προβολή θα είναι μια κανονική προβολή και όχι μια ανεξάρτητη προβολή (η προεπιλογή είναι "false").
- showTitle - εάν ο τίτλος της προβολής εμφανίζεται. Το γνώρισμα αυτό θα πρέπει να έχει μια τιμή "true" ή "false", αν χρησιμοποιείται. Το γνώρισμα αυτό εφαρμόζεται μόνο σε ανεξάρτητες προβολές. Αν το γνώρισμα αυτό δεν χρησιμοποιείται, τότε ο τίτλος της προβολής θα εμφανίζεται (η προεπιλογή είναι "true").
Παραδείγματα:
Ακολουθεί ένα παράδειγμα επέκτασης προοπτικής (προσέξτε τα υποστοιχεία και τον τρόπο χρήσης των γνωρισμάτων):
<extension point=
"org.eclipse.ui.perspectiveExtensions"
>
<perspectiveExtension
targetID=
"org.eclipse.ui.resourcePerspective"
>
<actionSet id=
"org.eclipse.jdt.ui.JavaActionSet"
/>
<viewShortcut id=
"org.eclipse.jdt.ui.PackageExplorer"
/>
<newWizardShortcut id=
"org.eclipse.jdt.ui.wizards.NewProjectCreationWizard"
/>
<perspectiveShortcut id=
"org.eclipse.jdt.ui.JavaPerspective"
/>
<view id=
"org.eclipse.jdt.ui.PackageExplorer"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"stack"
/>
<view id=
"org.eclipse.jdt.ui.TypeHierarchy"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"left"
ratio=
"0.50"
/>
</perspectiveExtension>
</extension>
Στο παραπάνω παράδειγμα, ένα σύνολο ενεργειών, μια συντόμευση προβολής, μια συντόμευση οδηγού δημιουργίας και μια συντόμευση προοπτικής συνεισφέρονται στα αρχικά περιεχόμενα της προοπτικής "Πόρος". Επιπλέον, η προβολή "Εξερεύνηση πακέτων" τοποθετείται σε στοίβα στη λειτουργία πλοήγησης πόρων και η προβολή ιεραρχίας ειδών προστίθεται δίπλα στη λειτουργία πλοήγησης πόρων.
Πληροφορίες API:
Τα στοιχεία που ορίζονται στην επέκταση προοπτικής συνεισφέρονται στα αρχικά περιεχόμενα της προοπτικής προορισμού. Ο χρήστης μπορεί στη συνέχεια να αφαιρέσει μια συνεισφορά ή να προσθέσει άλλες σε μια προοπτική, από το περιβάλλον χρήστη πάγκου εργασίας.
Copyright (c) 2002, 2004 IBM Corporation και άλλων.
Με την επιφύλαξη παντός δικαιώματος. Αυτό το πρόγραμμα και τα
συνοδευτικά του υλικά διατίθενται βάσει των όρων της κοινής άδειας
χρήσης Eclipse Public License v1.0 που συνοδεύει αυτή τη διανομή και
διατίθεται στην ακόλουθη διεύθυνση:
http://www.eclipse.org/legal/epl-v10.html.