Paramètres personnalisés dans le fichier .Vsz de l'Assistant
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). .gif "Remarque") Remarque
Vous pouvez spécifier une langue différente en définissant <LangID> avec la valeur décimale de HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\7.0\General\UILanguage.Pour plus d'informations, consultez Localisation d'un Assistant dans plusieurs langues.Pour obtenir la liste des valeurs décimales de langue, consultez Prise en charge d'autres langues par l'Assistant.
|
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 d'accès relatif à PRODUCT_INSTALLATION_DIR. Pour Visual C++, RELATIVE_PATH est 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>. Remarque
Consultez HTML_PATH pour plus d'informations sur 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é