Vista de datos - comandos

Grupo de comandos de Interfaz que agrupan comandos que permiten interactuar con objetos de vista de datos.

Interfaz: activar teclado virtual

Comando de instrucción del grupo Interfaz específica para dispositivos móviles que activa el teclado virtual.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

No tiene.

Funcionalidad

Este comando de instrucción permite , desde un evento de interfaz de un formulario, activar el teclado virtual de un dispositivo móvil Android o iOS.

Simplemente lo activa en el caso de que se encontrase desactivado; no lo muestra.

Comentarios

En el caso de ejecutarse en otros sistemas operativos, el comando no hará nada. Este comando nos permitirá a nosotros, por programación, controlar el comportamiento del teclado virtual durante el uso del formulario.

Ejemplo

Manejador de evento de un formulario que activa el teclado virtual de un dispositivo móvil:

Interfaz: activar teclado virtual

Interfaz: añadir ficha a la multi-selección

Comando de instrucción del grupo Interfaz que añade una ficha a una selección múltiple de registros.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Identificador de control
Este parámetro desplegará la lista con todos los objetos y sub-objetos accesibles desde el origen actual. Si algún objeto contiene a su vez otros sub-objetos, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el control objeto que contenga la rejilla a la que queremos añadir la ficha:

Manejador de ficha
Manejador de la ficha a añadir a la multi-selección.

Funcionalidad

Este comando de instrucción permite , desde un evento de interfaz de un formulario añadir una ficha a la multiselección.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Para que en una rejilla se pueda realizar una selección múltiple de registros es requisito indispensable que ésta tenga activada la propiedad multiselección.

Requerimiento fundamental es que la ficha a añadir haya sido inicializada previamente dentro del mismo evento mediante el comando Crear nueva ficha en memoria, que es donde se declara el manejador solicitado en el segundo parámetro.

Ejemplo

Creamos una nueva ficha y la añadimos a la multi-selección de la rejilla LST

Crear nueva ficha en memoria ( ALTA, PERS_M@ejemplo )
    Modificar campo ( NAME, "Juan Pérez García" )
    Modificar campo ( DIRECCION, "C/ San Lucas,s/n" )
Alta de ficha ( ALTA )
    Libre
Interfaz: añadir ficha a la multi-selección ( LST, ALTA )

Interfaz: Aplicar configuración de usuario de rejilla avanzada

Comando de instrucción del grupo Interfaz que permite aplicar una configuración de una rejilla avanzada (agrupamientos, cálculos, orden de columnas, etc.) guardada previamente con el comando de instrucción de proceso interfaz: guardar configuración de usuario de rejilla avanzada.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Identificador del control
Este parámetro desplegará la lista con todos los objetos accesibles desde el origen actual. Si algún objeto o sub-objeto contiene a su vez otros sub-objetos, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el objeto o sub-objeto que se corresponda con la rejilla avanzada sobre el que se desea actuar.
Fórmula de dato
La configuración se guarda en xml, por lo tanto, en este parámetro tendremos que usar el código del xml guardado previamente con el comando de instrucción de proceso interfaz: guardar configuración de usuario de rejilla avanzada.

Funcionalidad

Este comando de instrucción permite aplicar una configuración de una rejilla avanzada (agrupamientos, cálculos, orden de columnas, etc.) guardada previamente con el comando de instrucción de proceso interfaz: guardar configuración de usuario de rejilla avanzada.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos como en procesos.

Solamente es válido para interactuar con rejillas avanzadas.

Si vamos a recuperar la configuración desde un fichero de texto en disco debemos tener en cuenta que su codificación es UTF-8.

Ejemplo

Supongamos que la configuración ha sido guardada previamente en la caché local del cliente con el comando de instrucción interfaz: guardar configuración de usuario de rejilla avanzada en un fichero llamado cfg_rej_ava_clt.xml y queremos recuperarla al cargar la rejilla. En el evento de post-inicliazdo, por ejemplo, podríamos ejecutar el código siguiente:

