Tutor de comandos de interfaz y acciones
Última actualización
¿Te fue útil?
Última actualización
¿Te fue útil?
Este tutor muestra cómo es posible interactuar, tanto desde procesos como desde eventos de interfaz de objetos, con el interfaz de la aplicación.
Podemos interactuar con las acciones, con los objetos y subobjetos incluidos en los docks del marco principal, con distintos tipos de objeto, etc. Este tutor es una muestra de cómo podemos interactuar con el interfaz de nuestras aplicaciones tanto desde como desde de interfaz. Para ello se hace uso del grupo de comandos de instrucción de proceso de .
El tutor está ha sido estructurado en función de los objetos con los que podemos interactuar. Explicaremos cómo utilizarlo en ejecución e identificando dónde podemos encontrar los distintos objeto en edición.
El formulario que vemos en pantalla es el formulario TUT_INT_ACC, que encontraremos dentro de la carpeta de objetos de este tutor en el proyecto de datos de vTutor.
En la parte superior del formulario principal se incluyen botones para acceder a las distintas opciones de pruebas.
A la derecha se muestran dos docks: un dock que contiene un formulario llamado “saludo” y otro que contiene una rejilla de clientes.
A continuación iremos explicando cada una de ellas.
Todos los eventos de interfaz disparados están incluidos en el formulario TUT_INT_ACC_ACC contenido en esa misma carpeta.
A continuación pasamos a describir cada una de las opciones disponibles.
Todos los procesos disparados desde este formulario se encuentran localizados en la siguiente carpeta de objetos del de este tutor del proyecto de aplicación de vTutor.
Los manejadores de evento de interfaz se encuentran todos asociados al formulario TUT_INT_ACC_MAR, que encontraremos también dentro de la carpeta de objetos específicos de este tutor.
A continuación pasamos a describir cada una de las opciones disponibles:
Todos los eventos son disparados desde el formulario TUT_INT_ACC_MUL, que encontraremos dentro de la carpeta de objetos específicos de este tutor.
Las opciones disponibles son:
El formulario donde se ha programado se llama TUT_INT_ACC_SEP y lo encontraremos dentro de la carpeta de los objetos específicos de este tutor.
Las opciones disponibles son:
Al ejecutar el evento el subformulario será inhabilitado y no podrá accederse a él.
El evento disparado en este caso es idéntico al anterior, con la diferencia que en el parámetro “fórmula condición” se ha establecido el valor 1.
En el formulario TUT_INT_ACC_SEP hemos declarado un evento de interfaz llamado INT_PUL_BTN_SUBFRM_01 que lo que hace es modificar una variable local del formulario con el texto siguiente:
El contenido de esta variable local es pintada en la parte inferior del formulario TUT_INT_ACC_SEP. El formulario tiene declarada una conexión de evento que se dispara con la señal botón pulsado asociada al botón incluido en el subformulario TUT_INT_ACC_SEP_SUB_1 que dispara este evento.
De este modo, cuando el usuario pulse el botón incluido en el subformulario de la primera pestaña, se disparará este evento y se mostrará el mensaje en la parte inferior del formulario TUT_INT_ACC_SEP.
Hemos programado subobjetos idénticos para atrapar la pulsación del botón incluido en el otro subformulario incluido en el separador.
El formulario de este tutor se llama TUT_INT_ACC_ACE y lo encontraremos dentro de la carpeta de objetos específicos de este tutor.
Con la señal previo a la ejecución asociada al botón Aceptar, ejecutamos el manejador de evento anterior.
Se comprueba si el pedido tiene cliente asignado, si no lo tiene, presenta un mensaje de advertencia y lleva el foco al campo CLIENTE en el formulario.
Este formulario de alta de pedido se llama desde el botón comandos de botón del tutor.
En el formulario incluido en el Dock Saludo, cuyo identificador es TUT_INT_ACC_SAL, y que encontraremos en la carpeta de objetos específicos de este tutor, el botón “¡Púlsame!” dispara el siguiente evento:
Este evento lo que hace es presentar un mensaje cuyo contenido variará en función de si el campo NAME está o no vacío. Si está vacío, llevará el foco al control de edición de dicho campo.
Nos permite interactuar con usadas en el proyecto. Podemos realizar las mismas pruebas tanto desde declarados en el proyecto como desde de interfaz declarados en este formulario. Todos los procesos disparados desde este formulario se encuentran localizados en la carpeta de objetos de este tutor en el proyecto de datos de vTutor.
En este caso todos ellos actuarán sobre la acción clientes por nombre de la que se activa cuando ejecutamos el tutor.
Habilita la acción que dispara la búsqueda de clientes. Para ello se hace uso del comando de instrucción de proceso . Si la acción estuviese deshabilitada, al pulsar este botón se habilitaría nuevamente en la toolbar.
Deshabilita la acción que dispara la búsqueda de clientes. Para ello se hace uso del comando de instrucción de proceso . Al pulsar este botón se deshabilitaría la opción correspondiente de la toolbar principal.
Ejecuta la acción que dispara la búsqueda de clientes. Para ello se hace uso del comando de instrucción de proceso .
Comprueba si está visible o no la acción que dispara la búsqueda de clientes. Para ello se hace uso del comando de instrucción .
Comprueba si está habilitada o no la acción que dispara la búsqueda de clientes. Para ello se hace uso del comando de instrucción .
Muestra la acción que dispara la búsqueda de clientes. Para ello se hace uso del comando de instrucción de proceso . Si la acción estuviese oculta, al pulsar este botón aparecería nuevamente en la toolbar.
Oculta la acción que dispara la búsqueda de clientes. Para ello se hace uso del comando de instrucción de proceso . Al pulsar este botón la acción desaparecerá de la toolbar.
Nos permitirá intentar actuar con los declarados dentro del marco principal del proyecto. Todos los procesos disparables desde este formulario interactúan con el dock llamado TUT_TES_INT_SAL.
Se trata de un proceso que mediante el comando lleva el foco al control de edición incluido en el dock "saludo".
Se trata de un proceso que mediante el comando quita el foco del control de edición incluido en el dock “saludo”.
Se trata de un proceso que mediante el comando deshabilita el botón incluido en el dock “saludo”.
Se trata de un proceso que mediante el comando habilita el botón incluido en el dock “saludo”.
Se trata de un proceso que mediante el comando deshabilita el formulario incluido en el dock “saludo”.
Se trata de un proceso que mediante el comando habilita el formulario incluido en el dock saludo.
Se trata de un proceso que mediante el comando comprueba si el dock “saludo” es o no visible.
Se trata de un proceso que mediante el comando comprueba si el formulario incluido en el dock “saludo” está o no habilitado.
Se trata de un proceso que mediante el comando oculta el dock “saludo”.
Se trata de un proceso que mediante el comando hace visible el dock “saludo”.
Se trata de un proceso que mediante el comando aplica un css al formulario incluido en el dock “saludo”.
Se trata de un proceso que mediante el comando quita el css aplicado en el proceso anterior al formulario incluido en el dock "saludo".
Además del dock "saludo" se incluye otro dock que contiene una lista de clientes. Este manejador de evento de interfaz que mediante el uso de los comandos e , muestra en la rejilla incluida en el dock de la lista de clientes los clientes que hayamos seleccionado en la rejilla incrustada en el formulario en curso.
El comando lo que hace es desmarcar los registros seleccionados en la rejilla incrustada en el formulario en curso.
Manejador de evento de interfaz que mediante el uso de los comandos e quita, en la rejilla incluida en el dock “lista de clientes”, la selección de los clientes que hayamos seleccionado en la rejilla incrustada en el formulario en curso.
El comando lo que hace es desmarcar los registros seleccionados en la rejilla incrustada en el formulario en curso.
Evento de interfaz que mediante el uso del comando , quita las selección de los registros que haya seleccionados en la rejilla incluida en el dock “lista de clientes”.
Evento de interfaz que mediante el uso del comando presenta el formulario asociado al evento de alta en la rejilla incluida en el dock llamado “lista de clientes”.
Evento de interfaz que mediante el uso del comando presenta el formulario asociado al evento de modificación en la rejilla incluida en el dock “lista de clientes”. Para que este evento sea funcional será necesario tener seleccionado un elemento en dicha rejilla.
Evento de interfaz que mediante el uso del comando presenta el formulario asociado al evento de baja en la rejilla incluida en el dock “lista de clientes”. Para que este evento sea funcional será necesario tener seleccionado un elemento en dicha rejilla.
Evento de interfaz que mediante el uso del comando , presenta la lista de los elementos seleccionados en la rejilla incluida en el dock “lista de clientes”.
Evento de interfaz proceso que mediante el comando oculta durante unos segundos el marco principal de la aplicación.
Se trata de un ejemplo que nos muestra cómo podemos interactuar con los distintos objetos contenidos en un objeto tipo . En este ejemplo, el multivista está compuesto por dos rejillas, una de Clientes y otra de Contactos de clientes.
Se trata de un evento de interfaz que mediante el comando aplica un css a la primera rejilla del multivista (Clientes).
Se trata de un evento de interfaz que mediante el comando quita el css aplicado en el proceso anterior a la primera rejilla del multivista (Clientes).
Evento de interfaz proceso que mediante el comando hace visible la segunda rejilla del multivista (Contactos).
Evento de interfaz proceso que mediante el comando oculta la segunda rejilla del multivista (Contactos).
Se trata de un evento de interfaz que mediante el comando comprueba si la rejilla de Contactos del objeto multivista está o no visible.
Se trata de un evento de interfaz que mediante el comando habilita la rejilla de contactos del multivista.
Se trata de un evento de interfaz que mediante el comando deshabilita la rejilla de contactos del multivista.
Se trata de un evento de interfaz que mediante el comando comprueba si la rejilla de contactos del objeto multivista está o no habilitada.
Se trata de un evento de interfaz que mediante el comando activa el foco de la rejilla de contactos del multivista.
Se trata de un evento de interfaz que mediante el comando quita el foco de la rejilla de contactos del multivista.
Se trata de un proceso que mediante el comando recorre los registros seleccionados en las dos rejillas del multivista y presenta un mensaje con el resultado.
Evento de interfaz que mediante el uso del comando presenta el formulario asociado al evento de alta en la rejilla de contactos del multivista.
Evento de interfaz que mediante el uso del comando presenta el formulario asociado al evento de modificación de la rejilla de contactos del multivista. Para que este evento sea funcional será necesario tener seleccionado un elemento en dicha rejilla.
Evento de interfaz que mediante el uso del comando presenta el formulario asociado al evento de baja de la rejilla de contactos del multivista. Para que este evento sea funcional será necesario tener seleccionado un elemento en dicha rejilla.
Evento de interfaz que mediante el uso del comando devuelve los registros seleccionados en la rejilla de contactos del multivista.
Evento de interfaz que mediante el uso del comando quita la selección de los registros seleccionados previamente en la rejilla de contactos del multivista.
Se trata de un ejemplo que nos muestra cómo podemos interactuar con controles incluidos dentro de subcontroles distintos de un formulario, en este caso, dentro de un . En este caso operaremos con rejillas incluidas en distintos separadores y atraparemos señales disparadas desde los formularios incluidos en los separadores.
Manejador de evento de interfaz que mediante el uso de los comandos e , muestra en la rejilla incluida en el subformulario “Rejilla 2” los registros que hayamos seleccionado en la rejilla incrustada en el subformulario “Rejilla 1”.
El comando lo que hace es desmarcar los registros seleccionados en la rejilla incrustada en el formulario en curso.
Evento de interfaz que mediante el uso de los comandos e quita, en la rejilla incluida en el separador “Rejilla 2”, la selección de los clientes que hayamos seleccionado en la rejilla incrustada en el subformulario “Rejilla 1”.
El comando lo que hace es desmarcar los registros seleccionados en la rejilla incrustada en el formulario en curso.
Evento de interfaz que mediante el uso del comando desmarca los registros que se encuentren seleccionados en la rejilla del subformulario “Rejilla 2”.
Evento de interfaz que mediante el uso del comando inhabilita el subformulario “Rejilla 2”, esto es, lo oculta detrás del otro y no deja acceder al mismo. Este comando se usa tanto para habilitar como para inhabilitar un subformulario, haciendo uso para ello de la condición que se establezca en el parámetro Fórmula condición. En dicho parámetro debemos especificar una expresión condicional. Si el resultado de su evaluación es 1, el control será habilitado, si es 0 será inhabilitado. En este ejemplo, hemos puesto como condición directamente un 0, lo que hará que el formulario sea inhabilitado.
Evento de interfaz que mediante el uso del comando comprueba si el subformulario “Rejilla 2” está o no inhabilitado. Devolverá un 1 si el subformulario está habilitado o un 0 si no lo está.
Este formulario incluye una de Clientes, que tiene asignado el mismo formulario en las propiedades formulario de alta, formulario de modificación y formulario de baja. Este formulario se llama CLT_M_TUT_INT_ACC y lo encontraremos en la carpeta de objetos específicos de este tutor.
El evento usa el comando de instrucción . Este comando lo que hace es guardar cambios en la ficha que está siendo editada pero mantiene abierto el formulario para que el usuario pueda seguir editándola.
El evento usa el comando de instrucción . Este comando lo que hace es guardar cambios en la ficha que está siendo editada y cierra el formulario.
Existe señales específicas para . En la carpeta del tutor encontraremos el formulario PED_MEM_TUT_INT_ACC. En dicho formulario creamos un manejador de evento llamado PRE_ACE para controlar que no se deje vacío el campo CLIENTE del pedido:
El uso del comando de instrucción de proceso , provoca que se cancele la pulsación del botón aceptar.
Para los mensajes hacemos uso de un objeto , esto nos permitirá que, si la aplicación la hacemos multi-idioma, podamos traducir los mensajes a idioma o idiomas que se precisen.