Compartir a través de


Cómo agregar un controlador de eventos

Los procedimientos para agregar controladores de eventos a una plantilla de formulario de código administrado de Microsoft Office InfoPath 2007 mediante Microsoft Visual Studio Tools para aplicaciones (VSTA) son parecidos a los que se utilizan para agregar controladores de eventos en las secuencias de comandos. Por ejemplo, para agregar un controlador de eventos al evento Loading, abra la plantilla de formulario en el modo de diseño de InfoPath, elija Programación en el menú Herramientoas y, a continuación, haga clic en el Evento Loading. El foco se desplazará automáticamente al esqueleto del controlador de eventos en el editor de código VSTA.

(los eventos Loading, ViewSwitched, ContextChanged y Sign). Estas diferencias se tratan en los procedimientos siguientes. Se utilizan los mismos procedimientos de la integración del modo de diseño de Microsoft Visual Studio 2005 Tools para 2007 Microsoft Office System o Visual Studio 2008 con Visual Studio Tools para Office en Visual Studio 2005, a excepción de agregar controladores de eventos desde eventos de nivel de formulario.

Importante

Al agregar un controlador de eventos se genera un código de enlace de eventos en el método InternalStartup del archivo FormCode.cs o FormCode.vb en el proyecto de plantilla de formulario. No cree el método InternalStartup ni le agregue código adicional.

Agregar un controlador de eventos para el evento Click de un control Button

  1. Si está trabajando en InfoPath, abra la plantilla de formulario en el modo de diseño.

    Se está trabajando en Visual Studio, abra un proyecto de Plantilla de formulario de InfoPath.

  2. En el panel de tareas Controles o en el Cuadro de herramientas de Visual Studio, arrastre un Botón al formulario.

  3. Haga doble clic en el botón y, a continuación, haga clic en Editar código del formulario.

    El foco se desplazará al controlador de eventos esqueleto del evento Clicked en el editor de código de VSTA o Visual Studio.

Agregar un controlador de eventos para el evento Changing, Validating o Changed de un campo o un grupo

  1. Si está trabajando en InfoPath, abra la plantilla de formulario en el modo de diseño.

    Se está trabajando en Visual Studio, abra un proyecto de Plantilla de formulario de InfoPath.

  2. Haga clic con el botón secundario en un control de entrada de datos enlazado al campo o grupo, como un control de Cuadro de texto.

  3. Seleccione Programación y haga clic en el evento para el que desee crear un controlador de eventos. El foco se desplazará al controlador de eventos esqueleto del evento Changing, Validating o Changed en el editor de código de VSTA o Visual Studio.

    Nota

    Si seleccionó la casilla de verificación Habilitar solamente características compatibles con el explorador en el cuadro de diálogo Diseñar un formulario cuando creó la plantilla de formulario o si seleccionó la casilla Diseñar una plantilla de formulario para InfoPath y Servicios de formularios en el cuadro de diálogo Opciones de formulario en la categoría Compatibilidad, no estará disponible el comando para el Evento Changing. Esto se debe a que los controladores de eventos del evento Changing no se admiten en la lógica empresarial de las plantillas de formulario publicadas en bibliotecas de documentos en Microsoft Office Forms Server 2007 o Microsoft Office SharePoint Server 2007 con InfoPath Forms Services.

Agregar un controlador de eventos para los eventos Loading, ViewSwitched, ContextChanged y Sign de un formulario

  1. Si está trabajando en InfoPath, abra la plantilla de formulario en el modo de diseño.

    Se está trabajando en Visual Studio, abra un proyecto de Plantilla de formulario de InfoPath.

  2. En InfoPath, seleccione Programación en el menú Herramientas y haga clic en el evento de formularios para el que desee escribir un controlador de eventos.

    En Visual Studio, seleccione Evento en el menú Insertar y haga clic en el evento de formularios para el que desee escribir un controlador de eventos.

    Se desplazará el foco al controlador de eventos esqueleto del evento Loading, ViewSwitched, ContextChanged o Sign en el editor de código de VSTA o Visual Studio.

    Nota

    Si seleccionó la casilla de verificación Habilitar solamente características compatibles con el explorador en el cuadro de diálogo Diseñar un formulario cuandor creó la plantilla de formulario o si seleccionó la casilla Diseñar una plantilla de formulario para InfoPath y Servicios de formulario en el cuadro de diálogo Opciones de formulario de la categoría Compatibilidad, no estará disponible el comando para el Evento Context Changed o el Evento Sign. Esto se debe a que los controladores de eventos de ContextChanged y Sign no se admiten en la lógica empresarial de las plantillas de formulario publicadas en bibliotecas de documentos en Microsoft Office Forms Server 2007 o Microsoft Office SharePoint Server 2007 con InfoPath Forms Services.

