Compartir a través de


Parámetros personalizados en el archivo .vsz del asistente

Actualización: noviembre 2007

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 secuencias de comandos 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).

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. Ésta es la ruta de acceso relativa a PRODUCT_INSTALLATION_DIR. En 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 secuencias de comandos 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 secuencias de comandos 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

Conceptos

Archivos creados para un asistente

Diseñar un asistente

Referencia

Asistente personalizado

Execute