RESTORE SCREEN*
 Muestra una pantalla previamente guardada
------------------------------------------------------------------------------
 Sintaxis

     RESTORE SCREEN [FROM <cPantalla>]

 Argumentos

     FROM <cPantalla> es una expresión de caracteres de donde recuperar
     la pantalla.

 Descripción

     RESTORE SCREEN es un mandato sinónimo de la función RESTSCREEN(), que
     vuelve a mostrar una pantalla previamente guardada. Se utiliza con SAVE
     SCREEN para evitar tener que redibujar la pantalla original creada con
     los mandatos @...SAY, @...GET y ?.

     RESTORE SCREEN actúa de dos formas, dependiendo de si se especifica o
     no la cláusula FROM. Si se especifica esta cláusula, la pantalla se
     recupera de <cPantalla>. <cPantalla> es una expresión de caracteres,
     normalmente una variable a la que SAVE SCREEN asigna una imagen de
     pantalla. Si no se especifica la cláusula FROM, la pantalla se recupera
     desde la memoria intermedia por defecto de grabación de pantallas que
     crea SAVE SCREEN cuando se especifica sin la cláusula TO.

     Las funciones SAVESCREEN() y RESTSCREEN() sustituyen a los mandatos
     SAVE SCREEN y RESTORE SCREEN.

     RESTORE SCREEN es un mandato de compatibilidad, por lo que su
     utilización no es recomendable.

     ¡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). Otros controladores pueden no
     permitir guardar y recuperar las pantallas.

 Ejemplos

      Este ejemplo muestra un pequeño panel de advertencia mediante
        SAVE y RESTORE SCREEN:

        IF AdvetFichero()
           COPY FILE Su.txt TO Mi.txt
        ELSE
           BREAK
        ENDIF
        RETURN

        FUNCTION AdvetFichero
           LOCAL lRespuesta := .F., cPantalla
           SAVE SCREEN TO cPantalla
           @ 10, 10 CLEAR TO 12, 45
           @ 10, 10 TO 12, 45 DOUBLE
           @ 11, 12 SAY "El fichero ya existe, ¿sobreescribir (y/n)?";
                 GET lRespuesta PICTURE "Y"
           READ
           RESTORE SCREEN FROM cPantalla
           RETURN lRespuesta

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: RESTORE RESTSCREEN() SAVE SAVESCREEN()