Agregar un controlador de eventos para el evento Submit de un formulario

  1. Si está trabajando en InfoPath, abra la plantilla de formulario en el modo de diseño.

    Si está trabajando en Visual Studio, abra un proyecto de Plantilla de formulario de InfoPath y, a continuación, haga clic en la ficha manifest.xsf [Design] para abrir el diseñador de formularios.

  2. En el menú Herramientas, haga clic en Opciones de envío de formularios.

  3. Haga clic en Permitir a los usuarios enviar este formulario, a continuación en Realizar una acción personalizada utilizando código y, por último, haga clic en Modificar código.

    El foco se desplazará al controlador de eventos esqueleto del evento Submit en el editor de código de VSTA o Visual Studio.

Agregar un controlador de eventos para el evento Save de un formulario

  1. Si está trabajando en InfoPath, abra la plantilla de formulario en el modo de diseño.

    Si está trabajando en Visual Studio, abra un proyecto de Plantilla de formulario de InfoPath y, a continuación, haga clic en la ficha manifest.xsf [Design] para abrir el diseñador de formularios.

  2. En el menú Herramientas, haga clic en Opciones de formulario.

  3. En la categoría Abrir y guardar, seleccione la casilla de verificación Guardar usando código personalizado y después haga clic en Editar.

    Se desplazará el foco al controlador de eventos esqueleto del evento Save en el editor de código de VSTA o Visual Studio.

    Nota

    Si seleccionó la casilla de verificación Habilitar solamente características compatibles con el explorador en el cuadro de diálogo Diseñar un formulario cuando creó la plantilla de formulario o si seleccionó la casilla Diseñar una plantilla de formulario para InfoPath y Servicios de formularios en el cuadro de diálogo Opciones de formulario en la categoría Compatibilidad, no estará disponible la casilla de verificación Guardar usando código personalizado. Esto se debe a que los controladores de eventos del evento Save no se admiten en la lógica empresarial de las plantillas de formulario publicadas en bibliotecas de documentos en Microsoft Office Forms Server 2007 o Microsoft Office SharePoint Server 2007 con InfoPath Forms Services.

Agregar un controlador de eventos para el evento VersionUpgrade de un formulario

  1. Si está trabajando en InfoPath, abra la plantilla de formulario en el modo de diseño.

    Si está trabajando en Visual Studio, abra un proyecto de Plantilla de formulario de InfoPath y, a continuación, haga clic en la ficha manifest.xsf [Design] para abrir el diseñador de formularios.

  2. En el menú Herramientas, haga clic en Opciones de formulario.

  3. Haga clic en la categoría Programación, seleccione Utilizar evento personalizado en el cuadro de lista desplegable Al actualizar la versión y haga clic en Editar.

    Se desplazará el foco al controlador de eventos esqueleto del evento Save en el editor de código de VSTA o Visual Studio.

Agregar un controlador de eventos para el evento Merge de un formulario

  1. Si está trabajando en InfoPath, abra la plantilla de formulario en el modo de diseño.

    Si está trabajando en Visual Studio, abra un proyecto de Plantilla de formulario de InfoPath y, a continuación, haga clic en la ficha manifest.xsf [Design] para abrir el diseñador de formularios.

  2. En el menú Herramientas, haga clic en Opciones de formulario.

  3. En la categoría Avanzadas, seleccione la casilla de verificación Habilitar la combinación de formularios y haga clic en Editar.

    El foco se desplazará al controlador de eventos esqueleto del evento Merge en el editor de código de VSTA o Visual Studio.

    Nota

    Si seleccionó la casilla de verificaciónHabilitar solamente características compatibles con el explorador en el cuadro de diálogo Diseñar un formulario cuando creó la plantilla de formulario o si seleccionó la casilla Diseñar una plantilla de formulario para InfoPath y Servicios de formularios en el cuadro de diálogo Opciones de formulario en la categoría Compatibilidad, no estará disponible Habilitar la combinación de formularios. Esto se debe a que los controladores de eventos del evento Merge no se admiten en la lógica empresarial de las plantillas de formulario publicadas en bibliotecas de documentos en Microsoft Office Forms Server 2007 o Microsoft Office SharePoint Server 2007 con InfoPath Forms Services.

Vea también

Tareas

Tutorial: Crear y depurar una plantilla de formulario básica mediante el modelo de objetos de InfoPath 2003