Rem ( Abrimos el fichero )
Fichero: Abrir ( fichero, sysCacheClientPath + "cfg_rej_ava_clt.xml", Solo lectura, OK, UTF-8 )
    If ( OK )
        Rem ( Leemos el fichero línea a línea y cada línea la vamos concatenando en una variable local )
        Set ( CONTINUAR, 1 )
        Set ( CFG, "" )
        For ( CONTADOR, 0, CONTINUAR, 1 )
            Fichero: Leer línea ( fichero, LINEA, CONTINUAR )
            If ( CONTINUAR )
                Set ( CFG, "" + CFG + LINEA )
        Interfaz: Aplicar configuración de usuario de rejilla avanzada ( VIS, CFG )
    Else
        Mensaje ( "No se ha podido cargar la configuración de la rejilla. Asegúrese de que se haya guardado previamente" )

Interfaz: cambiar vista de alternador

Comando de instrucción del grupo Interfaz que permite cambiar la vista en curso de un alternador por otra.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Identificador del control
Este parámetro desplegará la lista con todos los objetos accesibles desde el origen actual. Si algún objeto o sub-objeto contiene a su vez otros sub-objetos, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el objeto o sub-objeto que se corresponda con el alternador de lista sobre el que se desea actuar.

Identificador del objeto
Este parámetro desplegará la lista con todos los objetos de lista declarados dentro del alternador seleccionado en el parámetro anterior. Seleccionar el deseado.

Funcionalidad

Este comando de instrucción permite cambiar el objeto de salida de un objeto de tipo Alternador de lista.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos como en procesos.

Solamente es válido para interactuar con alternadores de lista.

No se puede usar este comando de instrucción de proceso en un manejador de evento del propio alternador cuya vista queremos cambiar.

Ejemplo

Disponemos de un manejador de eventos en un formulario que al ser ejecutado incrementa el valor de la variable local VISTA.

Dependiendo del valor de la variable nos muestra una de las tres vistas alternativas posibles que tenemos declaradas en el alternador LST.

Set ( VISTA, VISTA + 1 )
If ( VISTA > 3 )
    Set ( VISTA, 1 )
If ( VISTA = 1 )
    Interfaz: cambiar la vista del alternador ( LST, Rejilla PERS_M@ejemplo)
If ( VISTA = 2 )
    Interfaz: cambiar la vista del alternador ( LST, Rejilla avanzada PERS_M@ejemplo )
If ( VISTA = 3 )
    Interfaz: cambiar la vista del alternador ( LST, Informe PERS_M@ejemplo )

Interfaz: configurar textos de cálculos de rejillas avanzadas

Este comando de instrucción nos permite personalizar los textos de cada tipo de cálculo de rejillas avanzadas.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Identificador de control (opcional)
Este parámetro desplegará la lista con todos los objetos y sub-objetos accesibles desde el origen actual. Si algún objeto contiene a su vez otros sub-objetos, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el objeto tipo rejilla/árbol a procesar:

Fórmula de texto cálculo suma (opcional)
Expresión fórmula en la que compondremos el texto que queramos que tenga el tipo de cálculo "suma" de la rejilla avanzada.
Fórmula de texto cálculo mínimo (opcional)
Expresión fórmula en la que compondremos el texto que queramos que tenga el tipo de cálculo "mínimo" de la rejilla avanzada.
Fórmula de texto cálculo máximo (opcional)
Expresión fórmula en la que compondremos el texto que queramos que tenga el tipo de cálculo "máximo" de la rejilla avanzada.
Fórmula de texto cálculo número de elementos (opcional)
Expresión fórmula en la que compondremos el texto que queramos que tenga el tipo de cálculo "número de elementos" de la rejilla avanzada.
Fórmula de texto cálculo media (opcional)
Expresión fórmula en la que compondremos el texto que queramos que tenga el tipo de cálculo "media" de la rejilla avanzada.

