Eventos formulario

Los eventos formulario son eventos que pueden llevar a la ejecución del método de formulario y/o del o de los métodos objeto de formulario. Los eventos de formulario le permiten controlar el flujo de su aplicación y escribir código que se ejecuta sólo cuando ocurre un evento específico.

En su código, se controlan los eventos mediante el comando FORM Event, que devuelve el evento disparado. Por ejemplo:

//code of a button
If(FORM Event.code=On Clicked) 
// hacer algo cuando se presiona el botón
End if

Cada formulario y cada objeto activo en el formulario puede escuchar un conjunto predefinido de eventos, pero sólo los eventos que habilitó a nivel del formulario y/o en cada nivel del objeto ocurrirán realmente.

Objeto evento

Cada evento es devuelto como un objeto por el comando FORM Event. Por defecto, contiene las siguientes propiedades:

Propiedad	Tipo	Descripción
objectName	text	Name of the object triggering the event - Not included if the event is triggered by the form

Se devuelven propiedades adicionales cuando el evento se produce en objetos específicos. En particular:

• Los list box y las columnas de list box devuelven las propiedades adicionales tales como columnName o isRowSelected.
• Las áreas de View Pro devuelven por ejemplo las propiedades sheetName o action en el objeto evento On After Edit.

Eventos y métodos

Cuando se produce un evento formulario, 4D realiza las siguientes acciones:

• En primer lugar, explora los objetos del formulario y llama al método objeto para todo objeto (asociado al evento) cuya propiedad de evento de objeto correspondiente haya sido seleccionada.
• Luego, llama al método formulario si la propiedad del evento formulario correspondiente ha sido seleccionada.

No asuma que los métodos objeto, si los hay, serán llamados en un orden particular. La regla general es que los métodos objeto siempre se llaman antes que el método formulario. Si un objeto es un subformulario, se llaman los métodos objeto del formulario lista del subformulario, y luego se llama al método formulario del formulario listado. 4D continúa llamando a los métodos objeto del formulario padre. En otras palabras, cuando un objeto es un subformulario, 4D utiliza la misma regla general para los métodos objeto y formulario dentro del objeto subformulario.

Excepto en los eventos En carga y En descarga (ver más abajo), si la propiedad del evento formulario no está seleccionada para un evento determinado, esto no impide las llamadas a los métodos objetos cuya misma propiedad de evento está seleccionada. En otras palabras, la activación o desactivación de un evento a nivel de formulario no tiene ningún efecto sobre las propiedades del evento del objeto.

El número de objetos asociados a un evento depende de la naturaleza del mismo.

Tabla de llamadas

El número de objetos asociados a un evento depende de la naturaleza del mismo.

