El archivo JScript
Actualización: noviembre 2007
El Asistente personalizado obtiene acceso al motor de secuencias de comandos y crea un archivo JScript, denominado Default.js, para cada proyecto. Asimismo, incluye un archivo Common.js. Estos archivos contienen funciones de JScript que proporcionan acceso a los modelos de objetos de Visual Studio y de Visual C++ para personalizar un asistente. Vea Diseñar un asistente para obtener una lista de estos modelos. Podrá agregar sus propias funciones en el archivo Default.js del proyecto de asistente. Para obtener acceso a las propiedades y métodos del modelo de objetos del asistente o del modelo de objetos del entorno a partir de un archivo JScript, anteponga "wizard." o "dte.", respectivamente, al elemento correspondiente del modelo de objetos.
Por ejemplo:
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"))
...
Al hacer clic en Finalizar en el Asistente personalizado, el asistente carga el archivo Default.js en la carpeta Archivos de secuencias de comandos del Explorador de soluciones. Este archivo JScript crea proyectos, representa plantillas y, a continuación, las agrega a la solución cuando el usuario hace clic en el botón Finalizar del asistente.
De forma predeterminada, el archivo Default.js del proyecto incluye las siguientes funciones:
Nombre de la función |
Descripción |
|---|---|
AddConfig |
Agrega las configuraciones del proyecto. Se pueden suministrar configuraciones propias para el compilador y el vinculador. |
AddFilesToCustomProj |
Cuando el usuario hace clic en Finalizar, agrega los archivos especificados al proyecto. |
AddFilters |
Cuando el usuario hace clic en Finalizar, agrega los filtros de origen especificados al proyecto. |
CreateCustomProject |
Cuando el usuario hace clic en Finalizar, crea el proyecto en la ubicación especificada. |
CreateCustomInfFile |
Crea el archivo Templates.inf del proyecto. |
DelFile |
Elimina el archivo especificado. |
GetTargetName |
Obtiene el nombre del archivo especificado. |
OnFinish |
El asistente llama a esta función cuando el usuario hace clic en Finalizar para crear el proyecto, agregar archivos y filtros, representar plantillas y establecer la configuración. |
PchSettings |
Establece la configuración del encabezado precompilado. Vea SetCommonPchSettings en la referencia del archivo Common.js para obtener más información. |
Cada asistente tiene un único archivo Default.js en el que se incluyen los comentarios TODO que ayudan a identificar dónde se debe personalizar el archivo.
Visual C++ también crea Common.js, archivo compartido por todos los asistentes e incluido en el proyecto del asistente. Las funciones de Common.js pueden utilizarse libremente.
.gif "Nota") Nota: |
|---|
Common.js contiene descripciones de cada función y de sus parámetros. Vea los comentarios del archivo Common.js para obtener más información. |
Si desea compartir determinadas funciones entre sus proyectos de asistentes, puede agregarlas a Common.js. Cree su propia versión de Common.js, guárdela en una ruta de acceso común y, a continuación, asigne esa ruta a SCRIPT_COMMON_PATH en el archivo .vsz.
| Nota: |
|---|
Los asistentes incluidos en Visual C++ utilizan las funciones de JScript presentes en Common.js. Si cambia estas funciones, los asistentes de Visual C++ pueden comportarse de forma inesperada. |
Para obtener más información acerca de JScript, vea Escribir, compilar y depurar código JScript.
Depurar secuencias de comandos
Para depurar secuencias de comandos en archivos html del asistente, debe habilitar la depuración de secuencias de comandos.
Para habilitar la depuración de secuencias de comandos
En Internet Explorer, haga clic en el menú Herramientas y elija Opciones de Internet.
Haga clic en la ficha Opciones avanzadas.
En la categoría Examinar, desactive la casilla Deshabilitar depuración de secuencias de comandos.
De este modo, los archivos common.js y default.js también aparecerán en la ventana Documentos en ejecución al hacer clic en el botón Finalizar del asistente.
Vea también
Tareas
Crear un asistente personalizado
Conceptos
Archivos creados para un asistente