Conexión de evento

Conexión de evento
El subobjeto Conexión de evento permite conectar un evento que contiene líneas de instrucción con una señal que provoca el disparo de dicho evento. Este subobjeto puede ser usado en Rejillas, Árboles, Formularios, Bloc de formularios, Casilleros, Multivista y Marco.
Para crear una conexión de evento hemos de pulsar el botón

Sus propiedades son:

Identificador: Etiqueta alfanumérica que identifica al objeto. Este identificador será el que se usa para referenciarlo en los inspectores y en las propiedades de otros objetos.

Nombre: Etiqueta alfanumérica que servirá como descriptor de la conexión de evento. Es el texto que se presentará al usuario final de la aplicación para referenciar la conexión de evento.
Podemos definir una etiqueta por cada idioma presente en el proyecto.

Estilos: Podemos definir el estilo Privado que limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.

Comentarios: Esta propiedad nos permite documentar el uso de la conexión de evento.

Control: Define bien el objeto principal o bien un subobjeto como origen de la señal que dispara el evento.

Señal: Esta propiedad nos permite seleccionar qué suceso es el que desencadena el disparo del evento. Según el tipo de objeto o subobjeto estarán serán funcionales unas señales u otras. Las señales disponibles y los objetos o subobjetos en los que son funcionales:

Gana foco. Es funcional en:

Los siguientes subobjetos de formulario: Botón, edición, microscroller, calendario, botón de radio, check box, combo box, list box, deslizador, rueda y dial.
Rejilla.
Casillero.
Árbol.
Marco

Pierde foco. Es funcional en:

Los siguientes subobjetos de formulario: Botón, edición, microscroller, calendario, botón de radio, check box, combo box, list box, deslizador, rueda, dial.
Rejilla.
Casillero.
Árbol.
Marco

Tecla pulsada. Es funcional en:

Formulario.
Los siguientes subobjetos de formulario: Botón, edición, microscroller, calendario, botón de radio, check box, combo box, list box, deslizador, rueda, objeto dibujo, objeto texto, objeto texto enriquecido, html, caja de formulairos, objeto.
Rejilla
Casillero
Árbol

Tecla soltadaEs funcional en:

Formulario.
Los siguientes subobjetos de formulario: Botón, edición, microscroller, calendario, botón de radio, check box, combo box, list box, deslizador, rueda, objeto dibujo, objeto texto, objeto texto enriquecido, html, caja de formulairos, objeto.
Rejilla
Casillero
Árbol

Ratón: botón doble-click. Es funcional en:

Formulario.
En los siguientes subobjetos de formulario:Texto estático, nombre de campo, botón, edición, microscroller, calendario, reloj, manómetro, botón de radio, check box, objeto (formulario), deslizador, rueda, dial, campo objeto texto (sólo botón derecho), html (sólo en áreas vacías del control), separador de subformularios (sólo en áreas vacías del control), caja de formularios (sólo en áreas vacías del control), pila de subformularios (sólo en áreas vacías del control).
Bloc de formularios.

Ratón: botón pulsado. Es funcional en:

Formulario.
En los siguientes subobjetos de formulario: Texto estático, nombre de campo, botón, edición, microscroller, calendario, reloj, manómetro,botón de radio, check box, combo box, control objeto (formulario), deslizador, rueda, dial, objeto dibujo, html, separador de subformulario (sólo en áreas vacías del control), caja de formularios (sólo en áreas vacías del control), pila de subformularios (sólo en áreas vacías del control).
Bloc de formularios.

Ratón: botón soltado. Es funcional en:

Formulario.
En los siguientes subobjetos de formulario: Texto estático, nombre de campo, botón, edición, microscroller, calendario, reloj, manómetro,botón de radio, check box, combo box, control objeto (formulario), deslizador, rueda, dial, objeto dibujo, html, separador de subformulario (sólo en áreas vacías del control), caja de formularios (sólo en áreas vacías del control), pila de subformularios (sólo en áreas vacías del control).
Bloc de formularios.

