Benutzerdefinierte Parameter in der VSZ-Assistentendatei
Aktualisiert: November 2007
In den ersten beiden Zeilen der VSZ-Datei werden die Assistentenversion und die ProgID oder CLSID des parallel zu erstellenden Assistenten identifiziert. Die VSZ-Datei kann außerdem optionale Kontextparameter und benutzerdefinierte Parameter umfassen, die der Symboltabelle (zusammen mit den im HTML-Symbolabschnitt bereitgestellten Symbolen) hinzugefügt werden.
Durch die Execute-Methode wird der Assistent eingeblendet, der ein Array der in der VSZ-Datei definierten Kontext- und benutzerdefinierten Parameter als Parameter verwendet.
Die folgenden häufig verwendeten Symbole werden entweder in der VSZ-Datei oder in den HTM-Dateien als benutzerdefinierte Parameter festgelegt und können in den HTML-, Skript- oder Vorlagendateien des Assistenten verwendet werden.
Beispiel
Wie aus den folgenden Einträgen in der VSZ-Datei ersichtlich, besitzt der Assistent mit dem Namen "MyProjWiz" eine Benutzeroberfläche.
VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine
Param="WIZARD_NAME = MyProjWiz"
Param="WIZARD_UI = TRUE"
Symbole für benutzerdefinierte Parameter in der VSZ-Assistentendatei
Symbol |
Definition |
|---|---|
ABSOLUTE_PATH |
Der Speicherort der Assistentendateien. |
HTML_FILTER |
Wird in der VSZ-Datei festgelegt. Dateitypen, die im Ordner HTML-Dateien im Projektmappen-Explorer abgelegt werden. Normalerweise im Format "HTM". |
HTML_PATH |
Wird in der VSZ-Datei festgelegt. Der Speicherort der assistentenspezifischen HTML-Dateien. Er lautet standardmäßig START_PATH\HTML\SPRACHE (wobei SPRACHE dem in der Systemregistrierung festgelegten Gebietsschema entspricht). .gif "Hinweis") Hinweis:
Sie können eine andere Sprache angeben, indem Sie <LangID> auf den Dezimalwert von HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\7.0\General\UILanguage festlegen. Weitere Informationen finden Sie unter Lokalisieren eines Assistenten in mehrere Sprachen. Eine Liste der Dezimalwerte für Sprachen finden Sie unter Assistentenunterstützung für andere Sprachen.
|
IMAGE_FILTER |
Wird in der VSZ-Datei festgelegt. Dateitypen, die im Ordner Bilddateien im Projektmappen-Explorer abgelegt werden. Normalerweise im Format "BMP;GIF". |
IMAGES_PATH |
Wird in der VSZ-Datei festgelegt. Der Speicherort der Bilddateien, die in den HTML-Dateien verwendet werden. Er lautet standardmäßig START_PATH\Images. |
MISC_FILTER |
Wird in der VSZ-Datei festgelegt. Dateitypen, die im Ordner für sonstige Dateien im Projektmappen-Explorer abgelegt werden. Normalerweise im Format "VSZ;VSDIR;ICO;VCPROJ;CSPROJ;CSS;INF". |
PRODUCT |
Ist standardmäßig auf Visual C++ festgelegt; Sie können diesen Wert jedoch auf Visual Basic setzen, um Visual Basic-Assistenten usw. zu erstellen. |
PRODUCT_INSTALLATION_DIR |
Das Verzeichnis, das in der Registrierung unter HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.0\Setup\<Product>\ProductDir aufgeführt ist. |
PROJECT_TEMPLATE_NAME |
Wird in der VSZ-Datei festgelegt. Die Projektvorlagendatei, die der Assistent zum Erstellen von Projekten verwendet. Normalerweise im Format "TXT". |
PROJECT_TEMPLATE_PATH |
Das Verzeichnis, das die Vorlagendateien des Projekts enthält. Für Visual C++ lautet es standardmäßig PRODUCT_INSTALLATION_DIR\VCWizards. |
RELATIVE_PATH |
Wenn ABSOLUTE_PATH nicht gefunden wird, wird RELATIVE_PATH verwendet. Der Pfad relativ zu PRODUCT_INSTALLATION_DIR. RELATIVE_PATH lautet für Visual C++ PRODUCT_INSTALLATION_DIR\VCWizards. |
SCRIPT_COMMON_PATH |
Der Name des Verzeichnisses relativ zu PRODUCT_INSTALLATION_DIR, in dem sich die allgemeine Skriptdatei befindet. Für Visual C++ lautet er beispielsweise VCWizards. |
SCRIPT_FILTER |
Wird in der VSZ-Datei festgelegt. Dateitypen, die im Ordner Skriptdateien im Projektmappen-Explorer abgelegt werden. Normalerweise im Format "JS" (JScript) oder "VBS" (VBScript). |
SCRIPT_PATH |
Der Speicherort der JScript-Datei des Assistenten. Er lautet standardmäßig START_PATH\Scripts. |
START_PATH |
Wird in der VSZ-Datei festgelegt. Wird nicht vom Benutzer festgelegt, sondern intern verwendet, um entweder RELATIVE_PATH oder ABSOLUTE_PATH zu identifizieren. Der Name des Assistenten (WIZARD_NAME) wird an diesen Wert angefügt. |
TEMPLATE_FILTER |
Wird in der VSZ-Datei festgelegt. Dateitypen, die im Ordner Vorlagendateien im Projektmappen-Explorer abgelegt werden. Normalerweise im Format "TXT". |
TEMPLATES_PATH |
Wird in der VSZ-Datei festgelegt. Der Speicherort der assistentenspezifischen Vorlagendateien. Er lautet standardmäßig START_PATH\Templates\<LangID>. Hinweis:
Weitere Informationen zu LangID finden Sie in den Erläuterungen zu HTML_PATH.
|
WIZARD_NAME |
Gibt den Namen des Assistenten an. Befindet sich in der VSZ-Datei und wird von den übrigen Symbolen verwendet. |
WIZARD_UI |
Wird in der VSZ-Datei festgelegt. Ein boolescher Wert, der angibt, ob der Assistent eine Benutzeroberfläche besitzt. TRUE gibt an, dass der Assistent eine Benutzeroberfläche besitzt, und FALSE gibt an, dass keine vorhanden ist. |
Siehe auch
Aufgaben
Erstellen eines benutzerdefinierten Assistenten
Konzepte
Für den Assistenten erstellte Dateien