Conexión de evento

El subobjeto conexión de evento permite conectar un manejador de evento, etc.

Para crear una conexión de evento hemos de pulsar el botón en el panel de subobjetos de Velneo vDevelop.

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

Este parámetro desplegará la lista con todos los objetos/controles accesibles desde el origen actual. Si algún sub-objeto contiene a su vez otros controles, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos.

Podremos seleccionar por tanto, tanto el propio objeto como cualquier objeto/subobjeto accesible desde el objeto actual. Por tanto, no solamente podremos atrapar señales disparadas dentro del propio objeto sino desde cualquier subobjeto contenido en el mismo o incluso del marco principal del proyecto, excepto la señal acción disparada, que solamente puede ser atrapada desde el propio objeto que la emite.

Señal

Esta propiedad nos permite seleccionar qué suceso es el que desencadena el disparo del manejador de 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:

Acción disparada

El manejador de evento asociado a la conexión de evento se disparará cuando se lance una acción concreta. Esta señal solamente puede ser atrapada si se lanza en el contexto del objeto, no puede ser atrapada desde otros objetos. Por ejemplo, en un formulario podremos atrapar las acciones que se disparen desde botones del formulario, o desde menús incluidos en botones del mismo, etc. En una rejilla, podremos atrapar las acciones que se disparen desde la toolbar asociada a la misma.

Botón pulsado

El manejador de evento asociado a la conexión de evento se disparará cuando el botón que hayamos especificado en la conexión de evento sea pulsado.

Contents changed (obsoleta)

Solamente válida para el control visor html. El manejador de evento asociado a la conexión se disparará cuando cambie el contenido de un control editable dentro de la página web que se está mostrando en el visor html.

Desconexión del servidor

Señal específica para el marco AUTOEXEC. Esta señal se disparará una sola vez cuando se produce la desconexión.

Drop finalizado

Señal específica para objetos que tenga activada la funcionalidad de drag & drop. Disparará el manejador de evento asociado a la conexión de evento cuando haya finalizado el drop.

Edición iniciada

Solamente funcional en rejillas editables. El manejador de evento asociado a la conexión se disparará cuando se inicie la edición de un registro en la rejilla.

Edición aceptada

Solamente funcional en rejillas editables. El manejador de evento asociado a la conexión se disparará con posterioridad a la aceptación de la edición de un registro en la rejilla.

Edición cancelada

Solamente funcional en rejillas editables. El manejador de evento asociado a la conexión se disparará con posterioridad a la cancelación de la edición de un registro en la rejilla.

Edición pre-aceptada

Solamente funcional en rejillas editables. El manejador de evento asociado a la conexión se disparará cuando antes de finalizar la edición (guardando cambios) de un registro en la rejilla. Usaremos esta señal si queremos, por ejemplo, hacer algún tipo de comprobación previa al alta/modificación de la ficha.

Edición pre-cancelada

Solamente funcional en rejillas editables. El manejador de evento asociado a la conexión se disparará cuando antes de hacerse efectiva la cancelación de la edición de un registro en la rejilla. Usaremos esta señal si queremos, por ejemplo, hacer algún tipo de comprobación previa a la cancelación del alta/modificación de la ficha.

En el manejador de evento que se dispara en señales pre-aceptada, pre-cancelada, debemos evitar mostrar mensajes puesto que generará problemas con el foco cuando estamos en edición (por ejemplo si usamos un comando set retorno = NO).

Es en estas señales de edición pre-aceptada y pre-cancelada donde podremos utilizar el comando de instrucción set retorno proceso = NO, ya que en este punto la edición sigue activa.

Gana foco

El manejador de evento será disparado cuando el objeto o sub-objeto asociado a la conexión de evento gane el foco.