Ratón: movimiento. Es funcional en:

Formulario (Sólo con botón izquierdo del ratón pulsado).
En los siguientes subobjetos de formulario: Texto estático (Sólo con botón izquierdo del ratón pulsado), nombre de campo (Sólo con botón izquierdo del ratón pulsado), botón (Sólo con botón izquierdo del ratón pulsado), edición, microscrollers (Sólo con botón izquierdo del ratón pulsado), calendario, reloj (Sólo con botón izquierdo del ratón pulsado), manómetro (Sólo con botón izquierdo del ratón pulsado), control de radio, check box, control objeto (formulario), deslizador, rueda, dial, objeto dibujo, htm (sólo en áreas vacías del control), separador de subformularios (sólo en áreas vacías del control), caja de formularios (sólo en áreas vacías del control), pila de subformularios (sólo en áreas vacías del control).
Bloc de formularios (Sólo con botones de ratón pulsados).

Ventana movida. Es funcional en:

Formulario.
Rejilla.
Casillero
Árbol.

Ventana redimensionada. Es funcional en:

Formulario.
Rejilla.
Casillero
Bloc de formularios.
Árbol.

Item: cambio de seleccionado
Inicializado. Es funcional en:

Formulario.
Rejilla.
Árbol.
Marco.

Timer. Solamente es funciona en Formularios.
Botón pulsado.
Acción disparada. Es funcional en:

Formulario.
En todos los controles de formulario:
Rejilla.
Casillero
Bloc de formularios.
Árbol.

Item: activado. Es funcional en:

En los siguientes subobjetos de formulario: Control objeto (rejilla, casillero).
Rejilla.
Item: simple-click. Es funcional en:

En los siguientes subobjetos de formulario: Control objeto (rejilla, casillero).
Rejilla.
Casillero
Árbol.

Item: doble-click. Es funcional en:

En los siguientes subobjetos de formulario: Control objeto (rejilla, casillero).
Rejilla.
Casillero
Árbol.

Drop finalizado. Es funcional en:

Rejilla.
Casillero

Slot: Seleccionaremos el objeto evento que se ejecutará cuando se dispare la señal en el objeto o subobjeto seleccionados.

Las señales pueden ser leídas en los eventos que éstas disparen. Para ello será necesario crear una variable local al objeto (formulario, rejilla, marco, etc.) cuyo identificador sea EVENT_PARAMS, ésta tendrá que ser de tipo alfabético y tener activada la propiedad array. En el cuadro siguiente se muestran las distintas señales y qué es lo que devuelven en cada posición del array:

Para poder atrapar la señal es necesario declarar en el objeto una variable local alfabética con la propiedad array a True cuyo identificador sea EVENT_PARAMS.

Podremos leer el contenido del array desede cualquier fórmula, siguiendo la siguiente sintaxis: EVENT_PARAMS[posicion], donde el parámetro posicion identifica la posición del array que se desee leer. Este dato podrá ser tanto una constante como una variable. Como puede verse en el esquema anterior, en un array la primera posición es la 0.

Es conveniente saber que los códigos de las teclas de control y de función multiplataforma devuelven números bastante elevados que provoca un formateo de la cadena devuelta si la imprimimos, y dará la impresión de ser el mismo, aunque realmente no sea así. Si al dato devuelto le aplicamos un formato mediante el uso de la función numberToString. Es decir, si en un evento disparado por una señal de tecla pulsada visualizamos el código de la misma (EVENT_PARAMS[1]), y pulsamos distintas teclas de función, veremos que siempre nos visualizará el valor 1.67773e+07, sin embargo, si usamos la función numberToString -Ejemplo: numberToString(EVENT_PARAMS[1], “f”, “g”)-, si se pulsa F1 devolverá el valor 16777264, si se pulsa F2 devolverá el valor el valor 16777265 y así sucesivamente.