Fichier JScript
L'Assistant personnalisé accède au moteur de script et crée un fichier JScript appelé Default.js pour chaque projet. Il inclut aussi Common.js. Ces fichiers contiennent des fonctions JScript permettant d'accéder aux modèles objet Visual Studio et Visual C++ pour personnaliser un Assistant. (Consultez Conception d'un Assistant pour une liste de ces modèles). Vous pouvez ajouter vos fonctions au fichier Default.js du projet d'Assistant. Pour accéder aux propriétés et méthodes du modèle objet d'Assistant ou d'environnement à partir d'un fichier JScript, faites précéder le nom du modèle objet respectivement de « wizard. » et « dte. ».
Par exemple :
function CreateCustomProject(strProjectName, strProjectPath)
{
try
{
var strProjTemplatePath = wizard.FindSymbol('PROJECT_TEMPLATE_PATH');
var strProjTemplate = '';
strProjTemplate = strProjTemplatePath + '\\default.vcproj';
var Solution = dte.Solution;
var strSolutionName = "";
if (wizard.FindSymbol("CLOSE_SOLUTION"))
...
Quand vous cliquez sur Terminer dans l'Assistant personnalisé, l'Assistant crée le fichier Default.js dans le dossier des fichiers de script de l'Explorateur de solutions. Ce fichier JScript crée des projets et restitue des modèles, puis les ajoute à la solution quand un utilisateur clique sur Terminer dans votre Assistant.
Par défaut, le fichier Default.js du projet inclut les fonctions suivantes :
Nom de la fonction |
Description |
|---|---|
AddConfig |
Ajoute les configurations du projet. Vous pouvez fournir des paramètres de compilateur et d'éditeur de lien. |
AddFilesToCustomProj |
Ajoute les fichiers spécifiés au projet quand l'utilisateur clique sur Terminer. |
AddFilters |
Ajoute les filtres sources spécifiés au projet quand l'utilisateur clique sur Terminer. |
CreateCustomProject |
Crée le projet à l'emplacement spécifié quand l'utilisateur clique sur Terminer. |
CreateCustomInfFile |
Crée le fichier Templates.inf du fichier. |
DelFile |
Supprime le fichier spécifié. |
GetTargetName |
Donne le nom du fichier spécifié. |
OnFinish |
Appelé par l'Assistant quand l'utilisateur clique sur Terminer pour créer le projet, ajouter les fichiers et les filtres, restituer les modèles et définir la configuration. |
PchSettings |
Définit les paramètres de l'en-tête précompilé. Consultez SetCommonPchSettings dans le Guide de référence de Common.js pour plus d'informations. |
Chaque Assistant utilise un fichier Default.js unique, qui inclut des commentaires TODO pour vous aider à identifier les endroits où vous devez personnaliser le fichier.
Visual C++ inclut aussi Common.js, fichier partagé par tous les Assistants et inclus dans votre projet d'Assistant. Vous pouvez utiliser les fonctions de Common.js.
Notes
Common.js contient des descriptions de chaque fonction et de ses paramètres. Consultez les commentaires de Common.js pour plus d'informations.
Si vous avez des fonctions que vous souhaitez partager entre vos projets d'Assistant, vous pouvez les ajouter à Common.js. Créez votre propre version de Common.js et enregistrez-la dans un chemin d'accès commun, puis affectez au SCRIPT_COMMON_PATH ce chemin d'accès dans votre fichier .vsz.
Notes
Les Assistants inclus avec Visual C++ utilisent les fonctions JScript dans Common.js. Si vous modifiez ces fonctions, les Assistants de Visual C++ peuvent se comporter de façon inattendue.
Pour plus d'informations sur JScript, consultez Écriture, compilation et débogage de code JScript.
Débogage de script
Pour déboguer un script dans des fichiers html de l'Assistant, vous devez activer la fonction de débogage de script.
Pour activer le débogage de script
Dans Internet Explorer, cliquez sur le menu Outils puis sur Options Internet.
Cliquez sur l'onglet Avancés.
Dans la catégorie Navigation, désactivez la case à cocher Désactiver le débogueur de script.
Les fichiers common.js et default.js s'afficheront ainsi dans la fenêtre Documents en cours d'exécution lorsque vous cliquerez sur le bouton Terminer de l'Assistant.
Voir aussi
Tâches
Création d'un Assistant personnalisé