Partager via

Paramètres de contexte permettant le lancement des Assistants

  • Article

Les macros complémentaires Visual Studio sont déconseillées dans Visual Studio 2013. Vous devriez mettre vos macros complémentaires à niveau vers des extensions VSPackage. Pour plus d'informations sur les mises à jour, consultez FAQ : conversion de compléments en extensions VSPackage.

Les paramètres de contexte fournissent les informations nécessaires au lancement d'un Assistant, telles que le type d'Assistant à utiliser, le nom du projet, les répertoires des éléments de l'Assistant, etc.

Il existe trois types d'Assistants :

  • NewProject — Ajoute un nouveau projet à une solution.

  • AddSubProject — Ajoute un sous-projet à un projet existant.

  • AddItem — Ajoute un élément à un projet existant.

Ces trois types d'Assistant sont appelés par le biais de la méthode Execute de l'interface IDTWizard. Un paramètre requis de la méthode Execute est ContextParams. Chaque type requiert un jeu de valeurs ContextParams différent dans un ordre correct comme le souligne le tableau suivant :

Type d'Assistant

Paramètres utilisés

NewProject

  • WizardType

  • Nom du projet

  • LocalDirectory

  • InstallationDirectory

  • FExclusive

  • SolutionName

  • Silent

AddSubProject

  • WizardType

  • Nom du projet

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

AddItem

  • WizardType

  • Nom du projet

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

Le tableau suivant énumère les différents paramètres de contexte et leur description.

Paramètre

Description

WizardType

Constante indiquant le type de l'Assistant. Il existe trois types :

  • vsWizardNewProject (GUID = "{0F90E1D0-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddItem (GUID = "{0F90E1D1-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddSubProject (GUID = "{0F90E1D2-4999-11D1-B6D1-00A0C90F2744}")

ProjectName

Nom du projet.

ProjectItems

Pointeur vers la collection ProjectItems sur laquelle l'Assistant va opérer. Il est passé à l'Assistant à partir de la sélection hiérarchique du projet.

LocalDirectory

Emplacement, sur le système local, où résident les fichiers projet utilisés par l'Assistant.

ItemName

Nom de l'élément à ajouter. ItemName est le nom de fichier que l'utilisateur tape (ou qui est accepté par défaut) dans la boîte de dialogue Ajouter un élément. Selon les indicateurs définis dans le fichier VSDIR, ce paramètre peut être de valeur NULL.

InstallationDirectory

Chemin d'accès au répertoire où Visual Studio est installé.

FExclusive

Valeur booléenne indiquant si le projet doit être exclusif à lui-même. En d'autres termes, soit le projet est ajouté à la solution en cours, soit le système ferme la solution en cours, en crée une nouvelle, puis lui ajoute le projet.

SolutionName

Nom du fichier solution ne spécifiant ni le répertoire ni l'extension .sln. (Le nom de fichier .suo repose également sur ce nom racine.) Si le paramètre SolutionName contient une valeur (autrement dit, s'il ne s'agit pas d'une chaîne vide), l'Assistant NewProject appelle Create avant d'ajouter le projet à l'aide de AddFromTemplate. À l'inverse, si le paramètre SolutionName est une chaîne vide, vous n'avez pas besoin d'appeler Create avant d'appeler AddFromTemplate.

Silent

Valeur booléenne indiquant si l'Assistant doit être exécuté de manière silencieuse, sans afficher d'interface utilisateur et en utilisant toutes les valeurs par défaut. La valeur par défaut de Silent est True.

Voir aussi

Référence

Execute

IDTWizard

Concepts

Ajout d'Assistants aux boîtes de dialogue Ajouter un élément et Nouveau projet à l'aide de fichiers .Vsdir