Partager via


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).

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 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>.

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é

Concepts

Fichiers créés pour votre Assistant

Conception d'un Assistant

Référence

Assistant personnalisé

Execute