Archivo .vsz (Control del proyecto)
El punto de inicio de todo asistente es el archivo .vsz. El archivo .vsz es un archivo de texto que determina a qué asistente se ha de llamar y qué información se le ha de pasar. Este archivo contiene un encabezado de dos líneas, seguido de diversos parámetros opcionales para pasarle al asistente. Para obtener una lista de los parámetros opcionales, vea Símbolos predefinidos del Asistente personalizado.
En el siguiente ejemplo se muestra el encabezado de un archivo .vsz:
VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine.10.0
Param="WIZARD_NAME = My AppWizard"
La primera línea del encabezado especifica el número de versión del formato de archivo de plantilla. Se puede especificar este número como 6.0, 7.0 o 7.1. Ningún otro número será válido; de utilizarse, se producirá el error "Formato no válido".
La segunda línea asigna a la variable Wizard el id. de programa del asistente creado por Visual Studio. Un id. de programa es una representación de cadena de un CLSID, tal como VsWizard.VsWizardEngine.10.0.
Si el asistente posee interfaz de usuario, el id. de programa especifica automáticamente al asistente que implemente IVCWizCtlUI. De forma predeterminada, los métodos de esta interfaz se utilizan en los archivos .htm del proyecto. El comportamiento del asistente puede cambiarse utilizando los métodos para esta interfaz incluidos en los archivos .htm. Para obtener más información, vea VCWizCtl, que es la coclase para IVCWizCtlUI.
Tras estas dos líneas, aparece una lista opcional de parámetros que le permiten al archivo .vsz pasar parámetros personalizados adicionales al asistente. Cada valor se pasa como un elemento de cadena de una matriz de variantes en el método Execute del control del asistente. De forma predeterminada, un asistente con interfaz de usuario proporciona los siguientes parámetros predeterminados:
Param="START_PATH = <path to the wizard>" Param="HTML_PATH = <path to the wizard's HTML file>" Param="TEMPLATES_PATH = <path to the wizard's template file>" Param="SCRIPT_PATH = <path to the wizard's script files>" Param="IMAGES_PATH = <path to the wizard's images>"Si el asistente no posee interfaz de usuario, no presentará ningún parámetro IMAGES_PATH y, en su lugar, contendrá los siguientes parámetros:
Param="WIZARD_UI = FALSE" Param="SOURCE_FILTER = txt"El archivo .vsz puede contener los siguientes parámetros, los cuales especifican funciones incluidas en el archivo Common.js:
Param="PREPROCESS_FUNCTION = CanAddATLClass" Param="PREPROCESS_FUNCTION = CanAddMFCClass" Param="PREPROCESS_FUNCTION = CanAddClass"
El asistente llama a las funciones CanAddATLClass, CanAddMFCClass y CanAddClass para confirmar que el modelo de código de Visual C++ está disponible. Si una de las funciones devuelve false, el asistente no se iniciará.
Colocando el archivo .vsz en el directorio vcprojects, podrá agregarse el asistente al recuadro Plantillas del cuadro de diálogo Nuevo proyecto de Visual Studio. De forma predeterminada, el Asistente personalizado escribirá el archivo .vsz en este directorio.
Nota
Si elimina los archivos y directorios del asistente, también deberá eliminar del directorio vcprojects los archivos del proyecto .vsz, .vsdir e .ico.
Vea también
Tareas
Crear un asistente personalizado
Referencia
Conceptos
Archivos creados para un asistente