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 nella finestra di dialogo Nuovo e vengono comunemente utilizzate per creare nuovi progetti, 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 category. Le procedura guidate senza categorie, oppure quelle con percorsi di categoria non validi, termineranno in una categoria "Altro".

Le procedura guidate possono opzionalmente specificare un sottoelemento descrittivo che contenga un breve testo sulla procedura guidata.

Tag di configurazione:

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

   <!ELEMENT wizard (description)?>
   <!ATTLIST wizard
      id                 CDATA #REQUIRED
      name               CDATA #REQUIRED
      icon               CDATA #IMPLIED
      category           CDATA #IMPLIED
      class              CDATA #REQUIRED
      project            (true | false) #IMPLIED
      finalPerspective   CDATA #OPTIONAL
   >
   <!ELEMENT description (#PCDATA)>    <!ELEMENT selection EMPTY>
   <!ATTLIST selection
      class  CDATA #REQUIRED
      name   CDATA #OPTIONAL
   > Esempi:

di seguito è riportato un esempio di una configurazione di creazione guidata:

   <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>
              Create a simple XYZ artifact and set initial content
          </description>
      </wizard>
   </extension>

Informazione API: il valore dell'attributo class deve rappresentare una classe che implementa org.eclipse.ui.INewWizard. Se la procedura guidata viene creata dall'interno della finestra Nuova procedura guidata, viene inserita nella procedura guidata esistente.  Se viene avviata come un collegamento (dal menu File - Nuovo o dal pulsante sulla barra degli strumenti), viene visualizzata in una finestra di dialogo separata.

L'attributo finalPerspective identifica una prospettiva da attivare al termine della creazione della risorsa IProject all'interno della classe di procedura guidata. L'attivazione di questa prospettiva deve essere interpretata secondo le preferenze del workbench definite da IWorkbenchPreferenceConstants.PROJECT_OPEN_NEW_PERSPECTIVE, che potrebbe significare "Apri in una nuova finestra", "Apri nella finestra corrente", "Sostituisci la prospettiva corrente" oppure "Nessuna operazione". Si tratta solo di un suggerimento, ma si consiglia agli sviluppatori di leggerlo e metterlo in pratica, oppure di richiamare l'API BasicNewProjectResourceWizard#updatePerspective(IConfigurationElement) affinché effettui l'operazione.

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 IBM Corp. 2000, 2001. Tutti i diritti riservati.