Estensioni della prospettiva
Identificativo:
org.eclipse.ui.perspectiveExtensions
Descrizione:
Questo punto di estensione
consente di estendere le prospettive registrate da altri plugin. Una prospettiva definisce il contenuto
iniziale delle barre di azione della finestra (menu e barra degli strumenti) e la serie iniziale di viste con
i rispettivi layout in una pagina del workbench.
Altri plugin possono
contribuire con azioni o viste alla prospettiva che viene visualizzata durante
la selezione. Le aggiunte opzionali da parte di altri plugin vengono accodate alla definizione iniziale.
Tag di configurazione:
<!ELEMENT extension (perspectiveExtension*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - identificativo completo del punto di estensione di
destinazione
- id - identificativo dell'istanza dell'estensione
- name - nome dell'istanza dell'estensione facoltativo
<!ELEMENT perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID - l'identificativo univoco della prospettiva (come specificato nel registro) nella quale viene fornito il contributo
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - l'identificativo univoco dell'insieme di azioni che sarà aggiunto alla prospettiva.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - l'identificativo univoco della vista che sarà aggiunta al sottomenu "Mostra vista" del menu
"Finestra".
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - l'identificativo univoco della prospettiva che sarà aggiunta al sottomenu "Apri prospettiva" del menu "Finestra" relativo alla prospettiva.
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - l'identificativo univoco della nuova procedura guidata che sarà aggiunta al sottomenu "Nuovo"
del menu "File" relativo alla prospettiva.
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - l'identificativo univoco della vista che sarà
aggiunto nella richiesta "Mostra in" della prospettiva nel menu di
selezione risorse.
<!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 - l'identificativo univoco della vista che sarà aggiunta al layout della prospettiva.
- relative - l'identificativo univoco di una vista che
esiste già nella prospettiva. Viene utilizzato come punto di riferimento per
posizionare la vista. La relazione esistente tra queste due viste
viene definita da relationship. Ignorato se relationship è "fast".
- relationship - specifica la relazione tra id e relative.
Sono supportati i seguenti valori:
fast - l'estensione della vista verrà creata come vista ad accesso rapido.
stack - l'estensione della vista sarà sovrapposta alla
relativa vista in una cartella.
left, right, top, bottom - l'estensione della vista sarà collocata
vicino alla vista relativa. In questo caso deve anche essere definito ratio.
- ratio - la percentuale di area della vista relativa che sarà
offerta all'estensione della vista. Se l'estensione della vista è una vista ad accesso rapido, il valore di
questo attributo corrisponde alla percentuale del workbench che sarà occupata dalla vista ad accesso rapido
quando è attiva. Deve essere
definito come valore a virgola mobile ed è compreso tra 0,05 e 0,95.
- visible - specifica se la vista è inizialmente visibile
quando la prospettiva è aperta. Questo attributo, se utilizzato, può avere valore "true" o "false".
Se non viene utilizzato, la vista sarà inizialmente visibile per
impostazione predefinita.
- closeable - se la vista può essere chiusa in una prospettiva di destinazione. Questo attributo, se utilizzato, può avere valore "true" o "false". Se
non viene utilizzato, la vista potrà essere chiusa a meno che la prospettiva stessa non sia
contrassegnata come fissa.
- moveable - se la vista può essere spostata. Una vista non dichiarata moveable non può essere
spostata all'interno della stessa cartella, o tra diverse cartelle della prospettiva. Questo attributo, se utilizzato, può avere valore "true" o "false".
Se non viene utilizzato, la vista potrà essere spostata a meno che la prospettiva stessa non sia
contrassegnata come fissa.
- standalone - se la vista è autonoma. Una vista autonoma non può essere bloccata insieme ad
altre nella stessa cartella. Questo attributo, se utilizzato, può avere valore "true" o "false". Questo
attributo viene ignorato se l'attributo di relazione è "fast" o "stacked". Se non viene utilizzato, la vista
è una vista normale, non autonoma (il valore predefinito è "false").
- showTitle - se il titolo della vista viene visualizzato. Questo attributo, se utilizzato, può avere valore "true" o "false". Questo attributo viene applicato solo alle viste autonome. Se non viene utilizzato, il titolo della vista
viene visualizzato (il valore predefinito è "true").
Esempi:
Di seguito è riportato un esempio
di estensione di prospettiva (si osservino l'elemento secondario e la modalità di utilizzo degli attributi):
<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>
Nell'esempio sopra riportato, all'iniziale contenuto della prospettiva Risorsa viene fornito il contributo di
un insieme di azioni, un collegamento alla vista, nuovi collegamenti alla procedura guidata e un collegamento
alla prospettiva. Inoltre, la vista Esplora pacchetto è
sovrapposta a quella di Selezione risorse, accanto alla quale
viene aggiunta la vista Gerarchia tipi.
Informazioni API:
gli elementi
definiti nell'estensione di prospettiva vengono aggiunti ai contenuti iniziali della prospettiva di
destinazione. In seguito l'utente può rimuovere qualsiasi contributo o
aggiungerne altri attraverso l'interfaccia utente del workbench.
Copyright (c) 2002, 2004 IBM Corporation e altri.
Tutti i diritti riservati. Questo programma e il materiale di accompagnamento sono disponibili secondo i termini della Eclipse Public
License v1.0 che sono distribuiti con il prodotto, e disponibili all'indirizzo
http://www.eclipse.org/legal/epl-v10.html