Interface de l'Assistant (IDTWizard)
L'environnement de (IDE) développement intégré (IDE) utilise l'interface d' IDTWizard de communiquer avec des Assistant. Les assistants doivent implémenter cette interface pour être installés dans l'IDE.
La méthode d' Execute est la seule méthode associée à l'interface d' IDTWizard . Les assistants implémentent cette méthode et l'IDE appelle la méthode sur l'interface. L'exemple suivant affiche 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ébut est semblable pour les assistants de Nouveau projet et d' Ajouter un nouvel élément . Pour démarrer l'un ou l'autre, vous appelez l'interface d' IDTWizard définie dans Dteinternal.h. La seule différence est un ensemble de paramètres de contexte et personnalisés qui sont passées à l'interface lorsque l'interface est appelée.
Les informations suivantes décrivent l'interface d' IDTWizard que les assistants doivent implémenter pour travailler dans Visual Studio l'IDE. L'IDE appelle la méthode d' Execute dans l'Assistant, en lui passant les éléments suivants :
L'objet DTE
L'objet DTE est la racine du modèle Automation.
Le handle de la boîte de dialogue de fenêtre comme indiqué dans le segment de code, hwndOwner ([in] long).
L'Assistant utilise cet hwndOwner en tant que parent pour la boîte de dialogue Assistant.
Les paramètres de contexte sont passés à l'interface comme variant pour SAFEARRAY comme indiqué dans le segment de code, [in] SAFEARRAY (VARIANT)* ContextParams.
Les paramètres de contexte contiennent un tableau de valeurs qui sont spécifiques au type d'Assistant qui est démarré et de l'état actuel du projet. L'IDE passe les paramètres de contexte à l'Assistant. Pour plus d'informations, consultez paramètres de contexte.
Les paramètres personnalisés sont passés à l'interface comme variant 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 passe des paramètres personnalisés dans l'IDE. les valeurs sont déterminées par les instructions d' Param= . 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