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 plug-in di orientamento Java potrebbe definire una categoria denominata "Java" che risulta appropriata per le creazioni guidate di "Classe" o "Pacchetto". Altri plug-in possono fare riferimento alle categorie definite da un unico plug-in 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)*>

   <!ATTLIST extension
     point CDATA #REQUIRED
     id    CDATA #IMPLIED
     name  CDATA #IMPLIED
   >

   <!ELEMENT category EMPTY>

   <!ATTLIST category
      id             CDATA #REQUIRED
     name           CDATA #REQUIRED
     parentCategory CDATA #IMPLIED
   >

   <!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
   >

   <!ELEMENT description (#CDATA)>

   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
   >

Esempi: di seguito è riportato un esempio di configurazione della procedura guidata di creazione:

   <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. Se la procedura guidata viene creata tramite Nuovo, 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, 2003 IBM Corporation e altri. Tutti i diritti riservati. Questo programma e il materiale di accompagnamento sono disponibili secondo i termini della Common Public License v1.0 che sono distribuiti con il prodotto, e disponibili all'indirizzo http://www.eclipse.org/legal/cpl-v10.html