SAVE SCREEN*
 Guarda la pantalla actual en una memoria intermedia o en una variable
------------------------------------------------------------------------------
 Sintaxis

     SAVE SCREEN [TO <idVar>]

 Argumentos

     TO <idVar> determina la variable en la que se va a almacenar el
     contenido de la pantalla actual como un valor de tipo carácter. Si
     <idVar> no es visible o no existe, se crea una variable de memoria
     privada y se le asigna la cadena de caracteres.

 Descripción

     SAVE SCREEN, que es un sinónimo de mandato para la función
     SAVESCREEN(), guarda la pantalla desde 0,0 hasta MAXROW(), MAXCOL() en
     una memoria intermedia de pantalla por defecto o en una variable
     opcional. Si la pantalla se guarda en una variable, ésta puede ser de
     cualquier clase de almacenamiento, incluyendo variables de campo,
     locales o estáticas, o un elemento de matriz. Sin embargo, tenga en
     cuenta que no puede guardar una matriz o variable local o estática en
     ficheros .mem para guardar varias pantallas en disco.

     SAVE SCREEN se utiliza con RESTORE SCREEN para evitar la necesidad de
     volver a trazar una pantalla original que ha sido reemplazada
     provisionalmente. Puede guardar varias pantallas asignando cada una de
     ellas a variables diferentes.

     SAVE SCREEN es un mandato de compatibilidad y su uso no es
     recomendable. Puede sustituirse por la función SAVESCREEN() que guarda
     pantallas parciales o enteras.

     ¡Advertencia! SAVE SCREEN, RESTORE SCREEN, SAVESCREEN()  y
     RESTSCREEN()sólo deben utilizarse con  el controlador de pantalla por
     defecto (mapa de memoria del IBM PC). Es posible que otros
     controladores de pantalla no admitan las operaciones de almacenamiento
     y recuperación de pantallas.

 Ejemplos

      Este de código utiliza una matriz estática para guardar la
        información de pantallas almacenadas:

        STATIC aPantallas[10]
        SAVE SCREEN TO aPantallas[1]
        //
        <sentencias>...
        //
        RESTORE SCREEN FROM aPantallas[1]

      Este ejemplo guarda y recupera pantallas utilizando un
        fichero de base de datos:

     USE Pantalla INDEX Nombre NEW
        APPEND BLANK

        Pantalla->Nombre := "Pantalla001"          // Guardar el nombre
                                                   // de la pantalla
        SAVE SCREEN TO Pantalla->Imagen            // Guardar una nueva
                                                   // imagen de pantalla
        //
        <sentencias>...
        //
        SEEK "Pantalla001"                         // Localizar la pantalla
        RESTORE SCREEN FROM Pantalla->Imagen       // Recuperarla

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: MAXROW() MAXCOL() RESTSCREEN() SAVE SAVESCREEN()