Funcionalidad

Este comando de instrucción nos permite personalizar los textos de cada tipo de cálculo de rejillas avanzadas.

Comentarios

Si lo aplicamos en un evento del marco AUTOEXEC personalizaremos los textos de todas las rejillas avanzadas de la aplicación.

Si queremos personalizar los textos de una rejilla particular, podremos hacerlo en el evento de pre-inicializado de la misma.

Ejemplo

// Rem ( Personalizar textos de pies de rejillas avanzadas )
Interfaz: Configurar textos de cálculos de rejillas avanzadas ( , "Sum.", "Min.", "Max.", "Tot.", "Med." )

Interfaz: desactivar teclado virtual

Comando de instrucción del grupo Interfaz específica para dispositivos móviles que desactiva el teclado virtual.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

No tiene.

Funcionalidad

Este comando de instrucción permite , desde un evento de interfaz de un formulario, desactivar el teclado virtual de un dispositivo móvil Android o iOS.

Simplemente lo activa en el caso de que se encontrase desactivado; no lo muestra.

Comentarios

Ejemplo

Manejador de evento de un formulario que desactiva el teclado virtual de un dispositivo móvil:

Interfaz: desactivar teclado virtual

Interfaz: establecer animación

Comando de instrucción de proceso que nos permite establecer un efecto de animación a nuestras vistas de datos de tipo formulario, rejilla y rejilla avanzada.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Tipo de animación
Que puede tener dos valores posibles:
- Ninguna: los objetos visuales no tendrán animación.
- Fade in: los objetos visuales tendrá una animación.
Tiempo (ms)
Tiempo en milisegundos que durará la animación. El valor a introducir debe ser un valor positivo. Si establecemos el valor 0 o un valor negativo, entonces no se aplicará ninguna animación.

Funcionalidad

Este comando de instrucción de proceso nos permite establecer un efecto de animación al crear las vistas de datos de tipo formulario, rejilla y rejilla avanzada.

Comentarios

Este comando de instrucción de proceso se usará normalmente en un manejador de evento del marco principal de la aplicación ya que su uso es global a la aplicación, es decir, en cuanto se ejecuta se aplica a todos los objetos visuales de tipo formulario, rejilla y rejilla avanzada que se abran a partir de ese momento.

Los controles de formulario que tengan establecida la propiedad fondo opaco a verdadero no se animarán.

Ejemplo

Interfaz: Establecer animación ( Fade-In, 500 )

Interfaz: formulario de alta

Comando de instrucción del grupo Interfaz. Permite obtener el formulario de altas asociado a una rejilla.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Identificador de control
Este parámetro desplegará la lista con todos los objetos y sub-objetos accesibles desde el origen actual. Si algún objeto contiene a su vez otros sub-objetos, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el objeto tipo rejilla/árbol a procesar:

Identificador de la variable local booleana de retorno de ok (Opcional)
Declaración de una variable local donde retornará si se ha creado la ficha (1) o no (0) desde el formulario.

Funcionalidad

Este comando de instrucción de proceso permite lanzar el formulario.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Si el objeto de lista no tiene asociado un formulario de altas, este comando no será funcional.

Ejemplo

En la ejecución de un manejador de eventos mostramos el formulario de alta asociado a la rejilla LST.

Interfaz: formulario de alta ( LST,  )

Interfaz: formulario de baja

Comando de instrucción del grupo Interfaz. Permite obtener el formulario de bajas asociado a una rejilla.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Identificador de control
Este parámetro desplegará la lista con todos los objetos y sub-objetos accesibles desde el origen actual. Si algún objeto contiene a su vez otros sub-objetos, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el objeto tipo rejilla/árbol a procesar:

Identificador de la variable local booleana de retorno de ok (Opcional)
Declaración de una variable local que retornará si se ha borrado la ficha (1) o no (0) desde el formulario.

Funcionalidad

Este comando de instrucción de proceso permite lanzar el formulario.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Si el objeto de lista no tiene asociado un formulario de baja, este comando no será funcional.

