En esta sección se presupone que tiene un conocimiento básico del lenguaje de programación Visual Basic. Si tiene que aprender Visual Basic, consulte un libro o cualquier otro recurso externo que trate del tema.
La sección Eventos del cuadro de diálogo Propiedades contiene una lista de funciones del manejador de eventos compatibles con su objeto de formulario o plantilla. Se invoca una función de manejador de eventos cada vez que se produce el evento indicado por el nombre de la función para el objeto en cuestión. Cuando se llama a esa función se ejecuta todo el código Visual Basic que haya en ella.
Funciones disponibles del manejador de eventos
EventClick
Se llama cuando se hace clic con el ratón en el objeto.
EventDblClick
Se llama cuando se hace doble clic con el ratón en el objeto.
EventDragDrop
Se llama cuando se suelta un elemento "arrastrable" en el objeto.
EventDragEnter
Se llama cuando se comienza a arrastrar un elemento arrastrable hacia el objeto.
EventDragOver
Se llama cuando se arrastra un elemento arrastrable sobre el objeto.
EventInitialize
Se llama cuando el formulario entra por primera vez en el modo de ejecución, antes de que se llame a cualquier otro manejador en el objeto.
EventMouseDown
Se llama cuando se hace clic en un botón del ratón mientras el cursor está encima del objeto. Si pulsa la tecla Mayús, los parámetros que se pasan a la función indican qué botón se ha pulsado y las coordenadas del puntero en el momento de hacer clic en el botón del ratón.
EventMouseMove
Se llama cuando el puntero del ratón pasa sobre el objeto. Si pulsa la tecla Mayús, los parámetros que se pasan a la función indican qué botón se ha pulsado y las coordenadas del puntero cuando se mueve el puntero sobre el objeto.
EventMouseUp
Se llama cuando se suelta el botón del ratón sobre el objeto. Si pulsa la tecla Mayús, los parámetros que se pasan a la función indican qué botón se ha pulsado y las coordenadas del puntero en el momento de soltar el botón del ratón.
EventPumpData
Se trata de una función de manejador de eventos muy utilizada en el editor de formularios. EventPumpData se llama cada vez que cambia el valor de alguna de las variables de BASIC que pueden afectar al objeto. El código también puede obligar a que se llame a EventPumpData en objetos individuales (o en todos los objetos en un informe) si se desea que un objeto se actualice solo. Básicamente, debería aparecer en EventPumpData cualquier código que un objeto necesite para reinicializarse en función de los valores de las variables o del estado de los demás objetos.
EventTerminate
Se llama cuando se cierra el informe o cuando se pasa del modo Ejecución al modo Edición en el editor de formularios.
Esta función del manejador solo está disponible para los entornos de edición de secciones.
EventReportData
Se trata de otra de las funciones de manejador de eventos que más se utilizan en los editores de informes y de plantillas de etiqueta. Se llama cuando los datos de informe se insertan en la plantilla actual.
Su función principal es permitirle crear sus propios controles ActiveX para colocarlos en una etiqueta. Por ejemplo, el mejor ajuste y los controles de análisis de elementos de PC-DMIS utilizan este evento para enviar datos al control ActiveX desde el comando. Para ver esto, abra la etiqueta best_fit_analysis.lbl, haga clic en el control ActiveX dentro de la etiqueta y, a continuación, examine el código BASIC dentro de su manejador de eventos. Una sola línea pasa los datos del comando al control.
Cuando los datos se han pasado a su control ActiveX, puede utilizar los comandos de automatización para extraer y manipular los datos.
Para obtener información detallada sobre PC-DMIS Basic, consulte el tema "PC-DMIS Basic" en la documentación de PC-DMIS Basic.
Para obtener información detallada sobre la biblioteca de objetos de automatización de PC-DMIS, consulte el tema "PC-DMIS Object Library" (Biblioteca de objetos de PC-DMIS) en la documentación correspondiente a los objetos de automatización de PC-DMIS.
Este evento se llama una vez para cada comando cuando se aplica la plantilla de informe o durante la ejecución de la rutina de medición.
Añadir código a los manejadores de eventos
Para añadir código en lenguaje BASIC a cualquiera de los manejadores de eventos:
Haga clic en la entrada de la función en la lista de manejadores de eventos. Se abre un editor del lenguaje Visual BASIC, donde las instrucciones de apertura y cierre de la subrutina ya existen.
Escriba las instrucciones BASIC adicionales en el editor.
Haga clic en Aceptar.
Pruebe el código.
Si está utilizando el editor de formularios, pulse Ctrl + E para entrar en el modo Ejecución para probar el formulario.
Si está utilizando uno de los editores de plantillas, aplique la plantilla a un informe y vuelva a crear el informe para probar el código. Para ello, utilice el icono Redibujar el informe
de la barra de herramientas de informe.
Puesto que no se utilizan botones, listas ni campos en los que se pueda hacer clic, ni ningún otro tipo de elementos interactivos cuando se utiliza un informe, la única función de manejador de eventos disponible es EventReportData.
Más:
Ejemplo de evento 1: Llamar a código cuando se produce un evento EventClick
Ejemplo de evento 2: Modificar las propiedades de objeto en eventos disparados