Nota: Cuando se ejecuta la aplicación en modo MDI si un sub-objeto tiene el foco, tiene asociada una señal de ganancia de foco y hacemos clic en cualquier zona vacía de la ventana que lo contiene, se disparará la señal de ganancia de foco del control, ya que en este modo la ventana misma atrapa el foco y lo envía al control.

Item: activado

El manejador de evento asociado a la conexión de evento se disparará cuando se active un elemento del objeto o sub-objeto asociado a la conexión de evento.

Item: cambio de seleccionado

Conexión de evento específico para objetos o subcontroles de listas (rejillas, casilleros, etc.) y formularios. El manejador de evento se disparará cuando cambie el elemento seleccionado en el objeto de lista asociado a a la conexión de evento.

En objetos de lista, el origen del evento será la ficha de origen. En el caso de que queramos acceder a la ficha de destino en el manejador de evento usaremos el comando de instrucción Leer ficha seleccionada.

En formularios, la señal se disparará después de la inicialización de la ficha y en el cambio de ficha mostrada. Éste último caso es útil en visualizaciones sincronizadas (multivista, etc.) en las que cambia la ficha y permanece el formulario construido inicialmente.

Item: doble-click

El manejador de evento asociado a la conexión de evento se disparará cuando se haga doble clic sobre un elemento del objeto o sub-objeto asociado a la conexión de evento.

Item: pre cambio de seleccionado

Conexión de evento específico para formularios con origen. Esta señal sería previa a la Item: cambio de seleccionado y permitirá al programador realizar acciones sobre el registro antes de que sea sustituido en el objeto por otro. Por ejemplo, detectar si ha habido cambios en el registro y guardarlos o preguntar al usuario por la acción a realizar.

Item: simple-click

El manejador de evento asociado a la conexión de evento se disparará cuando se haga un clic sobre un elemento del objeto o sub-objeto asociado a la conexión de evento.

Link clicked

Solamente funcional en el control visor html. El manejador de evento asociado a la conexión se disparará cuando pulsamos un enlace.

Para que un control HTML lance esa señal, será necesario ejecutaren el evento inicializado del formulario donde se incluya un manejador de evento JavaScript con un código similar al siguiente:

// Atrapamos todos los clics en enlaces del control visor html    
visor = theRoot.dataView().control( "ID_CONTROL" );    
visor.setLinkDelegationPolicy( VCWebView.DelegateAllLinks );

Con la función setLinkDelegationPolicy le decimos al navegador cómo queremos que gestione los link pulsados:

DontDelegateLinks: en este modo el navegador gestiona todos los enlaces.
DelegateExternalLinks: en este modo el navegador gestiona los enlaces internos (del sistema de ficheros local) y emite la señal LinkClicked(url) para los externos.
DelegateAllLinks: en este modo emite la señal LinkClicked(url) para todos los enlaces.

El modo por defecto es DontDelegateLinks. Si el navegador gestiona un enlace emite la señal LoadStarted y, si no, emite la señal LinkClicked(url), en cuyo caso hay que cargar la página en el manejador del evento o realizar la acciones que consideremos oportunas.

El valor del enlace activado (url) se puede leer en el valor 1 de la variables local especial tipo array EVENT_PARAMS.

Lista cambiada

Esta señal permite conocer cuándo cambia la lista de una objeto de lista (rejilla, un informe, un multivista, etc.). En cualquier objeto de lista podremos saber cuándo se han añadido, quitado o cambiado registros, con el fin de poder sincronizar otras acciones.

El tipo de cambio realizado en la lista se puede leer en el valor 1 de la variables local especial tipo array EVENT_PARAMS.

Load finished

Solamente funcional en el control visor html. El manejador de evento asociado a la conexión se disparará al finalizar la página.

Load progress

Solamente funcional en el control visor html. El manejador de evento asociado a la conexión se disparará durante la carga de la página.

Load started

Solamente funcional en el control visor html. El manejador de evento asociado a la conexión se disparará cuando comience la carga de una página.

On close