Este comando tampoco es funcional si lo lanzamos desde una ventana modal y se intenta actuar con un objeto/subobjeto que esté por detrás de la misma.

Ejemplo

Mostramos el formulario de baja del registro en curso asociado en la rejilla LST.

Interfaz: formulario de baja ( LST,  )

Interfaz: formulario de modificación

Comando de instrucción del grupo Interfaz.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Identificador de control
Este parámetro desplegará la lista con todos los objetos y sub-objetos accesibles desde el origen actual. Si algún objeto contiene a su vez otros sub-objetos, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el objeto tipo rejilla/árbol a procesar:

Identificador de la variable local booleana de retorno de ok (Opcional)
Declaración de una variable local que retornará si se ha modificado la ficha a través del formulario (1) o no (0).

Funcionalidad

Este comando de instrucción de proceso permite lanzar el formulario.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Si el objeto de lista no tiene asociado un formulario de modificación este comando no será funcional.

Este comando tampoco es funcional si lo lanzamos desde una ventana modal y se intenta actuar con un objeto/subobjeto que esté por detrás de la misma.

Ejemplo

Mostramos el formulario de modificación del registro en curso asociado en la rejilla LST.

Interfaz: formulario de modificación( LST,  )

Interfaz: get ítem de variable local array de vista de datos

Comando de instrucción de del grupo vista de datos.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

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

Identificador de variable local del objeto
Este parámetro desplegará la lista con todas las variables locales de tipo array declaradas en el objeto incrustado en el control seleccionado en el parámetro anterior. Seleccionar la variable local deseada.
Fórmula de posición
Posición del array donde está el item. En este parámetro podrá especificar tanto una constante como una expresión fórmula. La primera posición es la número 0.
Identificación de la variable local de retorno
Aquí se declara una variable que retornará el valor leído del array.

Funcionalidad

Comando de instrucción de del grupo vista de datos.

Ejemplo

Asignamos a la variable COLOR_ACTUAL el valor de la posición 0 de la MATRIZ_COLORES de la vista de datos en curso

Interfaz: get ítem de variable local array de vista de datos ( , MATRIZ_COLORES, 0, COLOR_ACTUAL )

Interfaz: get variable local de vista de datos

Comando de instrucción de del grupo vista de datos.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

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

Identificador de variable local del objeto
Este parámetro desplegará la lista con todas las variables locales declaradas en el objeto incrustado en el control seleccionado en el parámetro anterior. Seleccionar la variable local deseada.
Identificación de la variable local de retorno
Aquí se declara una variable que retornará el valor de la variable leída.

Funcionalidad

Este comando de instrucción permite leer el valor de una variable local declarada en un objeto incrustado en un control vista de datos y guardar el valor leído en una variable local al objeto.

Ejemplo

La variable BUSCAR de la vista de datos en curso la usamos para ejecutar un proceso que ejecuta una búsqueda en tercer plano.

Interfaz: get variable local de vista de datos ( , BUSCAR, BUSCAR )
Crear manejador de objeto ( proceso, Proceso PERS_M@ejemplo )
Set variable local de objeto ( proceso, TXT_BUS, BUSCAR )
Disparar objeto ( proceso, 3º plano: servidor (síncrono),  )
    Libre

Interfaz: guardar configuración de usuario de rejilla avanzada

Comando de instrucción del grupo Interfaz que permite guardar la configuración que el usuario haya hecho de una rejilla avanzada (agrupamientos, cálculos, orden de columnas, etc.).

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Identificador del control
Este parámetro desplegará la lista con todos los objetos accesibles desde el origen actual. Si algún objeto o sub-objeto contiene a su vez otros sub-objetos, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el objeto o sub-objeto que se corresponda con la rejilla avanzada sobre el que se desea actuar.
Identificador de variable global alfabética de retorno
En este parámetro debemos especificar una variable local de tipo alfabético donde se guardará el código xml que contiene la información sobre la personalización de la rejilla. Se guardará:
- La configuración de los totales del pie de la rejilla.
- La configuración de los totales de agrupamiento.
- Los filtros de la propia rejilla avanzada.
- La opción de búsqueda de la propia rejilla avanzada.
- Agrupamientos.
- Si hay agrupamientos, los registros que estén plegados y desplegados.

