Condividi tramite

Interfaccia della procedura guidata (IDTWizard)

  • Articolo

L'ambiente di sviluppo integrato (IDE) usa l'interfaccia IDTWizard per comunicare con le procedure guidate. Le procedure guidate devono implementare questa interfaccia per poter essere installata nell'IDE.

Il Execute metodo è l'unico metodo associato all'interfaccia IDTWizard . Le procedure guidate implementano questo metodo e l'IDE chiama il metodo sull'interfaccia . Nell'esempio seguente viene illustrata la firma del metodo .

/* IDTWizard Method */
STDMETHOD(Execute)(THIS_
   /* [in] */ IDispatch *Application,
   /* [in] */ long hwndOwner,
   /* [in] */ SAFEARRAY * *ContextParams,
   /* [in] */ SAFEARRAY * *CustomParams,
   /* [out] [in] */ wizardResult *RetVal
   );

Il meccanismo di avvio è simile per le procedure guidate Nuovo progetto e Aggiungi nuovo elemento . Per iniziare, chiamare l'interfaccia IDTWizard definita in Dteinternal.h. L'unica differenza è il set di parametri di contesto e personalizzati passati all'interfaccia quando viene chiamata l'interfaccia.

Le informazioni seguenti descrivono l'interfaccia IDTWizard che le procedure guidate devono implementare per funzionare nell'IDE di Visual Studio. L'IDE chiama il Execute metodo nella procedura guidata, passandolo:

  • Oggetto DTE

    L'oggetto DTE è la radice del modello di automazione.

  • Handle per la finestra di dialogo, come illustrato nel segmento di codice , hwndOwner ([in] long).

    La procedura guidata viene utilizzata hwndOwner come padre per la finestra di dialogo della procedura guidata.

  • I parametri di contesto passati all'interfaccia come variante per SAFEARRAY, come illustrato nel segmento di codice , [in] SAFEARRAY (VARIANT)* ContextParams.

    I parametri di contesto contengono una matrice di valori specifici per il tipo di procedura guidata avviata e lo stato corrente del progetto. L'IDE passa i parametri di contesto alla procedura guidata. Per altre informazioni, vedere Parametri di contesto.

  • Parametri personalizzati passati all'interfaccia come variante per SAFEARRAY, come illustrato nel segmento di codice . [in] SAFEARRAY (VARIANT)* CustomParams

    I parametri personalizzati contengono una matrice di parametri definiti dall'utente. Un file con estensione vsz passa parametri personalizzati all'IDE. I valori sono determinati dalle Param= istruzioni . Per altre informazioni, vedere Parametri personalizzati.

  • I valori restituiti per l'interfaccia sono

    wizardResultSuccess = -1,
wizardResultFailure = 0
wizardResultCancel = 1
wizardResultBackout = 2

Vedi anche