Compartir a través de

Parámetros de contexto para iniciar asistentes

  • Artículo

Actualización: noviembre 2007

Los parámetros de contexto proporcionan información necesaria para iniciar un asistente, como, por ejemplo, el tipo de asistente que ha de utilizarse, el nombre del proyecto, directorios para los elementos del asistente, etc.

Existen tres tipos diferentes de asistentes:

  • NewProject: agrega un nuevo proyecto a una solución.

  • AddSubProject: agrega un subproyecto a un proyecto existente.

  • AddItem: agrega un elemento a un proyecto existente.

Los tres tipos de asistentes se invocan a través del método Execute de la interfaz IDTWizard. Un parámetro necesario del método Execute es ContextParams. Cada tipo requiere un conjunto diferente de valores ContextParams en el orden correcto, como se indica en la tabla siguiente:

Tipo de asistente

Parámetros utilizados

NewProject

  • WizardType

  • ProjectName

  • LocalDirectory

  • InstallationDirectory

  • FExclusive

  • SolutionName

  • Silent

AddSubProject

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

AddItem

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

En la siguiente tabla se enumeran todos los parámetros de contexto y sus descripciones:

Configuración

Descripción

WizardType

Constante que indica el tipo de asistente. Existen tres tipos:

  • vsWizardNewProject (GUID = "{0F90E1D0-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddItem (GUID = "{0F90E1D1-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddSubProject (GUID = "{0F90E1D2-4999-11D1-B6D1-00A0C90F2744}")

ProjectName

Nombre del proyecto.

ProjectItems

Puntero a la colección ProjectItems en la que funcionará el asistente. Se pasa al asistente basándose en la selección de jerarquía del proyecto.

LocalDirectory

Ubicación en el sistema local donde residen los archivos de proyecto de trabajo del asistente.

ItemName

Nombre del elemento que se va a agregar. ItemName es el nombre de archivo que escribe el usuario (o que se acepta de forma predeterminada) en el cuadro de diálogo Agregar elemento. En función de los indicadores establecidos en el archivo VSDIR, esta configuración puede ser NULL.

InstallationDirectory

Ruta de acceso del directorio donde se instala Visual Studio.

FExclusive

Valor booleano que indica si el proyecto debe ser exclusivo para sí mismo. Esto es, si se debe agregar el proyecto a la solución actual o si el sistema cierra la solución actual, crea una nueva y después agrega el proyecto a la solución.

SolutionName

Nombre para el archivo de solución sin la porción del directorio o extensión .sln. (El nombre de archivo .suo también se basa en este nombre raíz). Si SolutionName contiene un valor (es decir, no es una cadena vacía), el asistente NewProject llama al método Create antes de agregar el proyecto con AddFromTemplate. Sin embargo, si SolutionName es una cadena vacía, no es necesario llamar al método Createantes de llamar a AddFromTemplate.

Silent

Valor booleano que indica si el asistente se debe ejecutar sin notificación, sin mostrar ninguna interfaz de usuario (IU), y tomar todos los valores predeterminados. El valor predeterminado para Silent es True.

Vea también

Conceptos

Agregar asistentes a los cuadros de diálogo Agregar elemento y Nuevo proyecto mediante el uso de archivos .Vsdir

Referencia

Execute

IDTWizard