Funcionalidad

Comando de instrucción del grupo Interfaz que permite guardar la configuración que el usuario haya hecho de una rejilla avanzada (agrupamientos, cálculos, orden de columnas, etc.).

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos como en procesos.

Solamente es válido para interactuar con rejillas avanzadas.

Si vamos a guardar la configuración en un fichero de texto en disco debemos generarlo con codificación UTF-8.

Ejemplo

Supongamos que queremos guardar la configuración de una rejilla avanzada en disco, en la caché local de vClient, para que el usuario pueda volver a cargarla en futuras sesiones con el comando de instrucción de proceso interfaz: aplicar configuración de usuario de rejilla avanzada

Rem ( Guardamos la configuración de la rejilla avanzada )
Interfaz: Guardar configuración de usuario de rejilla avanzada ( LST, CFG )
Libre
Rem ( Guardamos en la caché local de vClient un fichero xml con la configuración de la rejilla avanzada )
Fichero: Abrir ( fichero, sysCacheClientPath + "cfg_rej_ava_clt.xml", Lectura/escritura (Crea o limpia), OK, UTF-8)
    Fichero: Grabar línea ( fichero, CFG,  )

Interfaz: limpiar la multi-selección

Comando de instrucción del grupo Interfaz.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Identificador de control
Este parámetro desplegará la lista con todos los objetos y sub-objetos accesibles desde el origen actual. Si algún objeto contiene a su vez otros sub-objetos, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el control objeto que contenga la rejilla de la cual que se quiere quitar la selección:

Funcionalidad

Este comando de instrucción permite, desde un evento de interfaz de un formulario limpiar la multi-selección de la rejilla seleccionada.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Para que en una rejilla se pueda realizar una selección múltiple de registros es requisito indispensable que ésta tenga activada la propiedad multiselección.

Este comando lo que hace es quitar la selección de los registros, es decir, desmarcarlos; no quita los registros de la rejilla.

Ejemplo

Limpiamos la multi-selección de la rejilla LST

Interfaz: limpiar la multi-selección ( LST )

Interfaz: mostrar teclado virtual

Comando de instrucción del grupo Interfaz específica para dispositivos móviles que muestra el teclado virtual.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

No tiene.

Funcionalidad

Este comando de instrucción permite , desde un evento de interfaz de un formulario, mostrar el teclado virtual de un dispositivo móvil Android o iOS cuando el foco esté en un control de edición.

Comentarios

Por defecto no será necesario mostrarlo, salvo en Android que, la primera vez que gana foco un control, no muestra el teclado.

Ejemplo

Manejador de evento de un formulario que sitúa el foco en un control de edición y muestra el teclado virtual:

Interfaz: establecer foco ( ED_EMAIL )
Interfaz: mostrar teclado virtual

Interfaz: obtener datos de la vista

Este comando de instrucción de proceso permite obtener los datos que se ven en un objeto de lista o en un control vista de datos de lista (cabecera, detalle y pie).

Origen de la instrucción: cualquiera.

Destino del subproceso: lista de la tabla asociada al objeto de lista o al control vista de datos de lista.

Parámetros

