Archivo .vsz (Control del proyecto)
Actualización: noviembre 2007
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.8.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.8.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 vc7\vcprojects, podrá agregarse el asistente al panel Plantillas del cuadro de diálogo Nuevo proyecto de Visual Studio. De forma predeterminada, el Asistente personalizado escribirá el archivo .vsz en este directorio.
.gif "Nota") Nota: |
|---|
Si elimina los archivos y directorios del asistente, también deberá eliminar del directorio vc7\vcprojects los archivos del proyecto .vsz, .vsdir e .ico. |
Vea también
Tareas
Crear un asistente personalizado
Conceptos
Archivos creados para un asistente