Vista de datos - comandos

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

Interfaz: Añadir ficha a 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 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.

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.

Interfaz: Cambiar vista de alternador

Comando de instrucción del grupo Interfaz.

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.

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

Interfaz: Formulario de alta

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.

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.

Interfaz: Formulario de baja

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.

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.

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.

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.

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.

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.

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.

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.

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.

AVISO: 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".

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.

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.

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.

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.

Interfaz: Recalcular

Comando de instrucción del grupo Interfaz 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.

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.

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.

Última actualización