Identificador de control
Este parámetro desplegará la lista con todos los objetos/controles de tipo lista accesibles desde el origen actual. Si algún sub-objeto contiene a su vez otros controles tipo rejilla, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el sub-objeto a procesar.
Solo los seleccionados
Expresión de tipo fórmula que devolverá si queremos obtener solo los registros seleccionados en la lista (1) o todos (0).
Identificación de la variable local alfabética de retorno: Datos
Variable local alfabética donde se retornarán los registros de la lista. La lista será guardada como un array JSON de filas y cada una será un array con los datos de cada columna.
Identificación de la variable local alfabética de retorno: Cabeceras (Opcional)
Variable local alfabética donde se retornarán los títulos de las columnas en formato array JSON.
Identificación de la variable local alfabética de retorno: Pies (Opcional)
Variable local alfabética donde se retornarán los pues de las columnas en formato array JSON.

Funcionalidad

Este comando de instrucción de proceso permite obtener los datos que se ven en un objeto de lista o en un control vista de datos de lista (cabecera, detalle y pie). La cabecera y el pie solamente estarán disponibles en objetos que dispongan de dichas secciones.

Comentarios

Es funcional en los siguientes objetos de lista:

Alternador de lista: las secciones disponibles dependerán del objeto de lista que se muestre.

Arbol visor de tablas: este objeto no tiene pies por lo que se podrán obtener únicamente la cabecera y los datos.

ComboView: este objeto no tiene ni cabeceras ni pies, por lo que solamente podremos obtener los datos.

ViewFlow: este objeto no tiene ni cabeceras ni pies, por lo que solamente podremos obtener los datos.

ListView: este objeto no tiene pies por lo que se podrán obtener únicamente la cabecera y los datos.

Multivista: las secciones disponibles dependerán del objeto de lista que se muestre.

Multivista en modo árbol: este objeto no tiene pies por lo que se podrán obtener únicamente la cabecera y los datos.

Rejilla: podremos obtener tanto cabeceras como datos y pies.

Rejilla avanzada: podremos obtener las cabeceras y los datos, pero no los pies.

Ejemplo

En un formulario tenemos incrustado un control vista de datos con una rejilla y queremos obtener cabeceras, los datos seleccionados y los totales:

Interfaz: Obtener datos de la vista ( REJILLA, 1, DATOS, CABECERAS, PIES )
	Libre

Interfaz: obtener la ficha en edición de la rejilla

Comando de instrucción del grupo de Interfaz editables. Permite acceder a la ficha que está siendo editada.

Origen de la instrucción: lista de la tabla asociada a la rejilla.

Destino del subproceso: ficha de la tabla asociada a la rejilla.

Parámetros

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

Funcionalidad

Este comando permite acceder a la ficha que está siendo editada en una rejilla editable. Genera un subproceso cuyo origen será la ficha que está siendo editada en ese momento. Dicho subproceso será disparado aunque no se haya iniciado la edición.

Comentarios

Su uso se ciñe exclusivamente al ámbito de la edición directa de registros en rejillas; por lo tanto, las señales que puedan disparar un manejador de evento que use este comando de instrucción han de ir asociadas a columnas de la rejilla y lo que nos permitirá, por tanto, lanzar eventos a la pérdida o ganancia de foco de las mismas.

Si en un manejador de evento lanzado desde la edición de una celda de una columna de una rejilla se usa el comando Set retorno proceso = NO, si la misma señal tuviese más eventos asociados, éstos no serían disparados.

Debemos tener en cuenta que en un evento disparado con las señales edición aceptada y edición cancelada, ya no hay ficha en edición, por lo que este comando no será funcional en manejadores de eventos disparados desde ambas señales. Sí podremos usar este comando de instrucción de proceso en manejadores de evento disparados desde las señales "pre-aceptada" y "pre-cancelada".

Ejemplo

En un manejador de eventos de la rejilla editable LST, cuando se ejecuta la señal Pre-Edición aceptada del registro en edición en la rejilla editable mostramos el formulario PERS_M

Interfaz: obtener la ficha en edición de la rejilla ( LST )
    Pedir formulario ( PERS_M@ejemplo,  )

Interfaz: obtener la multi-selección

Comando de instrucción del grupo Interfaz.

Origen de la instrucción: cualquiera.

Destino del subproceso: lista de la tabla asociada a la rejilla seleccionada.

