Paramètres personnalisés dans le fichier .vsz de l'Assistant
Mise à jour : novembre 2007
Dans ses deux premières lignes, le fichier .vsz identifie la version de l'Assistant et le ProgID ou CLSID de l'Assistant à co-créer. Le fichier .vsz peut aussi inclure des paramètres de contexte facultatifs ainsi que des paramètres personnalisés ajoutés à la table de symboles (en plus des symboles fournis dans la section de symboles HTML).
La méthode Execute affiche l'Assistant, qui prend un tableau du contexte et les paramètres personnalisés définis dans le fichier .vsz comme ses paramètres.
Les symboles ci-dessous sont couramment utilisés et spécifiés comme paramètres personnalisés dans le fichier .vsz ou les fichiers .htm, ils sont utilisables dans les fichiers HTML, scripts ou modèles de l'Assistant.
Exemple
Comme l'indiquent les entrées du fichier .vsz ci-dessous, l'Assistant MyProjWiz contient une interface utilisateur.
VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine
Param="WIZARD_NAME = MyProjWiz"
Param="WIZARD_UI = TRUE"
Symboles de paramètres personnalisés dans le fichier .vsz de l'Assistant
Symbole |
Définition |
||
---|---|---|---|
ABSOLUTE_PATH |
Emplacement des fichiers de l'Assistant. |
||
HTML_FILTER |
Spécifié dans le fichier .vsz. Types de fichiers placés dans le dossier des fichiers HTML de l'Explorateur de solutions. Le plus souvent « htm ». |
||
HTML_PATH |
Spécifié dans le fichier .vsz. Emplacement des fichiers HTML de l'Assistant. Par défaut, c'est START_PATH\HTML\LANGUAGE (où LANGUAGE est le paramètre régional spécifié par la base de registres).
|
||
IMAGE_FILTER |
Spécifié dans le fichier .vsz. Types de fichiers placés dans le dossier des fichiers images de l'Explorateur de solutions. Le plus souvent « bmp;gif » |
||
IMAGES_PATH |
Spécifié dans le fichier .vsz. Emplacement des fichiers images utilisés dans les fichiers html. Par défaut, START_PATH\Images. |
||
MISC_FILTER |
Spécifié dans le fichier .vsz. Types de fichiers placés dans le dossier Fichiers divers de l'Explorateur de solutions. Le plus souvent « vsz;vsdir;ico;vcproj;csproj;css;inf ». |
||
PRODUCT |
Par défaut, défini comme Visual C++ ; peut aussi être défini comme Visual Basic pour créer des Assistants Visual Basic, et ainsi de suite. |
||
PRODUCT_INSTALLATION_DIR |
Répertoire énuméré dans la liste de la base de registres HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.0\Setup\<Product>\ ProductDir. |
||
PROJECT_TEMPLATE_NAME |
Spécifié dans le fichier .vsz. Fichier modèle du projet utilisé par votre Assistant pour créer des projets. Le plus souvent « txt ». |
||
PROJECT_TEMPLATE_PATH |
Répertoire qui contient les fichiers modèles du projet. Pour Visual C++, c'est par défaut PRODUCT_INSTALLATION_DIR\VCWizards. |
||
RELATIVE_PATH |
Si ABSOLUTE_PATH est introuvable, c'est RELATIVE_PATH qui est essayé. C'est le chemin relatif à PRODUCT_INSTALLATION_DIR. Pour Visual C++, RELATIVE_PATH correspond à PRODUCT_INSTALLATION_DIR\VCWizards. |
||
SCRIPT_COMMON_PATH |
Nom du répertoire par rapport à PRODUCT_INSTALLATION_DIR, qui contient le fichier de script commun. Pour Visual C++, c'est par exemple VCWizards. |
||
SCRIPT_FILTER |
Spécifié dans le fichier .vsz. Types de fichiers placés dans le dossier des fichiers de script de l'Explorateur de solutions. Le plus souvent « js » (JScript) ou « vbs » (VBScript). |
||
SCRIPT_PATH |
Emplacement du fichier JScript de l'Assistant. Par défaut, c'est START_PATH\Scripts |
||
START_PATH |
Spécifié dans le fichier .vsz. Non défini par l'utilisateur, mais utilisé en interne pour identifier RELATIVE_PATH ou ABSOLUTE_PATH. Le nom de l'Assistant (WIZARD_NAME) est ajouté à cette valeur. |
||
TEMPLATE_FILTER |
Spécifié dans le fichier .vsz. Types de fichiers placés dans le dossier des fichiers modèles de l'Explorateur de solutions. Le plus souvent « txt ». |
||
TEMPLATES_PATH |
Spécifié dans le fichier .vsz. Emplacement des fichiers modèles de l'Assistant. Par défaut, c'est START_PATH\Templates\<LangID>.
|
||
WIZARD_NAME |
Spécifie le nom de l'Assistant. Situé dans le fichier .vsz, utilisé par le reste des symboles. |
||
WIZARD_UI |
Spécifié dans le fichier .vsz. Valeur booléenne indiquant si l'Assistant contient une interface utilisateur. Spécifiez TRUE pour une interface utilisateur ou FALSE en l'absence d'interface utilisateur. |
Voir aussi
Tâches
Création d'un Assistant personnalisé
Concepts
Fichiers créés pour votre Assistant