Activa el modo de edición de pantalla completa de la GetList

Sintaxis

     READMODAL() –> NIL

Argumentos

  es una matriz que contiene la lista de objetos Get que se van a editar.

Devuelve

READMODAL() devuelve siempre NIL.

Descripción

READMODAL() es una función de interfaz de usuario que activa el modo de pantalla completa para objetos GET. Forma parte del sistema Get de arquitectura abierta de DPXBASE. READMODAL() es similar al mandato READ, excepto en que toma una matriz GetList como argumento y no reinicializa la matriz cuando finaliza. Debido a esto, es posible utilizar múltiples listas de objetos Get y activarlas en cualquier momento de la ejecución de un programa, siempre que la matriz que se va a utilizar esté visible.

Por compatibilidad con las versiones anteriores de DPXBASE, el sistema GET utiliza una matriz pública llamada GetList. Cada vez que se ejecuta un mandato @…GET, éste crea un objeto Get y lo añade a la matriz GetList actualmente visible. El mandato READ estándar se preprocesa mediante una llamada a READMODAL(), que utiliza la matriz GetList como argumento. Si no se especifica la cláusula SAVE, se asigna a la variable GetList una matriz vacía cuando finaliza READMODAL().

Algunas de las funciones de Getsys.prg se han hecho públicas para que puedan utilizarse con otros sistemas Get personalizados. En la siguiente tabla se listan estas funciones.

     Funciones del Sistema Get

     ————————————————————————

     Función             Descripción

     ————————————————————————

     GETACTIVE()         Devuelve el objeto Get actualmente activo

     GETAPPLYKEY()       Aplica una tecla a un objeto Get desde una rutina de

                         lectura del Get

     GETDOSETKEY()       Procesa SET KEY durante la edición del objeto GET

     GETPOSTVALIDATE()   Evalúa la postcondición del objeto Get actual

     GETPREVALIDATE()    Evalúa la precondición del objeto Get actual

     GETREADER()         Ejecuta las acciones READ estándares para un objeto

                         Get

     READFORMAT()        Devuelve, y opcionalmente establece, el bloque de

                         código que define un fichero de formato (.fmt)

     READKILL()          Devuelve, y opcionalmente establece, si debe salirse

                         del Read actual

     READUPDATED()       Devuelve, y opcionamente establece, si un objeto Get

                         se ha modificado durante un Read

     ————————————————————————

Si desea información sobre los objetos Get y las funciones antes listadas, consulte el capítulo El Sistema Get de la guía de Programación y Utilidades.

Si desea más información sobre las teclas que pueden utilizarse por defecto con la función READMODAL(), consulte la referencia del mandato READ de este capítulo.

Ficheros:  La biblioteca asociada es DPXBASE.CH, el fichero fuente es SOURCE\SYS\GETSYS.PRG