Evento	Método objeto	Método formulario	Objetos
On Load	Sí	Sí	Todos los objetos
On Unload	Sí	Sí	Todos los objetos
On Validate	Sí	Sí	Todos los objetos
On Clicked	Sí	Sí	Objetos involucrados únicamente
On Double Clicked	Sí	Sí	Objetos involucrados únicamente
On Before Keystroke	Sí	Sí	Objetos involucrados únicamente
On After Keystroke	Sí	Sí	Objetos involucrados únicamente
On After Edit	Sí	Sí	Objetos involucrados únicamente
On Getting Focus	Sí	Sí	Objetos involucrados únicamente
On Losing Focus	Sí	Sí	Objetos involucrados únicamente
On Activate	Nunca	Sí	Ninguno
On Deactivate	Nunca	Sí	Ninguno
On Outside Call	Nunca	Sí	Ninguno
On Page Change	Nunca	Sí	Ninguno
On Begin Drag Over	Sí	Sí	Objetos involucrados únicamente
On Drop	Sí	Sí	Objetos involucrados únicamente
On Drag Over	Sí	Nunca	Objetos involucrados únicamente
On Mouse Enter	Sí	Sí	Todos los objetos
On Mouse Move	Sí	Sí	Todos los objetos
On Mouse Leave	Sí	Sí	Todos los objetos
On Mouse Up	Sí	Nunca	Objetos involucrados únicamente
On Menu Selected	Nunca	Sí	Ninguno
On Bound variable change	Nunca	Sí	Ninguno
On Data Change	Sí	Sí	Objetos involucrados únicamente
On Plug in Area	Sí	Sí	Objetos involucrados únicamente
On Header	Sí	Sí	Todos los objetos
On Printing Detail	Sí	Sí	Todos los objetos
On Printing Break	Sí	Sí	Todos los objetos
On Printing Footer	Sí	Sí	Todos los objetos
On Close Box	Nunca	Sí	Ninguno
On Display Detail	Sí	Sí	Todos los objetos
On Open Detail	Sí (List box)	Sí	Ninguna, excepto los list box
On Close Detail	Sí (List box)	Sí	Ninguna, excepto los list box
On Resize	Nunca	Sí	Ninguno
On Selection Change	Sí	Sí	Objetos involucrados únicamente
On Load Record	Nunca	Sí	Ninguno
On Timer	Nunca	Sí	Ninguno
On Scroll	Sí	Nunca	Objetos involucrados únicamente
On Before Data Entry	Sí (List box)	Nunca	Objetos involucrados únicamente
On Column Moved	Sí (List box)	Nunca	Objetos involucrados únicamente
On Row Moved	Sí (List box)	Nunca	Objetos involucrados únicamente
On Column Resize	Sí (List box y Área 4D View Pro)	Nunca	Objetos involucrados únicamente
On Header Click	Sí (List box y Área 4D View Pro)	Nunca	Objetos involucrados únicamente
On Footer Click	Sí (List box)	Nunca	Objetos involucrados únicamente
On After Sort	Sí (List box)	Nunca	Objetos involucrados únicamente
On Long Click	Sí (botón)	Sí	Objetos involucrados únicamente
On Alternative Click	Sí (Botón y List box)	Nunca	Objetos involucrados únicamente
On Expand	Sí (Lista jerarq. y list box)	Nunca	Objetos involucrados únicamente
On Collapse	Sí (Lista jerarq. y list box)	Nunca	Objetos involucrados únicamente
On Delete Action	Sí (Lista jerarq. y list box)	Nunca	Objetos involucrados únicamente
On URL Resource Loading	Sí (Área Web)	Nunca	Objetos involucrados únicamente
On Begin URL Loading	Sí (Área Web)	Nunca	Objetos involucrados únicamente
On URL Loading Error	Sí (Área Web)	Nunca	Objetos involucrados únicamente
On URL Filtering	Sí (Área Web)	Nunca	Objetos involucrados únicamente
On End URL Loading	Sí (Área Web)	Nunca	Objetos involucrados únicamente
On Open External Link	Sí (Área Web)	Nunca	Objetos involucrados únicamente
On Window Opening Denied	Sí (Área Web)	Nunca	Objetos involucrados únicamente
On VP Range Changed	Sí (Área 4D View Pro)	Nunca	Objetos involucrados únicamente
On VP Ready	Sí (Área 4D View Pro)	Nunca	Objetos involucrados únicamente
On Row Resize	Sí (Área 4D View Pro)	Nunca	Objetos involucrados únicamente

Tenga siempre en cuenta que, para todo evento, se llama al método de un formulario o de un objeto si se selecciona la correspondiente propiedad del evento para el formulario o los objetos. La ventaja de desactivar los eventos en el entorno de diseño (utilizando la lista de propiedades del editor de formularios) es que puede reducir el número de llamadas a los métodos y, por tanto, optimizar significativamente la velocidad de ejecución de sus formularios.

ATENCIÓN: los eventos On Load y On Unload se generan para los objetos si están activados a la vez para los objetos y para el formulario al que pertenecen los objetos. Si los eventos están activados sólo para los objetos, no se producirán; estos dos eventos también deben estar activados a nivel del formulario.