Esta señal es específica para el marco principal del proyecto. Se disparará cuando el marco de la aplicación sea cerrado por cualquier método o acción del usuario, tanto a través del teclado como usando el ratón.

On hide

El manejador de evento será disparado cuando el control asociado a la conexión de evento deje de estar visible.

On show

El manejador de evento será disparado cuando el control asociado a la conexión de evento se haga visible.

Nota: no se deben usar comandos que generen interfaz en manejadores de evento disparados con esta señal.

Pierde foco

El manejador de evento será disparado cuando el objeto o sub-objeto asociado a la conexión de evento pierda el foco. En rejillas editables, debemos tener en cuenta lo siguiente: para que se inicie la edición de una celda tiene que ganar foco, por lo que la rejilla pierde foco. Así que se disparará la señal de pérdida de foco cada vez que iniciemos la edición en cada celda individual.

No se deben mostrar mensajes o formularios en los manejadores de evento disparados con esta señal de pérdida foco, porque eso produce efectos secundarios ya que a su vez estamos generando nuevas pérdidas de foco.

En las rejillas editables los eventos de ganancia y de pérdida de foco tienen un comportamiento particular: la señal de ganancia de foco se emite cuando se entra en la edición de cada columna y la de pérdida de foco cuando pierde el foco la rejilla. Gracias a que el de pérdida de foco no se produce en cada entrada en edición, podemos controlar la ejecución del manejador de evento asociado a la ganancia de foco para que solo se realice la primera vez que gana foco, utilizando una variable local booleana que se pondrá a 1 cuando se ejecuta el evento de ganancia de foco y a 0 cuando se ejecute la pérdida de foco de la rejilla.

Post-Inicialización

Se dispara cuando el objeto ha sido inicializado. Esta señal solamente puede ser atrapada desde el propio objeto, no puede ser atrapada desde otros objetos. Esta señal es disparada después de construirse el objeto.

En un bloc de formularios esta señal se dispará cuando se abra el bloc y no cuando vayamos cambiando de registro una vez abierto.

Pre-Inicialización

Se dispara antes de inicializarse el objeto. Con esta señal, podremos disparar manejadores de evento que realicen operaciones antes de que el objeto sea presentado al usuario. Esta señal solamente puede ser atrapada desde el propio objeto, no puede ser atrapada desde otros objetos. Dado que la señal se dispara antes de crearse el objeto, no podremos usar en el manejador de evento que se dispare instrucciones que afecten a la interfaz, ya que no se ha construido todavía.

En un bloc de formularios esta señal se dispará cuando se abra el bloc y no cuando vayamos cambiando de registro una vez abierto.

Pre-vista cerrada

Esta señal es específica para el marco principal del proyecto. El manejador de evento será disparado cuando se cierre una vista y antes de que ésta sea cerrada.

Ratón: botón doble-click

El manejador de evento será disparado cuando se haga doble clic con el botón del ratón sobre el objeto o sub-objeto asociado a la conexión de evento.

Ratón: botón pulsado

El manejador de evento será disparado cuando se pulse un botón del ratón sobre el objeto o sub-objeto asociado a la conexión de evento.

Ratón: botón soltado

El manejador de evento será disparado cuando se suelte un botón del ratón (pulsado previamente) sobre el objeto o sub-objeto asociado a la conexión de evento .

Ratón: movimiento

El manejador de evento será disparado cuando se mueva el ratón sobre el objeto o sub-objeto asociado a la conexión de evento, dependiendo del objeto o sub-objeto esta señal solamente se disparará manteniendo pulsado un botón del ratón.

Reconectar al servidor

El manejador de evento será disparado tras haber se recuperado la conexión de Velneo vClient con el servidor y tras haberse perdido previamente. Esta señal es específica del objeto marco AUTOEXEC. Esta señal se disparará una sola vez, cuando se reproduce la reconexión.

Tecla pulsada