Parámetros

Identificador de control
Este parámetro desplegará la lista con todos los objetos y sub-objetos accesibles desde el origen actual. Si algún objeto contiene a su vez otros sub-objetos, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el control objeto que contenga la rejilla de la cual que se quiere obtener los registros seleccionados:

Funcionalidad

Este comando de instrucción permite , desde un manejador de evento de interfaz de un formulario obtener la multi-selección de la rejilla especificada.

Genera un subproceso cuyo origen será la lista de los registros seleccionados en la rejilla. Dicho subproceso solamente se disparará si hay algún ítem seleccionado en la lista.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Para que en una rejilla se pueda realizar una selección múltiple de registros es requisito indispensable que ésta tenga activada la propiedad multiselección.

Ejemplo

Generamos un informe con los registros seleccionados de la rejilla LST.

Crear manejador de objeto ( INFORME, Informe PERS_M@ejemplo )
Interfaz: obtener la multi-selección ( LST )
    Añadir lista al objeto ( INFORME )
Disparar objeto ( INFORME, No aplicable,  )
    Libre

Interfaz: ocultar teclado virtual

Comando de instrucción del grupo Interfaz específica para dispositivos móviles que oculta el teclado virtual.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

No tiene.

Funcionalidad

Este comando de instrucción permite , desde un evento de interfaz de un formulario, ocultar el teclado virtual de un dispositivo móvil Android o iOS cuando el foco esté en un control.

Comentarios

Ejemplo

Manejador de evento de un formulario que se ejecuta al perder el foco un control y oculta el teclado virtual:

Interfaz: ocultar teclado virtual

Interfaz: procesar

Comando de instrucción del grupo Interfaz o en cualquiera de los subformularios del mismo.

También es posible usarlo desde un manejador de evento de interfaz de un objeto de lista para poder procesar la lista que contenga.

Origen de la instrucción: cualquiera.

Destino del subproceso: si el contenido del control objeto es una ficha, el origen del subproceso será esa ficha, si es una lista, será esa lista.

Parámetros

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

Fichas a procesar
En este parámetro podremos elegir entre dos valores: seleccionadas o todas. Cuando el objeto a procesar es un objeto de lista, por ejemplo rejilla, si seleccionamos el valor Todas, el origen del subproceso que este comando de instrucción genera serán todos los registros de la rejilla a procesar. Si seleccionamos el valor Seleccionadas el origen del subproceso que este comando de instrucción genera serán los registros que el usuario haya seleccionado en la misma antes de la ejecución del evento. Dicho subproceso se ejecutará siempre, tenga o no tenga registros el objeto de lista a procesar.

Funcionalidad

Este comando de instrucción permite acceder a los datos de un control de tipo objeto usado en un formulario o en cualquiera de los subformularios del mismo. En un control de tipo objeto podremos presentar una ficha o una lista de registros de una tabla; mediante este comando podremos acceder a los datos de dicho control e interactuar con ellos, ya sea para leerlos, modificarlos, borrarlos, etc.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Si se trata de una ficha, el subproceso que genera este comando tendrá su origen en la propia ficha, si es una lista, el subproceso tendrá su origen en esa lista.

Si se trata de una lista, podremos acceder directamente a la ficha que el usuario ha seleccionado en la misma si en el subproceso que genera este comando usamos el comando Leer ficha seleccionada.

Si se trata de un objeto de lista, en el propio objeto podremos programar un manejador de evento de interfaz que use este comando para tener acceso a la lista contenida en la misma.

Ejemplo

Eliminamos todos los registros de la rejilla LST.

Interfaz: procesar ( LST, Todas )
    Recorrer lista eliminando fichas
        Libre

Interfaz: quitar ficha de la multi-selección

Comando de instrucción del grupo Interfaz.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Identificador de control
Este parámetro desplegará la lista con todos los objetos y sub-objetos accesibles desde el origen actual. Si algún objeto contiene a su vez otros sub-objetos, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el control objeto que contenga la rejilla de cuya multi-selección queremos quitar la ficha:

