Parámetros personalizados en el archivo .vsz del asistente
En las dos primeras líneas, el archivo .vsz identifica la versión del asistente y el id. de programa o CLSID del asistente que se va a crear. Este archivo también puede incluir parámetros de contexto y parámetros personalizados opcionales que se agregan a la tabla de símbolos (junto con los símbolos suministrados en la sección de símbolos HTML).
El método Execute muestra el asistente que toma una matriz del contexto y los parámetros personalizados definidos en el archivo .vsz como sus parámetros.
Los siguientes símbolos de uso común se especifican como parámetros personalizados en el archivo .vsz o en los archivos .htm y pueden utilizarse en los archivos HTML, de script o de plantilla del asistente.
Ejemplo
Como indican las siguientes entradas del archivo .vsz, el asistente denominado MyProjWiz contiene una interfaz de usuario:
VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine
Param="WIZARD_NAME = MyProjWiz"
Param="WIZARD_UI = TRUE"
Símbolos de los parámetros personalizados del archivo .vsz del asistente
Símbolo |
Definición |
|---|---|
ABSOLUTE_PATH |
Ubicación de los archivos del asistente. |
HTML_FILTER |
(Símbolo especificado en el archivo .vsz). Tipos de archivos que se colocan en la carpeta Archivos HTML del Explorador de soluciones. Normalmente se especifican como "htm". |
HTML_PATH |
(Símbolo especificado en el archivo .vsz). Ubicación de los archivos HTML del asistente. De forma predeterminada, es START_PATH\HTML\IDIOMA (IDIOMA se refiere a la configuración regional especificada por el Registro del sistema). .gif "Nota") Nota
Se puede especificar un idioma distinto si se asigna a <LangID> el valor decimal de HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\7.0\General\UILanguage.Vea Traducir un asistente a varios idiomas para obtener más información.Para obtener una lista de los valores decimales de idioma, vea Compatibilidad del Asistente con otros idiomas.
|
IMAGE_FILTER |
(Símbolo especificado en el archivo .vsz). Tipos de archivos que se colocan en la carpeta Archivos de imagen del Explorador de soluciones. Normalmente se especifican como "bmp;gif". |
IMAGES_PATH |
(Símbolo especificado en el archivo .vsz). Ubicación de los archivos de imagen utilizados en los archivos .html. De forma predeterminada, es START_PATH\Images. |
MISC_FILTER |
(Símbolo especificado en el archivo .vsz). Tipos de archivos que se colocan en la carpeta Misc del Explorador de soluciones. Normalmente se especifican como "vsz;vsdir;ico;vcproj;csproj;css;inf". |
PRODUCT |
De forma predeterminada, toma el valor "Visual C++"; no obstante, también se puede utilizar el valor "Visual Basic" para crear asistentes de Visual Basic, y así sucesivamente. |
PRODUCT_INSTALLATION_DIR |
Directorio indicado en el Registro, en HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.0\Setup\<Product>\ ProductDir. |
PROJECT_TEMPLATE_NAME |
(Símbolo especificado en el archivo .vsz). Archivo de plantilla del proyecto utilizado por el asistente para crear proyectos. Normalmente se especifican como "txt". |
PROJECT_TEMPLATE_PATH |
Directorio que contiene los archivos de plantilla del proyecto. En Visual C++, es PRODUCT_INSTALLATION_DIR\VCWizards de forma predeterminada. |
RELATIVE_PATH |
Si ABSOLUTE_PATH no se encuentra, se utilizará RELATIVE_PATH. Esta es la ruta de acceso relativa a PRODUCT_INSTALLATION_DIR. Para Visual C++, RELATIVE_PATH es PRODUCT_INSTALLATION_DIR\VCWizards. |
SCRIPT_COMMON_PATH |
Nombre de directorio, relativo a la ruta de acceso PRODUCT_INSTALLATION_DIR, donde se encuentra el archivo de script común. Por ejemplo, en Visual C++, este directorio es VCWizards. |
SCRIPT_FILTER |
(Símbolo especificado en el archivo .vsz). Tipos de archivos que se colocan en la carpeta Archivos de script del Explorador de soluciones. Normalmente se especifican como "js" (JScript) o "vbs" (VBScript). |
SCRIPT_PATH |
Ubicación del archivo JScript del asistente. De forma predeterminada, es START_PATH\Scripts. |
START_PATH |
(Símbolo especificado en el archivo .vsz). Este símbolo no lo establece el usuario, sino que se utiliza internamente para identificar RELATIVE_PATH o ABSOLUTE_PATH. El nombre del asistente (WIZARD_NAME) se anexa a este valor. |
TEMPLATE_FILTER |
(Símbolo especificado en el archivo .vsz). Tipos de archivos que se colocan en la carpeta Archivos de plantilla del Explorador de soluciones. Normalmente se especifican como "txt". |
TEMPLATES_PATH |
(Símbolo especificado en el archivo .vsz). Ubicación de los archivos de plantilla del asistente. De forma predeterminada, es START_PATH\Templates\<LangID>. Nota
Vea HTML_PATH para obtener más información sobre LangID.
|
WIZARD_NAME |
Símbolo que especifica el nombre del asistente. Se encuentra en el archivo .vsz y lo utilizan el resto de los símbolos. |
WIZARD_UI |
(Símbolo especificado en el archivo .vsz). Valor booleano que indica si el asistente posee una interfaz de usuario. Se deberá especificar TRUE si existe una interfaz de usuario o FALSE en caso contrario. |
Vea también
Tareas
Crear un asistente personalizado