El manejador de evento será disparado cuando, estando el foco en el objeto o sub-objeto asociado a la conexión de evento , se pulse una tecla.

Nota: esta señal no es funcional ni en Android ni en iOS.

Tecla soltada

El manejador de evento será disparado cuando, estando el foco en el objeto o sub-objeto asociado a la conexión de evento , se suelte una tecla pulsada previamente.

Nota: esta señal no es funcional ni en Android ni en iOS.

Timer

El manejador de evento asociado a la conexión de evento se disparará de forma periódica, según un tiempo que deberá ser configurado en el objeto asociado a la conexión de evento. Debemos tener en cuenta que los timers disparan eventos que fuerzan el refresco de los controles, así que, si coincide que estamos escribiendo en un control de edición de un texto y cuando pulsamos la barra espaciadora para incluir un espacio en blanco se dispara el timer, como éste refresca los controles, al refrescarlo eliminará ese espacio en blanco no significativo.

Url changed

Solamente funcional en el control visor html. El manejador de evento asociado a la conexión se disparará cuando cambie la URL que se está mostrando.

valueChanged

El manejador de evento será disparado cuando cambie el valor del sub-objeto editado en un control de un formulario, o en una columna editable de una rejilla editable. Esta señal solamente se dispara cuando es el usuario quien cambia el contenido del control escribiendo directamente sobre el mismo, pero no cuando modificamos el mismo de forma externa (desde otro manejador de evento, con una acción de tipo ficha: localizar maestro, etc.).

Ventana movida

El manejador de evento será disparado cuando se mueva la ventana donde el objeto o sub-objeto asociado a la conexión de evento se encuentre contenido.

Ventana redimensionada

El manejador de evento será disparado cuando se modifique el tamaño de la ventana donde el objeto o sub-objeto asociado a la conexión de evento se encuentre contenido.

Vista activada

Esta señal es específica para el marco principal del proyecto. El manejador de evento será disparado cuando se active una vista dentro del marco.

Vista añadida

Esta señal es específica para el marco principal del proyecto. El manejador de evento será disparado cuando se añada una nueva una vista dentro del marco.

Vista cerrada

Esta señal es específica para el marco principal del proyecto. El manejador de evento será disparado cuando se cierra una nueva una vista dentro del marco, después de ser cerrada.

Nota: no todas las señales estarán disponibles para todos los objetos o subobjetos. Cuando programemos una conexión de evento las señales disponibles variarán en función del objeto o subobjeto que asociemos a la misma.

Manejador de evento

Las señales pueden ser leídas en los manejadores de eventos para ampliar información sobre su uso.

Dos consideraciones sobre las señales

1) Debemos ser conscientes de que, cuando se ejecuta un manejador de evento, no se dispararán otras señales y sus manejadores de evento, ya que podría dar lugar a recursividad o ejecuciones en cascada no deseadas.

Lo veremos más claro con un ejemplo:

Hemos programado un manejador de evento que se dispara con la señal “gana foco” asociada a un control de un formulario, y programamos otro manejador de evento que lleva el foco a dicho control con el comando interfaz: establecer foco.

Según lo dicho antes, al ejecutar el manejador de evento que establece foco en el control, no se disparará la señal de ganancia de foco, por lo tanto, si queremos que se ejecute el manejador de evento asociado a la misma, lo único que tendremos que hacer es, en el manejador de evento que establece el foco, disparar el otro manejador de evento con el comando Interfaz: ejecutar evento.

2) Si tenemos programadas varias conexiones de evento asociadas a un mismo control y con la misma señal, solamente se disparará la primera de ellas.

Por ejemplo, si hemos programado varias conexiones de evento del tipo “gana foco” sobre el mismo control, sólo se lanza la primera de ellas y no el resto.

Lo que se podría hacer es declarar una única señal del tipo “gana foco” que dispare un manejador de evento que lance todos los manejadores que se quieran ejecutar al ganar foco el control.

