Interface de l’Assistant (IDTWizard)

  • Article

L’environnement de développement intégré (IDE) utilise l’interface IDTWizard pour communiquer avec les Assistants. Les Assistants doivent implémenter cette interface pour être installés dans l’IDE.

La Execute méthode est la seule méthode associée à l’interface IDTWizard . Les Assistants implémentent cette méthode et l’IDE appelle la méthode sur l’interface. L’exemple suivant montre la signature de la méthode.

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

Le mécanisme de démarrage est similaire pour les Assistants Nouveau projet et Ajouter un nouvel élément . Pour démarrer l’une ou l’autre, vous appelez l’interface IDTWizard définie dans Dteinternal.h. La seule différence est l’ensemble de paramètres de contexte et personnalisés passés à l’interface lorsque l’interface est appelée.

Les informations suivantes décrivent l’interface IDTWizard que les Assistants doivent implémenter pour fonctionner dans l’IDE Visual Studio. L’IDE appelle la Execute méthode sur l’Assistant, en le transmettant comme suit :

  • Objet DTE

    L’objet DTE est la racine du modèle Automation.

  • Handle de la boîte de dialogue fenêtre, comme indiqué dans le segment de code. hwndOwner ([in] long)

    L’Assistant l’utilise hwndOwner comme parent de la boîte de dialogue de l’Assistant.

  • Les paramètres de contexte passés à l’interface comme variante pour SAFEARRAY, comme indiqué dans le segment de code, [in] SAFEARRAY (VARIANT)* ContextParams.

    Les paramètres de contexte contiennent un tableau de valeurs spécifiques au type d’Assistant démarré et à l’état actuel du projet. L’IDE transmet les paramètres de contexte à l’Assistant. Pour plus d’informations, consultez Paramètres de contexte.

  • Paramètres personnalisés passés à l’interface en tant que variante pour SAFEARRAY, comme indiqué dans le segment de code. [in] SAFEARRAY (VARIANT)* CustomParams

    Les paramètres personnalisés contiennent un tableau de paramètres définis par l’utilisateur. Un fichier .vsz transmet des paramètres personnalisés à l’IDE. Les valeurs sont déterminées par les Param= instructions. Pour plus d’informations, consultez Paramètres personnalisés.

  • Les valeurs de retour de l’interface sont

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

Voir aussi