Creazioni guidate
Identificativo:
org.eclipse.ui.newWizards
Descrizione:
Questo punto di estensione
viene utilizzato per registrare estensioni di creazioni guidate. Le creazioni guidate vengono visualizzate come scelte all'interno della finestra di dialogo Nuovo e sono generalmente utilizzate per creare cartelle e file.
Nella finestra di dialogo Nuovo, le procedure guidate sono organizzate in
categorie che in genere riflettono un particolare problema. Ad esempio, un
plugin di orientamento Java potrebbe definire una categoria denominata "Java"
che risulta appropriata per le creazioni guidate di "Classe" o "Pacchetto". Altri plugin possono fare riferimento alle categorie definite da un unico
plugin mediante l'attributo categoria. Le procedure guidate senza categorie, oppure
quelle con percorsi di categoria non validi, confluiranno in una
categoria "Altro".
Le procedure guidate possono opzionalmente specificare un elemento secondario descrittivo che contenga un breve testo sulla procedura guidata.
Tag di configurazione:
<!ELEMENT extension (category | wizard | primaryWizard)*>
<!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 - il nome della categoria che verrà utilizzato nella finestra di dialogo.
- parentCategory - il percorso ad un'altra categoria se questa dovesse essere aggiunta come secondaria.
<!ELEMENT wizard (description? , selection*)>
<!ATTLIST wizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
category CDATA #IMPLIED
class CDATA #REQUIRED
project (true | false)
finalPerspective CDATA #IMPLIED
preferredPerspectives CDATA #IMPLIED
helpHref CDATA #IMPLIED
descriptionImage CDATA #IMPLIED
canFinishEarly (true | false)
hasPages (true | false) >
- id - un nome univoco che può essere utilizzato per identificare questa procedura guidata.
- name - il nome della categoria che verrà utilizzato nella finestra
di dialogo.
- icon - un percorso relativo dell'icona che verrà utilizzata con il nome per rappresentare la
procedura guidata come una delle scelte disponibili nella finestra di dialogo della creazione.
- category - un percorso delimitato da barre ('/') degli ID di categoria. Ciascun token
del percorso deve rappresentare un ID di categoria valido, definito precedentemente da questo o qualche altro plugin. Se omesso, la procedura guidata sarà aggiunta alla categoria "Altro".
- class - il nome completo della classe Java che implementa org.eclipse.ui.INewWizard.
- project - un attributo facoltativo che indica che la procedura guidata creerà una risorsa IProject.
Visualizza, inoltre, la procedura guidata come una scelta all'interno della
finestra di dialogo Nuovo progetto.
- finalPerspective - un attributo facoltativo che identifica una prospettiva da attivare al termine della creazione della risorsa IProject.
- preferredPerspectives - un attributo facoltativo che specifica un
elenco separato da virgole degli ID di prospettiva. Se la prospettiva corrente
è presente nell'elenco, non viene attivata alcuna prospettiva al termine della
creazione della risorsa IProject.
- helpHref - un'URL della guida che descrive nel dettaglio la procedura guidata.
Da 3.0
- descriptionImage - una immagine più estesa che descrive la procedura guidata.
Da 3.0
- canFinishEarly - indica se la procedura guidata è in grado di terminare senza mai mostrare pagine all'utente.
- hasPages - indica se la procedura guidata fornisce pagine.
<!ELEMENT description (#PCDATA)>
un elemento secondario facoltativo che fornisce una breve descrizione dell'azione della
procedura guidata
<!ELEMENT selection EMPTY>
<!ATTLIST selection
class CDATA #REQUIRED
name CDATA #IMPLIED>
- class - un nome completo di classe. Se ciascun oggetto selezionato
nel workbench implementa questa interfaccia, la selezione viene passata alla
procedura guidata. In caso contrario, viene passata una selezione vuota.
- name - un filtro di nomi facoltativo. Ciascun oggetto selezionato
nel workbench deve corrispondere al filtro del nome per essere passato alla
procedura guidata.
<!ELEMENT primaryWizard EMPTY>
<!ATTLIST primaryWizard
id CDATA #REQUIRED>
un sistema di dichiarazione della procedura guidata come "primaria" nell'interfaccia utente. Una procedura
guidata primaria è evidenziata nella finestra di dialogo della nuova procedura guidata. Si noti che questo elemento non deve essere utilizzato dagli sviluppatori di plugin. Questo elemento è
stato realizzato affinché i responsabili dei prodotti potessero evidenziare un insieme di procedure guidate
per i propri prodotti.
- id - l'id della procedura guidata che deve essere considerata primaria.
Esempi:
Di seguito è riportato un esempio di
configurazione delle creazioni guidate:
<extension point=
"org.eclipse.ui.newWizards"
>
<category
id=
"com.xyz.XYZ"
name=
"XYZ Wizards"
>
</category>
<category
id=
"com.xyz.XYZ.Web"
name=
"Web Wizards"
parentCategory=
"com.xyz.XYZ"
>
</category>
<wizard
id=
"com.xyz.wizard1"
name=
"XYZ artifact"
category=
"com.xyz.XYZ/com.xyz.XYZ.Web"
icon=
"./icons/XYZwizard1.gif"
class=
"com.xyz.XYZWizard1"
>
<description>
Crea XYZ e imposta il contenuto iniziale
</description>
<selection class=
"org.eclipse.core.resources.IResource"
/>
</wizard>
</extension>
Informazioni API:
il valore
dell'attributo class deve corrispondere al nome della classe che implementa
org.eclipse.ui.INewWizard.
La procedura guidata viene creata tramite Nuova procedura guidata e verrà inserita nella procedura guidata
esistente.
Se la procedura guidata viene avviata come collegamento (dal menu File - Nuovo
o con il pulsante della barra degli strumenti) apparirà in una finestra di
dialogo separata.
Implementazione fornita:
Il
workbench è fornito di procedure guidate per creare risorse vuote dei seguenti tipi: progetti, cartelle e
file. Queste procedure guidate vengono registrate mediante il meccanismo sopra illustrato.
È possibile anche visualizzare ulteriori procedure guidate, in relazione alla specifica installazione della piattaforma.
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