Lista de señales disponibles por objeto y sub-objeto

A continuación mostramos una lista de las señales que son funcionales en los distintos objetos y sub-objetos de aplicación de Velneo.

Alternador de lista

Acción disparada Item: activado Item: cambio de seleccionado Item: doble clic Item: simple clic Lista cambiada On hide Oshow Post-inicializado Pre-inicialización Timer Ventana movida Ventana redimensionada

Árbol

Acción disparada Drop finalizado Gana foco Item: activado Item: cambio de seleccionado Item: doble-click Item: simple-click Lista cambiada On hide On show Pierde foco Post-inicializado Pre-Inicialización Tecla pulsada Tecla soltada Ventana movida Ventana redimensionada

Bloc de formularios

Acción disparada Item: cambio de seleccionado Lista cambiada. On hide On show Post-inicializado Pre-Inicialización Ventana movida Ventana redimensionada

Casillero

Combo View

Acción disparada Drop finalizado Gana foco Item: activado Item: cambio de seleccionado Lista cambiada On hide On show Pierde foco Post-inicializado Pre-Inicialización Tecla pulsada Tecla soltada Timer Ventana movida Ventana redimensionada

Formulario

Acción disparada Item: cambio de seleccionado (para formularios con origen) Item: pre-cambio de seleccionado (para formularios con origen) On hide On show Post-inicialización Pre-Inicialización Timer

Controles de formulario

Barra de progreso

On hide On show Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Ventana movida Ventana redimensionada

Botón

Botón pulsado Gana foco On hide On show Pierde foco Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Tecla pulsada Tecla soltada Ventana movida Ventana redimensionada

Botón de check

Gana foco On hide On show Pierde foco Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Tecla pulsada Tecla soltada valueChanged Ventana movida Ventana redimensionada

Botón de radio

Caja de formularios

Item: cambio de seleccionado On hide On show Ventana movida Ventana redimensionada

Caja de grupo

On hide On show Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Ventana movida Ventana redimensionada

Caja de texto y caja de texto enriquecido

Gana foco On hide On show Pierde foco Tecla pulsada Tecla soltada Value changed Ventana movida Ventana redimensionada

Calendario

ComboBox

Gana foco Item: activado Item: cambio de seleccionado On hide On show Pierde foco Tecla pulsada Tecla soltada Ventana movida Ventana redimensionada

Controles SVG

Gana foco On hide On show Pierde foco Tecla pulsada Tecla soltada Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Tecla pulsada Tecla soltada valueChanged (solamente para botones SVG tipo Toggle y Slide) Ventana movida Ventana redimensionada

Data Catcher Edit

Deslizador

Dial

Dibujo

On hide On show Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Ventana movida Ventana redimensionada

Edición alfabética, hora, fecha, fecha-hora, numérica, senda fichero senda directorio y fórmula

Imagen SVG

On hide On show Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Ventana movida Ventana redimensionada

Layout, espaciador fijo, espaciador expandible y e

Ninguna

ListBox

Item: cambio de seleccionado

Manómetro

On hide On show Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Ventana movida Ventana redimensionada

Menú arbolado

On hide On show Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Ventana movida Ventana redimensionada

Nombre de campo

On hide On show Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Ventana movida Ventana redimensionada

Objeto dibujo

Gana foco On hide On show Pierde foco Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Tecla pulsada Tecla soltada Value changed Ventana movida Ventana redimensionada

Pila de formularios

Item: Cambio de seleccionado On hide On show Ventana movida Ventana redimensionada

Reloj

On hide On show Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Ventana movida Ventana redimensionada

Rueda

Separador formularios

Item: Cambio de seleccionado On hide On show Ventana movida Ventana redimensionada

Splitter

On hide On show Ventana movida Ventana redimensionada

Termómetro

On hide On show Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Ventana movida Ventana redimensionada

Texto estático

On hide On show Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Ventana movida Ventana redimensionada

Visor HTML

