Viste
Identificativo:
org.eclipse.ui.views
Descrizione:
Questo punto di estensione
viene utilizzato per definire viste aggiuntive nel workbench. Una vista è un componente di
visualizzazione all'interno di una pagina del workbench. Solitamente viene
utilizzato per individuare una gerarchia di informazioni (come lo spazio di
lavoro), aprire un editor o visualizzare le proprietà dell'editor attivo. L'utente può aprire una vista dal
menu Finestra > Mostra vista o chiuderla dalla barra del titolo della vista.
Per evitare confusione nella finestra Mostra vista, è possibile raggruppare le
viste in base alle categorie.
Tag di configurazione:
<!ELEMENT extension (category | view | stickyView)*>
<!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 category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - un nome univoco che verrà utilizzato per identificare questa categoria
- name - un nome che verrà utilizzato nell'interfaccia utente per questa categoria
- parentCategory - un percorso opzionale composto dagli ID di categoria separati da '/'. Ciò
consente la creazione di una gerarchia delle categorie.
<!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 - un nome univoco che verrà utilizzato per identificare questa vista
- name - un nome che verrà utilizzato nell'interfaccia utente per questa vista
- category - un attributo facoltativo composto dagli ID di categoria separati da '/'. Ogni
categoria referenziata deve essere dichiarata nel corrispondente elemento di categoria.
- class - il nome completo della classe che implementa org.eclipse.ui.IViewPart. Di solito, per ereditare la funzionalità predefinita, si esegue la sottoclasse org.eclipse.ui.part.ViewPart.
- icon - il nome relativo dell'icona che verrà associata alla vista.
- fastViewWidthRatio - la percentuale della larghezza del workbench che la vista occuperà come vista
ad accesso rapido attiva.
Deve essere definito come valore a virgola mobile ed è compreso tra 0,05 e 0,95.
Se non viene fornito alcun valore, viene utilizzato un rapporto predefinito.
- allowMultiple - indicatore che determina se questa vista consente istanze multiple da creare
utilizzando IWorkbenchPage.showView(String id, String secondaryId). Il valore predefinito è "false".
<!ELEMENT description (#PCDATA)>
un elemento secondario facoltativo che deve contenere nel relativo corpo una breve descrizione della vista.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
Una vista permanente è una vista che apparirà per impostazione predefinita in tutte le prospettive quando
si apre una finestra. La sua posizione iniziale è stabilita dall'attributo location, ma niente impedisce che
sia spostata o chiusa dall'utente. L'uso di questo elemento determina solo la creazione di un segnaposto per
la vista, non visualizza la vista. Si noti che l'uso di questo elemento deve essere effettuato con
attenzione e deve essere applicato solo alle viste che effettivamente richiedono di essere attive in tutte le
prospettive.
Da 3.0
- id - l'id della vista che deve essere resa permanente.
- location - attributo facoltativo che specifica la posizione della vista nell'area dell'editor. Se
assente, la vista sarà bloccata alla destra dell'area dell'editor.
- closeable - attributo facoltativo che specifica se la vista può essere chiusa. Se assente, la
vista può essere chiusa.
- moveable - attributo facoltativo che specifica se la vista può essere spostata. Se assente, la
vista può essere spostata.
Esempi:
Di seguito è riportato un esempio del punto di
estensione:
<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>
Di seguito è riportato un esempio di dichiarazione di una vista permanente:
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
Informazioni API:
Il valore dell'attributo class deve
costituire il nome completo della classe che implementa org.eclipse.ui.IViewPart. Spesso viene creata una sottoclasse
org.eclipse.ui.part.ViewPart per una nuova vista.
Implementazione fornita:
La piattaforma Eclipse fornisce una serie
di viste standard, come Selezione, Proprietà, Struttura e Attività. Per l'utente queste viste non differiscono da quelle fornite dai plugin. Tutte
le viste possono essere mostrate dal sottomenu "Mostra vista" del
menu "Finestra". La posizione della vista è persistente: viene salvata quando
si chiude la vista e ripristinata quando la vista viene riaperta in una
sessione singola. La posizione è persistente anche tra le sessioni del workbench.
Copyright (c) 2002, 2005 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