READMODAL()
 Activa el modo de edición de pantalla completa de una GetList
------------------------------------------------------------------------------
 Sintaxis

     READMODAL(<aGetList>, [<nGet>], [<oMenu>],
        [<nFilaMsj>, <nIzqMsj>, <nDerMsj>, <cColorMsj>])
        --> <lActualizado>

 Argumentos

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

     <nGet> es un valor numérico opcional que identifica al objeto Get
     de la lista <aGetList> que debe recibir inicialmente el foco de
     entrada.

     <oMenu> representa un objeto TopBarMenu opcional que, cuando se
     especifica, permite selecciones de menú durante la entrada de datos.

     <nFilaMsj>, <nIzqMsj> y <nDerMsj> especifica la fila y los
     márgenes izquierdo y derecho del área de la pantalla donde se
     visualizan los mensajes del objeto Get. Si se omite, no aparecen
     mensajes en pantalla.

     <cColorMsj> define los atributos de color del área de mensajes.
     Está formada por un par de atributos que determinan el color de primer
     término y de fondo.

 Devuelve

     Si se actualiza GetList, READMODAL() devuelve el valor verdadero (.T.);
     de lo contrario, devuelve el valor falso (.F.).

 Descripción

     READMODAL() es una función de interfaz de usuario que activa el modo de
     pantalla completa para GET. Forma parte del sistema Get de arquitectura
     abierta de CA-Clipper. 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 versiones anteriores de CA-Clipper, el sistema
     GET está implementado utilizando 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 en una llamada a READMODAL(), utilizando 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 la
     función 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 GET
     GETPOSTVALIDATE()        Evalúa la condición de salida del objeto
                              Get actual
     GETPREVALIDATE()         Evalúa la condiciónde entrada al 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 implementa un
                              fichero de formato (.fmt)
     READKILL()               Devuelve, y opcionalmente establece,
                              si debe salirse del READ actual
     READUPDATED()            Devuelve, y opcionalmente establece,
                              si un 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.

 Ficheros   La biblioteca asociada es CLIPPER.LIB,
            el fichero fuente es SOURCE\SYS\GETSYS.PRG

 To download this example - click here.

See Also: @...GET READ