Contents changed Gana foco Link clicked Load finished Load progress Load started On hide On show Pierde foco Tecla pulsada Tecla soltada Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Tecla pulsada Tecla soltada Url changed Ventana movida Ventana redimensionada

Vista de datos

Las señales disponibles serán las que tenga disponibles el objeto usado.

Formulario QML

Acción disparada Gana foco On hide On show Pierde foco Post-inicializado Pre-inicialización Tecla pulsada Tecla soltada Timer Ventana movida Ventana redimensionada

Gráfico

Acción disparada.

Gana foco Item doble click (se dispara solamente cuando lo hacemos sobre una serie del gráfico). En el caso de que haya varias tartas solo hará click en la de la derecha. Item simple click (se dispara solamente cuando lo hacemos sobre una serie del gráfico). En el caso de que haya varias tartas solo hará click en la de la derecha. Lista cambiada On hide On show Pierde foco Post inicializado Pre-inicialización Ratón: botón doble-click (se dispara solamente cuando realizamos la acción en el margen blanco del gráfico y no sobre los elementos que lo componen). Ratón: botón pulsado (se dispara solamente cuando realizamos la acción en el margen blanco del gráfico y no sobre los elementos que lo componen). Tecla pulsada Tecla soltada Ventana movida Ventana redimensionada

Informe

Las señales de los informes solamente serán funcionales cuando estos generen interfaz, es decir, en su presentación preliminar. Acción disparada Lista cambiada On hide On show Post-inicializado Pre-inicialización Ventana movida Ventana redimensionada

List-View

Lista QML

Acción disparada Gana foco Item: activado Item: cambio de seleccionado Lista cambiada On hide On show Pierde foco Post-inicializado Pre-inicialización Tecla pulsada Tecla soltada Timer Ventana movida Ventana redimensionada

Marco

Desconexión del servidor On close Post-inicializado Pre-Inicialización Pre-vista cerrada Vista activada Vista añadida Vista cerrada

Multivista

Acción disparada Item: activado Item: cambio de seleccionado Item: doble click Item: simple click Lista cambiada On hide On show Post-inicializado Pre-inicialización Ventana movida Ventana redimensionada

Rejilla

Acción disparada Drop finalizado Edición aceptada Edición cancelada Edición iniciada Item: activado Item: cambio de seleccionado Item: doble-click Item: simple-click Lista cambiada Gana foco (y a nivel de columna, en columnas editables de rejillas editables). On hide On show Pierde foco Post-inicializado Pre-edición aceptada Pre-edición cancelada Pre-inicialización Tecla pulsada (Hay dos excepciones: No se disparará con las teclas Insert ni Supr. Esto es debido a que Se procesan internamente no emitiendo la señal de tecla pulsada para garantizar el correcto funcionamiento del control.) Tecla soltada Timer Ventana movida Ventana redimensionada

Columna de rejilla (solamente válido para rejillas editables)

Gana foco On hide On show Pierde foco Ratón: botón doble-click Ratón: botón pulsado Ratón: movimiento Tecla pulsada Tecla soltada Ventana movida Value changed

Rejilla avanzada

Acción disparada Gana foco Item: cambio de seleccionado Item: doble click Item: simple click Lista cambiada On hide On show Pierde foco Post-inicializado Pre-inicialización Tecla pulsada Tecla soltada Ventana movida Ventana redimensionada

ViewFlow

Acción disparada Drop finalizado Gana foco Item: cambio de seleccionado Item: activado Item: simple-click Item: doble-click Lista cambiada On hide On show Pierde foco Post-inicializado Pre-Inicialización Ratón: botón doble-click Ratón: botón pulsado Ratón: botón soltado Ratón: movimiento Tecla pulsada Tecla soltada Timer Ventana movida Ventana redimensionada

AnteriorSub-objetos de vistas de datos SiguienteDrop

Última actualización hace 5 años

¿Te fue útil?