Файл JScript

Статья
11/05/2008

Обновлен: Ноябрь 2007

Специальный мастер вызывает обработчик сценариев и создает для каждого проекта файл JScript с именем Default.js. Он также включает файл Common.js. Эти файлы содержат функции JScript, предоставляющие доступ к объектным моделям Visual Studio и Visual C++ для настройки мастера. (список моделей см. в разделе Разработка мастера). В файл проекта мастера Default.js можно добавлять и свои собственные функции. Чтобы получить доступ к свойствам и методам объектной модели мастера или модели среды из файла JScript, следует добавить элемент объектной модели с префиксом "wizard." или "dte." соответственно.

Пример.

function CreateCustomProject(strProjectName, strProjectPath)
{
   try
   {
      var strProjTemplatePath = wizard.FindSymbol('PROJECT_TEMPLATE_PATH');
var strProjTemplate = '';
      strProjTemplate = strProjTemplatePath + '\\default.vcproj';

      var Solution = dte.Solution;
      var strSolutionName = "";
      if (wizard.FindSymbol("CLOSE_SOLUTION"))
...

При нажатии кнопки Готово в специальном мастере мастер загружает файл Default.js из папки "Файлы сценариев" обозревателя решений. Файл JScript создает проекты и предоставляет шаблоны, а затем, когда пользователь нажмет в мастере кнопку Готово, добавляет их в решение.

По умолчанию файл проекта Default.js включает следующие функции:

Имя функции	Описание
AddConfig	Добавляет конфигурации проекта. Пользователь может задать параметры для компилятора и компоновщика.
AddFilesToCustomProj	Добавляет в проект указанные файлы, когда пользователь нажимает кнопку Готово.
AddFilters	Добавляет в проект указанные фильтры источников, когда пользователь нажимает кнопку Готово.
CreateCustomProject	Создает проект в указанном расположении, когда пользователь нажимает кнопку Готово.
CreateCustomInfFile	Создает файл Templates.inf проекта.
DelFile	Удаляет указанный файл.
GetTargetName	Возвращает имя указанного файла.
OnFinish	Вызывается мастером при нажатии пользователем кнопки Готово для создания проекта, добавления файлов и фильтров и задания конфигурации.
PchSettings	Задает параметры предварительно скомпилированного заголовка. Дополнительные сведения см. в описании функции SetCommonPchSettings в справке по Common.js.

У каждого мастера имеется уникальный файл Default.js, включающий комментарии TODO, которые помогают определить, где необходимо настраивать этот файл.

В Visual C++ также имеется файл Common.js, совместно используемый всеми мастерами и включаемый в новые проекты мастера. Можно использовать функции в файле Common.js.

Примечание.
В файле Common.js содержится описание и параметры для каждой функции. Дополнительные сведения см. в комментариях в файле Common.js.

Если имеются функции, которые должны совместно использовать несколько проектов мастеров, можно добавить их в файл Common.js. Создайте собственную версию Common.js и сохраните ее по общему адресу, а затем задайте путь к этой версии файла в параметре SCRIPT_COMMON_PATH VSZ-файла.

Примечание.
Мастера, предоставляемые вместе с Visual C++, используют функции JScript из файла Common.js. При изменении этих функций мастера Visual C++ wizards могут повести себя не так, как ожидается.

Дополнительные сведения о JScript см. в разделе Создание, компиляция и отладка кода JScript.

Отладка сценариев

Для отладки сценария в HTML-файлах мастера необходимо включить отладку сценариев.

Включение отладки сценариев

В обозревателе Internet Explorer в меню Сервис выберите пункт Свойства обозревателя.
Выберите вкладку Дополнительно.
В категории Обзор снимите флажок Запретить отладку сценариев.

Это действие также позволит отображать файлы Сommon.js и Default.js в окне Выполняемые документы при нажатии в мастере кнопки "Готово".

См. также

Поделиться через

Файл JScript

Отладка сценариев

Включение отладки сценариев

См. также

Задачи

Основные понятия

Ссылки

Дополнительные ресурсы