Manejador de ficha
Manejador de la ficha cuya selección queremos quitar de la multi-selección.

Funcionalidad

Este comando de instrucción permite , desde un evento de interfaz de un formulario.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Para que en una rejilla se pueda realizar una selección múltiple de registros es requisito indispensable que ésta tenga activada la propiedad multiselección.

Ejemplo

Quitamos la ficha en edición en la rejilla de la multi-selección.

Interfaz: obtener la ficha en edición de la rejilla ( LST )
    Crear copia de ficha en memoria ( FICHA )
    Interfaz: quitar ficha de la multi-selección ( LST, FICHA )

Interfaz: recalcular

Comando de instrucción que permite forzar el recálculo de una vista de datos incrustada en un formulario o en cualquiera de los subformularios del mismo.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Identificador de control
Este parámetro desplegará la lista con todos los controles de tipo vista de datos accesibles desde el origen actual. Si algún sub-objeto contiene a su vez otros controles vista de datos, junto a su identificador aparecerá un nodo que podremos desplegar para acceder a los mismos. Seleccionar el sub-objeto a recalcular:

Funcionalidad

Este comando de instrucción permite refrescar o actualizar el contenido de un control de tipo vista de datos en un formulario o en cualquiera de los subformularios del mismo.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Solamente es válido para refrescar controles tipo vista de datos y no otro tipo de controles.

Ejemplo: si un control está alimentado de forma que muestra una lista de fichas en base a unos parámetros, y necesitamos que se refresque porque existen cambios que hacen que su contenido ya no sea el correcto, llamaremos a esta instrucción de modo que “recalculará” el contenido.

Ejemplo

Recalculamos en un manejador de eventos de un formulario la vista de datos VST que podría por ejemplo, tener como primer objeto una búsqueda y como segundo objeto una rejilla para mostrar los resultados de la búsqueda.

Interfaz: recalcular ( VST )

Interfaz: set ítem de variable local array de vista de datos

Comando de instrucción de del grupo vista de datos.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

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

Identificador de variable local del objeto
Este parámetro desplegará la lista con todas las variables locales de tipo array declaradas en el objeto incrustado en el control seleccionado en el parámetro anterior. Seleccionar la variable local deseada.
Fórmula de posición
Posición del array donde está el item a modificar. En este parámetro podrá especificar tanto una constante como una expresión fórmula. La primera posición es la número 0.
Fórmula de dato
Valor a establecer al item indicado en el parámetro posición. En este parámetro podrá especificar tanto una constante como una expresión fórmula.

Funcionalidad

Este comando de instrucción permite asignar un valor a un ítem de una variable local de tipo array declarada en un objeto incrustado en un control vista de datos.

Ejemplo

Asignamos a la posición 0 de la MATRIZ_COLORES de la vista de datos en curso el valor ‘Rojo’.

Interfaz: set ítem de variable local array de vista de datos ( , MATRIZ_COLORES, 0, "Rojo" )

Interfaz: set variable local de vista de datos

Comando de instrucción de del grupo vista de datos.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

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

Identificador de variable local del objeto
Este parámetro desplegará la lista con todas las variables locales declaradas en el objeto incrustado en el control seleccionado en el parámetro anterior. Seleccionar la variable local deseada.
Fórmula de dato
Valor a asignar a la variable. En este parámetro podrá especificar tanto una constante como una expresión fórmula.

Funcionalidad

Este comando de instrucción permite asignar un valor a una variable local declarada en un objeto incrustado en un control vista de datos.

Ejemplo

Asignamos a la variable BUSCAR del control de edición ED_BUSCAR el ‘Texto a buscar’

Interfaz: set variable local de vista de datos ( ED_BUSCAR, BUSCAR, "Texto a buscar" )

AnteriorVentana principal SiguienteSistema

Última actualización hace 4 meses

¿Te fue útil?