Benutzerdefinierte Parameter in der VSZ-Assistentendatei
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).
|
||
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.Dies ist der Pfad relativ zu PRODUCT_INSTALLATION_DIR.Bei Visual C++ hat RELATIVE_PATH den Wert 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>.
|
||
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. |
.gif "Hinweis")
HinweisSiehe auch
Aufgaben
Erstellen eines benutzerdefinierten Assistenten