Настраиваемые параметры в файле .vsz мастера
Обновлен: Ноябрь 2007
В первых двух строках файла VSZ указывается версия мастера, а также создаваемые идентификаторы ProgID и CLSID мастера. Файл VSZ также может включать дополнительные параметры контекста и настраиваемые параметры, добавляемые в таблицу символов (наряду с символами, представленными в разделе символов HTML).
Метод Execute служит для отображения мастера, который принимает в качестве параметров массив параметров контекста и настраиваемых параметров, определенных в файле .vsz.
Следующие распространенные символы указываются в качестве настраиваемых параметров в файле .vsz file или в файле .htm и могут использоваться в файлах шаблонов, сценариев или в HTML-файлах мастеров.
Пример
Как следует из следующих записей файла .vsz, мастер с именем MyProjWiz содержит пользовательский интерфейс.
VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine
Param="WIZARD_NAME = MyProjWiz"
Param="WIZARD_UI = TRUE"
Символы настраиваемых параметров в файле .vsz мастера
Символ |
Определение |
|---|---|
ABSOLUTE_PATH |
Расположение файлов мастера. |
HTML_FILTER |
Указывается в файле .vsz. Типы файлов, размещаемые в папке "Файлы HTML" в обозревателе решений. Обычно задается в виде "htm". |
HTML_PATH |
Указывается в файле .vsz. Расположение HTML-файлов мастера. По умолчанию принимается START_PATH\HTML\LANGUAGE (где LANGUAGE — это языковой стандарт, указанный в системном реестре). .gif "Примечание") Примечание.
Можно задать другие языковые настройки, установив для <LangID> десятичное значение из ключа HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\7.0\General\UILanguage. Дополнительные сведения см. в разделе Локализация мастера на несколько языков. Список десятичных значений и соответствующих им языков см. в разделе Поддержка мастера для других языков.
|
IMAGE_FILTER |
Указывается в файле .vsz. Типы файлов, размещаемые в папке "Файлы изображений" в обозревателе решений. Обычно используется "bmp;gif". |
IMAGES_PATH |
Указывается в файле .vsz. Местоположение файлов изображений, используемых в HTML-файлах. По умолчанию используется START_PATH\Images. |
MISC_FILTER |
Указывается в файле .vsz. Типы файлов, размещаемые в папке "Разное" в обозревателе решений. Обычно используется "vsz;vsdir;ico;vcproj;csproj;css;inf". |
PRODUCT |
По умолчанию задается как Visual C++. Однако можно установить значение Visual Basic для создания мастеров Visual Basic и т.д. |
PRODUCT_INSTALLATION_DIR |
Каталог, приведенный в ключе реестра HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.0\Setup\<Продукт>\ ProductDir. |
PROJECT_TEMPLATE_NAME |
Указывается в файле .vsz. Файлы шаблонов проекта, используемые мастером для создания проектов. Обычно используется "txt". |
PROJECT_TEMPLATE_PATH |
Каталог, содержащий файлы шаблонов проекта. Для Visual C++ по умолчанию принимается PRODUCT_INSTALLATION_DIR\VCWizards. |
RELATIVE_PATH |
Если путь ABSOLUTE_PATH не был найден, используется путь RELATIVE_PATH. Этот путь определяется относительно каталога PRODUCT_INSTALLATION_DIR. Для Visual C++ RELATIVE_PATH по умолчанию устанавливается как PRODUCT_INSTALLATION_DIR\VCWizards. |
SCRIPT_COMMON_PATH |
Каталог, заданный относительно PRODUCT_INSTALLATION_DIR, в котором находится файл общего сценария. Например, для Visual C++ используется VCWizards. |
SCRIPT_FILTER |
Указывается в файле .vsz. Типы файлов, размещаемые в папке "Файлы сценариев" в обозревателе решений. Обычно задается как "js" (JScript) or "vbs" (VBScript). |
SCRIPT_PATH |
Местоположение файла JScript мастера. По умолчанию используется START_PATH\Scripts. |
START_PATH |
Указывается в файле .vsz. Не устанавливается пользователем. Используется для определения RELATIVE_PATH или ABSOLUTE_PATH. Имя мастера (WIZARD_NAME) добавляется к этому значению. |
TEMPLATE_FILTER |
Указывается в файле .vsz. Типы файлов, размещаемые в папке "Файлы шаблонов" в обозревателе решений. Обычно используется "txt". |
TEMPLATES_PATH |
Указывается в файле .vsz. Местоположение файлов шаблонов мастера. По умолчанию используется START_PATH\Templates\<LangID>. Примечание.
Дополнительные сведения об идентификаторе LangID см. в описании HTML_PATH.
|
WIZARD_NAME |
Задает имя мастера. Указывается в файле .vsz и используется остальными символами. |
WIZARD_UI |
Указывается в файле .vsz. Логическое значение, определяющее, имеет ли мастер пользовательский интерфейс. В случае наличия пользовательского интерфейса устанавливается значение TRUE; в противном случае устанавливается значение FALSE. |
См. также
Задачи
Создание пользовательского мастера
Основные понятия
Файлы, создаваемые для мастера